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Visual JSharp 


Visual J# 


Microsoft Visual J# 2005 enables developers to use Java-language syntax to build applications and services on the .NET 
Framework. Visual J# integrates the Java-language syntax into the Visual Studio® integrated development environment (IDE). 
Visual J# also supports most of the functionality found in Visual J++ 6.0®, including Microsoft extensions. Visual J# is nota 
tool for developing applications intended to run on a Java Virtual Machine. Applications and services built with Visual J# will 
run only on the .NET Framework. Visual J# has been independently developed by Microsoft. It is not endorsed or approved by 
Sun Microsystems, Inc. 


Because Visual J# integrates with the Visual Studio IDE, Visual J# programmers can use Visual Studio designers to create XML 
Web services, Web Forms pages, and Windows Forms applications. 


In This Section 
Getting Started with Visual J# 


Provides a list of topic to help you begin creating Visual J# projects. 
Upgrading from Visual J++ 6.0 

Provides recommendations and procedures for upgrading Visual J++ 6.0 projects to Visual J#. 
Visual J# Migration 

Describes tools and wizards available to help you convert Java and J++ applications to Visual J#. 
Deploying Visual J# Applications 


Discusses issues specific to deployment, the process for distributing a finished application or component for installation on 
other computers, in Visual J#. 


Visual J# Tasks 
Provides a list of how-to topics that describe how to perform common programming tasks using Visual J#. 
Reference 


Reference topics on the Visual J# compiler, the Binary Converter Tool Ublmp.exe), language and library support, upgrading 
from Visual J++ 6.0 projects, Visual J# syntax for the NET Framework class library, and development-environment features. 


Visual J# Samples 
Sample source code showing how to write applications for the .NET Framework using Visual J#. 
Visual J# Walkthroughs 


Step-by-step topics that show how to create distributed Web applications, author components and controls, work with 
Windows Forms and Web Forms, and perform data-related tasks. 


Related Sections 
Visual Studio 


Links you to major starting points in the Visual Studio documentation. 
Windows Forms 

Provides links to topics about the technologies and tools for creating Windows-based applications. 
Web Forms Pages 


Provides links to topics about the technologies and tools for creating the browser-based user interface for ASP.NET 
applications. 


XML Web Services in Managed Code 
Covers the technologies for creating, distributing, and consuming XML Web services. 
Debugging in Visual Studio 


Introduces debugging in the Visual Studio environment. 


Visual J# Concepts 


Getting Started with Visual J# 


This section provides an overview of the capabilities, features, and architecture of the Visual J# development system. 


In This Section 
Visual J# Overview 


Summarizes the benefits, capabilities, and major features of Visual J#. 
What's New in Visual J# 2005 

Discusses new features in Visual J#. 
What's New in the Visual J# Language 

Discusses new features in the J# language 
Visual J# Architecture 


Shows how the Visual J# compiler, extensions, and binary converter are architected with respect to the J# Class Libraries, 
.NET Framework, and common language runtime. 


Developer Information 
Brief overview of Visual J#, its uses, and its relationship to the Java language. 
Visual J# Settings 


Describes Visual J# settings for customizing your Visual Studio IDE. 


Related Sections 
Visual J# 


Provides links to various areas of the Visual J# documentation set. 
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Visual J# Overview 


Visual J# is a tool that Java-language programmers can use to build applications and services to run on the .NET Framework. 


Visual J# targets the common language runtime (CLR) and can be used to develop .NET Framework applications, including 
XML Web services and Web applications, making full use of the .NET Framework. Visual J# applications benefit from the 
following: 


Cross-language integration. 
Enhanced security. 
Versioning and deployment support. 


Debugging and profiling services. 





Note 


You can use Visual Studio® to debug your Java-language applications, even if you do not have Visual J# installed on y 
our computer. 











The default source file extension in Visual J# is jsl. Visual J# includes the following: 


The Visual J# compiler, which compiles Java-language sources to Microsoft® intermediate language (MSIL). For more 
information, see Visual J# Compiler Options. 


A binary converter that transforms Java-language bytecode into MSIL. For more information, see 
Visual J# Binary Converter Tool. 


Independently developed class libraries designed to provide the functionality equivalent to most JDK level 1.1.4 class 
libraries and equivalent to many of the classes in the JDK 1.2 java.util package specified in College Board's Advanced 
Placement curriculum for Computer Science. For more information, see Class Library Support and Visual J# Class Library. 


Compatibility with Windows® Foundation Classes (WFC) and many of the com.ms.* packages. For more information, see 
Supported Class Libraries. 


The Visual J# compiler can only create 32-bit applications in Visual Studio 2005. When run on a 64-bit Windows 
operating system, an application compiled with Microsoft Visual J# 2005 will run under WOW64 (Windows on 
Windows64). For more information on 64-bit applications, see 64-bit Applications. 


However, Visual J#: 


Does not compile Java-language source code to Java-language bytecode, that is, .class files. 
Does not support the ability to create applications that will run on a Java Virtual Machine. 


Does not support Java Native Interface (JNI), Raw Native Interface (RNI), and Remote Method Invocation (RMI). 


Microsoft Visual J# 2005 is not used for developing applications intended to run on a Java Virtual Machine. Applications and 
services built with Visual J# will run only on the NET Framework. Visual J# has been independently developed by Microsoft. It 
is not endorsed or approved by Sun Microsystems, Inc. 


See Also 
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What's New in Visual J# 2005 


Visual J# 2005 introduces the following new features. 


New Features 


Common Language Specification Compliance Checking 
Improved support for working with multiple versions of the common language runtime side by side. 


Changes in the exception handling model to allow catch clauses catching java.lang. Throwable to catch .NET exceptions 
inherited from System.Exception. For more information, see Visual J# Exception Hierarchies. 


The Visual J# library now has the AllowPartiallyTrustedCallers attribute, which allows partially trusted code such as 
applets to run. For more information, see Security Semantics for Applications Written in Visual J#. 


Support for Java bean-style properties. For more information, see Bean-Style Properties. 


Support for casting using the CodeDOM. See 
Walkthrough: Generating and Compiling Source Code Dynamically in the Java Language for more information. 


Changes to some of the classes to support functionality equivalent to JDK 1.2 level. 


The java.util.Locale class no longer allows fallback to a default region if the region is unspecified. This change can break 
applications that rely on this fallback mechanism. An indication that code is using the fallback mechanism is an empty 
string for the country/region parameter. However, it is possible to allow this code to work by calling a new function, 
com.ms.vjsharp.text.FormatDefaults.setDefaultRegion. For more information, see 

Methods in com.ms.vjsharp.text.FormatDefaults Class. 


The java.lang wrapper classes for fundamental data types now support System.|Convertible, allowing these types to be 
used with the .NET Framework wherever System.IConvertible support is required. For more information, see 
Conversions Between .NET Framework Types and Java Wrapper Types. 


Support for inner exceptions. For more information, see Inner Exception Support in java.lang.Throwable. 


Support for documentation comments, in the comment style traditionally known as Javadoc comments for Java- 
language source code. For more information, see How to: Generate XML Documentation from Javadoc Comments. 


Java-language serializable types now automatically support .NET serialization. For more information, see 
Support for .NET Serialization. 


Support for applet development using the Supplemental U! Library (VJSSupUILib.dll). 
New Visual J# samples that demonstrate new features: 

e Bean Style Indexed Property Sample (Sets Property Value) 

e@ Bean Style Simple Property Sample (Sets Property Value) 

e By Reference Sample (Pass a Type by Reference) 

e Custom Attribute Sample (Attach a Custom Attribute to a Class) 

e Enum Type Sample (Declare a Enumeration Type) 

e@ Generics Samples (Consuming Generics) 


e Value Type Sample (Declaring a Point Type as a Value Type) 


For more information, see What's New in the Visual J# Language. 


See Also 
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What's New in the Visual J# Language 


Visual J# 2005 has the following changes in the language and compiler. 


Visual J# Language 
e Authoring Custom Attributes 
e User-Defined Enumeration Types (JJ#) 
e User-Defined Value Types 
e Definition of Methods That Take Arguments By Reference 
e The ability to consume generic types and methods in the J# language. For more information, see Generics in J#. 
e Support for the Java-language strictfp keyword. 


e Support for the #line hidden directive. The #line hidden directive hides the successive lines from the debugger. 


Visual J# Compiler 


e New compiler switches to support advanced assembly signing. For more information, see 
/delaysign (Delay the Cryptographic Key Signing), /keycontainer (Specify Cryptographic Key Container), and 
/keyfile (Specify Cryptographic Key Filename). 


e Visual J++ Compiler Options Mapped to Visual J# Compiler Options 
e The compiler now provides support for Common Language Specification Compliance Checking. 


e@ The compiler contains new diagnostic error messages for bean-style properties, custom attributes, generics, assemblies, 
and CLS-compliancy. 


See Also 
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Visual J# Architecture 


Visual J# provides the following: 


The Visual J# compiler (vjc.exe) 
The Visual J# Binary Converter Tool (JbImp.exe) 


A set of independently developed class libraries designed to provide the functionality of most JDK level 1.1.4 class 
libraries and many of the classes in the JDK 1.2 java.util package specified in College Board's Advanced Placement 
curriculum for Computer Science. 


Support for the Microsoft® extensions in Visual J++ 6.0®, including the Windows ® Foundation Classes (WFC) and 
many of the com.ms.* packages. 


The class libraries shipped with Visual J# are layered on top of the NET Framework and common language runtime, as 
shown in the following illustration. 













Java Binary 
Converter 


Java Language 
Compiler 


Java Language 
Compiler 





Most Java-language application sources developed with Visual J++ 6.0 can be compiled to a .NET managed executable by the 
Visual J# compiler. Certain applications available only in bytecode format can be statically converted to a NET managed 
executable file by the Visual J# Binary Converter Tool. New Visual J# applications can be developed to make use of the J# class 
libraries (which are Microsoft's implementation of a subset of the JDK level 1.1.4 specification.), Microsoft extensions in Visual 
J++ 6.0 (for example, WFC and com.ms.*), as well as the INET Framework class library. 
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Relationship Between Visual J# and Java 


Microsoft Visual J# 2005 is a development tool that developers who are familiar with the Java-language syntax can use to 
build applications and services on the .NET Framework. Visual J# integrates the Java-language syntax into the Visual Studio 
shell. Visual J# also supports the functionality found in Visual J++ 6.0, including Microsoft extensions. When developing Visual 
J# applications, consider the following: 


e Visual J# applications are not intended to run on a Java Virtual Machine. Applications and services built with Visual J# will 
run only on the .NET Framework. 


e The Microsoft Visual J# Redistributable Package enables you to ship your Microsoft Visual J# 2005 applications by 
providing the proper run-time libraries. The Redistributable Package will only run applications and services developed 
with Visual J#; Java-language applications written with other Java-language development tools will not run with the 
Microsoft Visual J# Redistributable Package. 


Visual J# and the Microsoft Visual J# Redistributable Package have been independently developed by Microsoft, and are not 
endorsed or approved by Sun Microsystems, Inc. 


See Also 
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Visual J# Settings 


Visual J# settings are designed to opti 


mize the user experience and to maximize the productivity of Visual J# developers. These 


settings enable you to customize and save your Visual Studio integrated development environment (IDE) settings. 


You can also port or reload your IDE settings onto other computers. For more information, see 
How to: Share Settings Between Computers. 


Windows and Views 





Command Window No 


Dynamic Help windo |No 


Feature Displayed by defau|Notes 
It? 
Class View Yes 


e Filtering is enabled. 
e Class View folders are enabled. 


e Hides Implemented Interfaces nodes on classes. 


Displays as a user option. 


Not currently available when you press F1. 











w 
e Displays all class members by default. 
Output Window Yes, when build start |Exposes GotoNextError commands through shortcut keys. 
s 
Solution Explorer Yes Synchronize selected file with open file in the Code and Text Editor is OFF b 
y default. 
Start Page Yes Is only displayed the first time you start the IDE. 





Task List (Visual Studio)|No 


It will not open because of any build command. 





Toolbox Yes 





Displays components in alphabetical order. 











In addition, the following elements have certain behaviors enabled when you select the Visual J# profile. 


Dialog Boxes 
Feature 


Quick Find, Find and Replace Window 


New Project Dialog Box 


Options Dialog Box (Visual Studio) 


Behavior 


Replaces one or more occurrences of a particular string. 


When other platforms are installed on the machine, the IDE enables the combo box that 
allows you to specify the targeted platform. 


The More Options button displays options for Source Control, Device Tools, Database T 
ools, HTML Designer, and XML Designer. 








Keyboard 








Feature Behavior 











Shortcut Keys e Standard Visual Studio Editor 
e BRIEF Emulation 


e EMACS Emulation 





Miscellaneous IDE Elements 





Feature Behavior 





Windows Forms Designer settings |The default view is the Code Editor, not the component designer view. 





Main menus, shortcut menus, toolba|Shortcut keystroke equivalents are displayed next to main menu items. 
rs, commands 


Shell appearance Has the common Visual Studio look and feel. 


Window management and layouts |Default layout of windows: 


e The Solution Explorer, Class View, and Resource View tool windows are displayed o 
n the right side, at full length. 


e@ The Output window and Property Grid are displayed by default. 
Default layout of debugger windows: 
e By default, Autos, Locals, and Watch1, are displayed at the bottom of the IDE. 


@ Call Stack, Breakpoints, Threads, Modules, and Output are displayed in a separate w 
indow or at the bottom of the IDE. 


e The Output window will not be displayed. 








See Also 

Tasks 
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How to: Specify Settings for a Team 
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How to: Use the Visual J# Starter Kit 


The Visual J# Calculator Starter Kit is a complete, self-contained application that is ready for you to load and build. The starter 
kit comes with its own documentation, including suggestions for customizing the application. 


To load and build the Visual J# Starter Kit 


1. On the File menu, click New, and then click Project. 

The New Project dialog box appears. This dialog box lists the different default application types that Visual J# can create. 
2. In the Project Types list, click Starter Kits, and then in the Templates pane click the Calculator Starter Kit. 
3. In the Name box, type the name of your new project, and click OK. 

The Calculator Starter Kit project opens. 


In Solution Explorer, click the Index.htm file in the Help folder to see an explanation of the starter kit's features, 
architecture, and instructions for building and enhancing the application. 


See Also 
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Security Recommendations (Visual J#) 


Security should be an essential consideration in all phases of application development. The following sections provide some 
suggestions for increasing the security of your applications. 


Visual J# Specific Security Recommendations 


The following is in not a complete list of potential security problems, but it highlights some common issues of which Visual J# 
developers need to be aware: 


Buffer overruns are a major security concern. Always use caution when copying data into a buffer and ensure that your 
code cannot write or read outside the buffer. Do not copy unchecked user input into a buffer, or allow unconfirmed size 
parameters to define the range of data being copied. 


Do not make decisions based on file names. File names can be expressed in many different ways, and your test for a 
particular file may be bypassed. 


Never hard-code passwords or other sensitive information into your application. 
Always validate input that is used to generate SQL queries. 
Do not display exception information. It provides attackers with valuable clues. 


Make sure that your application works while running with the fewest possible privileges. Few applications require a user 
to be logged in as an administrator. 


Do not store sensitive information in XML or other configuration files. 
Use caution when using delegates passed from outside your application. 


Run FxCop on your assemblies to ensure compliance with Microsoft .NET Framework Design Guidelines. FxCop can also 
find and warn against over 200 code defects. 


General Security Recommendations 


The following MSDN topics provide in-depth information on creating secure, reliable software: 


Microsoft Security Developer Center 

Defend Your Apps and Critical User Info with Defensive Coding Techniques 
An Overview of Security in the .NET Framework 

Defend Your Code with Top Ten Security Tips Every Developer Must Know 
Security Brief: Beware of Fully Trusted Code 

What You Should Know About a Reported Vulnerability in Microsoft ASP.NET 
Security in Windows Forms Overview 


Writing Secure Managed Controls 


See Also 
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Creating Your First J# Application 


In this section you write two "Hello World" programs, one as a Console application and another as a Windows application. 


In This Section 
Your First Console Application 


Describes how to create a simple Hello World Console application. 
Your First Windows Application 


Describes how to create a simple Hello World Windows application. 
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Your First Windows Application 


It only takes a minute to create a J# application. Follow these steps and in a matter of seconds, you will have created a program 
that opens a window and reacts to a button press. 


Procedures 


To create the Windows application 


1. 


On the File menu, point to New, and then click Project. 


2. Ensure the Windows Application template is selected, and in the Name field, type MyWindowsProject. Click OK to 
create the project. 
A Windows Form is displayed in the Windows Forms Designer. This is the user interface of your application. 
3. Open the View menu, and click Toolbox to make the list of controls visible. 
4. Drag a Label control to the middle of your form. 
5. From the Toolbox, drag a button onto the form, near the label. 
6. Double-click your button to open the Code Editor. 
Visual J# has inserted a method called button1_Click that is executed when the button is clicked. 
7. Change the method so it reads: 
private void button1_Click(object sender, EventArgs e) 
{ 
label1.set_Text("Hello, World!"); 
} 
8. Press F5 to compile and run your application. 
When you click on the button, the message "Hello, World!" is displayed. Congratulations! You've just written your first J# 
application. 
See Also 
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Your First Console Application 


You can create a Console application quickly in the IDE. Complete the following steps and in a matter of seconds, you will have 
created a program. You can also create and build applications in the command line environment. For more information, see 
Building from the Command Line (Visual J#). 


Procedures 
To build the application in the IDE environment 
1. On the File menu, point to New, and then click Project. 
2. Select the Console Application template, and in the Name field, type MyConsoleProject. 


3. Click OK to create the project. The Code Editor is displayed. 


4. Locate the method main, and insert the following line after the opening brace: 


System.out.println("Hello World!"); 
5. On the Debug menu, click Start Without Debugging or press Ctrl+F5. The Console window opens, and you see the 
phrase "Hello World!" 


6. Press any key to end the application. 


See Also 
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How Do | in Visual J# 


How Do | is your gateway to key task-based topics about Visual J# programming and application development. The essential 
categories for what you can do with Visual J# are listed in this topic. The links provide pointers to important procedure-based 
Help pages. 


Windows Applications (How Do | in Visual J#) 

ActiveX controls... Controls... Dialog boxes... Drag and drop... Drawing and graphics... more 
Development Environment (How Do | in Visual J#) 

Navigating... Editing... more 
Language (How Do | in Visual J#) 

Java and J#... J# and the NET Framework... Exceptions... Reflection... more 
Installation and Setup (How Do | in Visual J#) 

Installing... configuring... more 
Console Applications (How Do | in Visual J#) 

How tos... Compiling J# Applications... more 
Projects, Solutions and Files (How Do | in Visual J#) 

How tos... Projects and files... Project types... Solutions... more 
Deployment (How Do | in Visual J#) 

Dependencies... Windows applications... Web applications... Web services... more 
Upgrading (How Do | in Visual J#) 

Upgrading from Visual J++ 6.0... What's New... Using multiple versions side-by-side... more 
Web Applications (How Do | in Visual J#) 

Web sites... Web controls... ASP.NET... more 
Data Access (How Do | in Visual J#) 

Connecting to databases... Displaying data... Querying... Editing data... more 
Coding Tasks (How Do | in Visual J#) 

Files and I/O... COM... Resources... Serialization... more 
Security (How Do | in Visual J#) 

Best practices... Web security... Windows security... more 
XML Web Services (How Do | in Visual J#) 

Creating... Accessing... Locating... more 
Debugging (How Do | in Visual J#) 

Windows applications... Web applications... stored procedures... more 
Command Line (How Do | in Visual J#) 

Tools... Compiling... more 
Reference (How Do | in Visual J#) 

Visual J# language... Visual J# libraries... more 


See Also 
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Coding Tasks (How Do | in Visual J#) 


This page links to help on widely used Visual J# coding tasks. To view other categories of popular tasks covered in Help, see 
How Do | in Visual J#. 


In General 
Visual J# 


Provides an introduction to J# as well as links to various topics on J#. 


Files and I/O 
OpenRead 


Shows how the File(OpenRead method can be used to open an existing file for reading. 
OpenWrite 
Shows how the File;OpenWrite method can be used to open an existing file for writing. 


COM 
Design Overview: COM Component Accessing 


Describes how COM objects continue to be exposed as objects that inherit the same com.ms.* classes and interfaces as in 
Visual J++ 6.0. 


How to: Generate a COM Component in J# 

Shows you how to create a COM component and also how a client can use the component. 
How to: Access a COM Component Written in VJ++ 

Shows you how to create a reference to a COM component in your project. 
How to: Access Managed Components from COM 

Provides steps for accessing managed components from COM 


Accessing the OS 
How to: Create a Socket 


Describes how to initialize a socket with protocol and network information using the constructor parameters. 
Creating Threads and Passing Data at Start Time 

Describes how creating a new instance of a Thread object creates new managed threads. 
Synchronizing Data for Multithreading 


Explains that multiple threads can make calls to the properties and methods of a single object; therefore, it is critical that 
those calls be synchronized. 


Resources 
Using Resources in Visual J# Applications 


Explains how to store resource files (.resx), such as error messages, within your Visual J# project. 
How to: Access Resources from a .properties File 
Provides an example that demonstrates how to read and write to the traditional .properties file. 
How to: Upgrade Visual J++ 6.0 Applications That Use Resources 
Shows you how to manually convert Visual J++ 6.0 project resources into .NET Framework resources. 
Vjsresgen Sample (Convert a Visual J++ 6.0 Resource File to a NET Framework Resource (.resx) File) 
Demonstrates how a Visual J++ 6.0 resource file can be converted to a .NET Framework resource file (.resx). 


Serialization 
How to: Serialize My J# Class as Binary 


Contains examples to show you how to use binary serialization. 


How to: Enable .NET Framework Serialization on a Java Application 
Contains examples to show you how to serialize or store J# application data. 
Support for .NET Serialization 
Provides an example that creates an object that implements Serializable and uses J# class library types as fields. 
How to: Write a Custom Serializer for a J# Class Using the NET Framework 
Shows you how to use Custom Serialization to store and retrieve GPS coordinates. 
How to: Deserialize Java Serialized Objects from the .NET Framework 
Provides an example that caches application information by serializing and deseriailizing basic customer information. 
How to: Convert Java Serialized Objects (.ser) to .NET Framework Serialized Objects 


Contains examples to show you how to convert a Java serialized application to a Visual J# application with .NET Framework 
serialized objects. 


Data Access 
How to: Display Data in a Windows Forms DataGridView Control 


Explains how to present data on a Windows Form in a DataGridView control. 
How to: Bind Data to Existing Controls 

Describes binding an existing Windows Forms control to data in a data source. 
How to: Bind a Windows Forms ComboBox or ListBox Control to Data 

Describes binding a ComboBox or ListBox control. 
Walkthrough: Reading XML Data into a Dataset 


Provides steps to create a Windows application that loads XML data into a dataset. The dataset is then displayed in a 
DataGridView. Finally, an XML schema based on the contents of the XML file will be displayed in a text box. 


How to: Use JDBC in an Application 

Contains examples on how to set up a data source name and how to access data. 
Data Walkthroughs 

Lists step-by-step topics that cover common data and XML scenarios. 
ASP.NET Data Access (Visual Studio) 

Discusses building data-driven Web pages. 


Miscellaneous 
How to: Write a Class Loader 


Provides an example that shows how custom class loaders in existing Java-language applications can be modified to load 
classes from managed assemblies. 


OpenRemoteBaseKey 


Provides a code example that shows how to open a registry key on a remote computer and enumerate the values of the key. 
The remote computer must be running the remote registry service. 


Random 


Provides a code example that creates random objects with a parameterless class constructor and generates a sequence of 
random integers and doubles. 


See Also 
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Command Line (How Do | in Visual J#) 


This page links to help on widely used Visual J# command-line tasks. To view other categories of popular tasks covered in 
Help, see How Do | in Visual J#. 


In General 
Visual J# Compiler 


Describes the J# compiler. 


Tools 
Building from the Command Line (Visual J#) 


Describes building from the command line. 
Visual J# Compiler Options Listed by Category 
Describes how to use the command line compiler options. 


Compiling 
Compiling J# Applications 


Describes how to invoke the Visual J# compiler by typing the name of its executable file (vjc.exe) at the command line. 


See Also 
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Console Applications (How Do | in Visual J#) 


This page links to help on widely used Visual J# console application tasks. To view other categories of popular tasks covered in 
Help, see How Do | in Visual J#. 


How to: Validate User Input in a Console Application 
Shows you how you can use parameters to control how your program operates. 
How to: Create a Console Application Client 
Describes creating an XML Web service console client application. 
Building from the Command Line (Visual J#) 
Describes how to invoke the Visual J# compiler by typing the name of its executable file (vjc.exe) on the command line. 
Compiling J# Applications 


Describes how you can compile J# source code to either executable (.exe) or dynamic link library (dll) assemblies. Once 
compiled, the binary assemblies reside in either the bin\debug or bin\release directory depending on your compiler switch 
settings. 


See Also 
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Data Access (How Do | in Visual J#) 


This page links to help on widely used Visual J# data access tasks. To view other categories of popular tasks covered in Help, 
see How Do | in Visual J#. 


Data Access 
Provides information on how to access data using ADO.NET, transaction processing, and XML. 


Connecting to Databases 
How to: Create Connections to SQL Server Databases 


Describes how to connect your application to SQL Server using the .NET Framework data provider for SQL Server. 
How to: Create Connections to Access Databases 

Explains how to connect to an Access database using the Microsoft Jet 4.0 OLE DB Provider. 
How to: Create Connections to Oracle Databases 

Connect your application to an Oracle database using the .NET Framework Data Provider for Oracle. 
ConnectionString 

Explains how to use the System.Data.Odbc namespace to connect to an ODBC data source. 


Displaying Data 
How to: Bind Data to Existing Controls 


Describes binding an existing Windows Forms control to data in a data source. 
How to: Bind a Windows Forms ComboBox or ListBox Control to Data 
Describes binding a ComboBox or ListBox control. 


Querying 
Filling Datasets and Querying Data Overview 


Describes how to execute SQL statements or stored procedures against a data source using TableAdapters or command 
objects. 


Editing Data 
Sorting and Filtering Data Using a DataView 


Describes how the DataView provides several capabilities for sorting and filtering data in a DataTable. 
Manipulating Data in a DataTable 


Explains that after creating a DataTable in a DataSet, you can perform the same activities that you would when using a table 
in a database. You can add, view, edit, and delete data in the table; you can monitor errors and events; and you can query the 
data in the table. 


Adding Data to a Table 


Explains that after you create a DataTable and define its structure using columns and constraints, you can add new rows of 
data to the table. 


Deleting a Row from a Table 

Contains instructions for deleting records from a data table. 
Viewing Data in a Table 

Describes how you can view subsets of data depending on the search criteria you specify using DataTable. 
Manipulating Data in a DataTable 


Explains that after creating a DataTable in a DataSet, you can perform the same activities that you would when using a 
table in a database. You can add, view, edit, and delete data in the table; you can monitor errors and events; and you can 
query the data in the table. 


How to: Edit Rows in a DataTable 


Explains that in order to edit an existing row in a DataTable, you need to locate the DataRow you want to edit, and then 
assign the updated values to the desired columns. 


Stored Procedures 
Stored Procedure Sample 


Demonstrates how to call a stored procedure. 
How to: Create Stored Procedures and User-Defined Functions 
Describes how to use Server Explorer to create stored procedures. 
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Debugging (How Do | in Visual J#) 


This page links to help on widely used Visual J# debugging tasks. To view other categories of popular tasks covered in Help, 
see How Do | in Visual J#. 


Walkthrough: Debugging a Windows Form 

Describes how to debug a Windows Form, one of the most common managed applications. 
Debugging Web Applications 

Links to common debugging problems and techniques for script and Web applications. 


Windows Applications 
Walkthrough: Debugging at Design Time 


Describes how to prepare code for debugging, and how to set breakpoints. 
How to: Launch the Debugger Automatically 

Describes setting up an application to start Visual Studio when you launch the application from Windows. 
Debugging Preparation: Windows Forms Applications 

Describes setting debug configurations for Windows applications. 


Web Applications 
Debugging Preparation: Web Applications 


Describes how to debug the basic project types created by the Web Site project templates. 
Debugging Preparation: ASP.NET Web Applications 

Describes setting debug configurations for Web applications. 
Debugging Preparation: XML Web Service Projects 

Describes setting debug configurations for XML Web Service applications. 


Stored Procedures 
How to: Create Stored Procedures and User-Defined Functions 


Describes how stored procedures can define complex business rules, control data modification, limit access through security 
permissions, provide transaction integrity, and generally do the database work your application requires. 


How to: Modify Stored Procedures and User-Defined Functions 


Describes how to use the Query Builder with stored procedures and user-defined functions to modify blocks of SQL text or 
selected text, and also to insert new SQL text. 
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Deployment (How Do | in Visual J#) 


This page links to help on widely used Visual J# deployment tasks. To view other categories of popular tasks covered in Help, 
see How Do | in Visual J#. 


In General 
Visual J# Application Deployment 


Describes what you need to have installed on the server where you will deploy an XML Web service or Web Forms 
application. 


Dependencies 
Redistributing the .NET Framework 


Explains that the applications and controls written for the INET Framework require the NET Framework to be installed on the 
computer where the application or control runs. 


Distribution of the Visual J# Redistributable Package 


Explains that the applications and controls written in Visual J# require the Visual J# Redistributable Package to be installed 
on the computer where the application or control runs. 


Windows Applications 
Walkthrough: Deploying a Windows-based Application 


Provides tasks to learn about deploying a Windows application. 


Web Applications 
Walkthrough: Deploying an ASP.NET Web Application Using XCOPY 


Describes the steps necessary to deploy an ASP.NET Web application. 
How to: Deploy J# Browser Controls 


Contains an example that shows you how to create a simple control, deploy the control to a Web site, and display it on a Web 
page. 


Choosing Deployment Method 
Web Site Deployment in Visual Web Developer 


Describes options for copying a Web site from a development computer to a staging or production Web server. 
Deployment Walkthrough List 

Contains a list of topics that provide step-by-step examples of common deployment scenarios. 
Deploying Multiple Versions of an Application or Component 

Contains descriptions of the types of deployments available. 


Web Services 
Deploying XML Web Services 


Explains that deploying a Web service involves copying the .asmx file and any assemblies used by the Web service, but not 
part of the Microsoft NET Framework, to the Web server. 


XML Web Service Discovery 
Describes how a published .disco file enables programmatic discovery of an XML Web service. 


Components 
How to: Create or Add a Merge Module Project 


Describes both creating and adding a merge module to your project. 
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Development Environment (How Do | in Visual J#) 


This page links to help on widely used Visual J# development environment tasks. To view other categories of popular tasks 
covered in Help, see How Do | in Visual J# 


In General 
Getting Started with Visual J# 


Provides an overview of the capabilities, features, and architecture of the Visual J# development system. 


Navigating 
Window Management 


Describes Visual Studio's numerous tools and options that help you manage windows in the integrated development 
environment (IDE). 


Integrated Development Environment for Visual Studio 
Contains links to show you how to use Visual Studio in the development process. 


Editing 
How to: Outline and Hide Code 


Describes how you can use the Stop Outlining command to remove outline information without disturbing your underlying 
code. 


General, Environment, Options Dialog Box 
Describes how to turn off autocomplete in the Options dialog box. 
Modifying Intellisense Options 


Describes how to turn off an Intellisense option by default and invoke it through a menu command or keystroke 
combination. 


Editor Convenience Commands and Features 


Describes how a wavy underline is displayed while you type code (or open a file), indicating a syntax error. They disappear 
immediately after the error is fixed. 


How to: Work with Class View 
Describes using Class View to browse a class definition. 
How to: Create Custom Comment Tokens 


Describes how comments in code begin with the comment mark preferred by your development language. If you insert a 
token string (TODO, UNDONE, HACK, or a custom token string) after the comment mark, a shortcut to the comment will be 
displayed in the Task List. 


How to: Generate XML Documentation from Javadoc Comments 


Explains how to convert the comments in a file or project from the Java-language comment style to the .NET Framework 
standard comment style. 
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Installation and Setup (How Do | in Visual J#) 


This page links to help on widely used Visual J# installation and setup tasks. To view other categories of popular tasks covered 
in Help, see How Do | in Visual J#. 


Installing 
User Permissions and Advanced Setup Options 


Describes installing Visual J#. 
Product Support and Accessibility 

Describes repairing the Visual J# installation. 
How to: Install Help for Visual Studio 

Provides information and tips about setting up and configuring Help in Visual Studio. 
User Permissions and Advanced Setup Options 

Contains information about installing another Visual Studio product side-by-side with your current installation. 
User Permissions and Advanced Setup Options 

Describes how to get help on installation. 
Product Support and Accessibility 

Describes how to troubleshoot an installation failure. 
User Permissions and Advanced Setup Options 

Provides the options you can choose from for your installation. 
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Language (How Do! in Visual J#) 


This page links to help on widely used J# Language tasks. To view other categories of popular tasks covered in Help, see 
How Do | in Visual J#. 


Getting Started with Visual J# 
Contains information that helps you get started with J#. 


Java and J# 
How to: Use the Try/Catch Block to Catch Exceptions 


Contains a code example that uses a try-catch block to catch a possible exception. 
How to: Create Enumerated Constants 


Explains how to create your own data types using the enum keyword. These data types enable you to declare a set of names 
or other literal values that define all of the possible values that can be assigned to a variable. 


How to: Write a Package Scoped Class 


Explains how to group related classes within an application using the package statement. Classes with the same package 
name are called package-scoped. Once scoped, the class members in the same package are available to each other. 
Additionally, callers of the class access the entire scope with a simple import statement. 


How to: Convert Java-Language Bytecode to MSIL Code 


Shows you how you can quickly convert many legacy Java applications to Visual J#. The Visual J# Binary Converter Tool 
(JbImp.exe) converts certain Java-language bytecode (.class) files to Microsoft intermediate language (MSIL). 


Supplemental UI Library 
Shows you how to develop any kind of application, including applets, with a Microsoft Windows look and feel. 


J# and .NET 
How to: Implement an Interface in J# 


Shows you how to declare methods with the same signature as the interface and then implement them. 
Attaching Attributes 
Explains how to use Visual J# to attach attributes to classes, fields, methods, parameters, and other programming elements. 
Calling Methods That Take Arguments By Reference 
Explains how you can call a method and pass its parameters by reference. 
Defining and Using Properties 
Explains how to use Visual J# to access properties defined in INET Framework classes. 
Definition and Use of Events 
Explains how to register for events published by .NET Framework classes. 
Using Enumerations 


Explains how you can use enumerations defined in the NET Framework or other user-defined assemblies with the J# 
compiler. 


Common Language Specification Compliance Checking 


Shows you how to verify that your code is compliant with the CLS. Compliance with the CLS means avoiding language 
constructs that are not shared by all languages. Lack of compliance with the CLS means that a type is not guaranteed to be 
usable from all languages. 


Exceptions 
Exception Handling Fundamentals 


Contains a list that contains suggestions on best practices for handling exceptions. 


Handling and Throwing Exceptions 


Contains an overview on exception handling using the .NET Framework and Visual Studio, including best practices. 
How to: Use the Try/Catch Block to Catch Exceptions 

Contains a code example that uses a try-catch block to catch a possible exception 
How to: Use Specific Exceptions in a Catch Block 

Explains how to put catch blocks targeted to specific exceptions before a general exception catch block. 


Reflection 
Reflection Overview 


Provides conceptual information about reflection and links for using it. 


Accessing Native Functions 
Calling Native Methods 


Shows how to call a native code functions by using the platform invocation services provided by the common language 
runtime. 


How to: Call a Method in a DLL from Visual J# 
Includes an example that shows you how to call both static and dynamic methods from the vjslib.dll library. 
PInvoke Sample (Call Unmanaged APIs) 


Demonstrates how Visual J# can use the platform invoke services provided by the common language runtime to call 
unmanaged APIs. 


Standards and Conventions 
How to: Compile a Java-language Application in Visual J# 


Shows you how to create your own project, add your existing java files, and compile them with J#. 
Common Language Specification Compliance Checking 
Shows you how to check types for compliance with the Common Language Specification (CLS). 
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Projects, Solutions and Files (How Do | in Visual J#) 


This page links to help on widely used J# projects tasks. To view other categories of popular tasks covered in Help, see 
How Do | in Visual J#. 


How to: Create or Add a Setup Project 


Explains how to create two types of setup projects. Standard setup projects create installers that install Windows applications 
on a target computer; Web setup projects create installers that install Web applications on a Web server. 


How to: Specify Assembly Information 


Explains how to enter the Assembly information in the Assembly Information dialog box, accessible from the Application 
pane of the Project Designer. 


How to: Identify How a Project Manages Files 
Describes the location of project files and how you can manage them. 
How to: Set Build Properties (C#, J#) 


Explains how you can specify build settings and events by using the Build Pane and the Build Events Pane of the Visual 
Studio Project Designer. 


How to: Create Multi-Project Solutions 


Explains how to share numerous and related source-controlled projects by creating them under a common solution 
directory. 


Projects and Files 
How to: Add Files to a Project 


Shows you how to add existing files to a project using the Application Builder or Project Manager. 
How to: Rename a File or Project 

Explains how to rename elements of the project. 
How to: Manage Files with Encoding 


Explains how to manage files with encoding. To help display your code in a particular language and on a particular platform, 
you can associate a particular character encoding with a file. 


How to: Remove Files from Projects 

Shows how you remove files from your project or delete them using the Project Manager. 
How to: Create a Project from Existing Code Files 

Shows you how you can use existing code files in a new project in the Visual Studio integrated development environment. 
Adding Project and Project Item Templates 

Describes how a project type can be designed to open files belonging to that project with a project-specific editor. 


Project Types 
How to: Create a Console Application Client 


Describes creating an XML Web service console client application 
How to: Create a New Swing Application 
Demonstrates many of the Swing features and how they can interoperate with the AWT library. 
How to: Create a Component that Runs in the Browser 
Shows you how to create a library component, add it to a Web page, and deploy the component on a Web site. 


Solutions 
How to: Create Multi-Project Solutions 


Explains how to add either a new project or an existing project to a solution. 


References 
How to: Add and Remove Web References 


Shows you how to add or remove a Web reference, including a code example. 
Add Reference Dialog Box 

Describes the Adding and Removing References dialog box. 
Troubleshooting Broken References 

Describes strategies for correcting the error that occurs if your application attempts to use a broken reference. 
Web References 


Describes how you manage project Web references by renaming or modifying them to suit your needs or by updating them 
when changes have been made to the Web service the reference calls. 


How to: Add or Remove References in Visual Studio 
Explains how to add a reference to a component in your application before using it. 
How to: Reference a COM Object 
Describes how to reference a COM object by using the Add or Remove Reference dialog box. 


Building and Compiling 
How to: Set Start Options for Application Debugging 


Explains how to specify additional actions to be taken when the project goes into run mode. 
Building in Visual Studio 


Shows you how you can edit the default solution and project configurations as needed, and create new configurations by 
saving modified copies of the default ones. 


How to: Set Project Properties (C#, J#) 
A project's properties specify how a project is built and debugged. 


Testing 
How to: Create and Display an Instance of an Object 


Explains how to create an instance of an object from Class Designer or Class View. 
How to: Display an Instance of a Returned Object 

Explains how to display an instance of a returned object as a shape in the Object Test Bench. 
How to: Inspect and Modify an Object Instance 

Explains how to use the Object Test Bench for a visual representation of an object. 
How to: Call a Method from Object Test Bench 

Explains how to call a method from an object shape displayed in the Object Test Bench 


Resources 
Walkthrough: Localizing Windows Forms 


Shows how to use the Visual Studio support for localizing Windows Forms applications. 
Resources in Applications 


Explains how to sort your data in a resource file which allows you to change the data without recompiling your entire 
application. 


Working with Resource Files 
Explains how you can add new resources to your project and modify those resources using the appropriate resource editor. 
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Reference (How Do | in Visual J#) 


This page links to help on widely used J# programming tasks. To view other categories of popular tasks covered in Help, see 
How Do | in Visual J#. 


Visual J# Reference 
Links you to reference information on various aspects of Visual J# programming. 


Visual J# Language 
Syntax for Targeting the .NET Framework 


Describes features in the Visual J# compiler that are used to target the .NET Framework. 


Visual J# Libraries 
Class Library Support 


Lists the supported and unsupported packages in Visual J#, as well as implementation-specific details for the class library 
support. 
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Security (How Do | in Visual J#) 


This page links to help on widely used J# security tasks. To view other categories of popular tasks covered in Help, see 
How Do | in Visual J#. 


Code Security and Signing in Components 


Explains how to ensure that your code will run wherever it is deployed and how to protect your component against 
unauthorized or malicious use. 


ProtectedMemory.Protect Method 
Contains an example to show you how to use data protection. 
Visual J# Binary Converter Tool (for Java-Language Bytecode to MSIL Conversions) 


Explains the Visual J# Binary Converter Tool (Jblmp.exe) that converts certain Java-language bytecode (.class) files to 
Microsoft® intermediate language (MSIL). 


Best Practices 
Securing Applications 


Discusses the challenges in securing applications. 


Windows Security 
Windows Forms Security 


Explains the Windows Forms security model that is code-based (security levels are set for code, regardless of the user 
running the code). This is in addition to any security schemas that may be in place already on your computer system. 


Secure Printing In Windows Forms 
Shows the functionality available at different printing permission levels. 
More Secure File and Data Access in Windows Forms 
Discusses working with file, database and registry access from applications running in a semi-trusted environment. 


Web Security 
Securing XML Web Services Created Using ASP.NET 


Explains how to use ASP.NET operates in conjunction with Internet Information Services (IIS) to provide several 
authentication and authorization options. 


Web Application Security at Run Time 


Explains how you can protect your application from unauthorized access by taking advantage of the features described in 
this topic. 
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Upgrading (How Do | in Visual J#) 


This page links to help on widely used J# upgrading tasks. To view other categories of popular tasks covered in Help, see 
How Do | in Visual J#. 


Introduction to Visual J# for Visual J++ Users 
Discusses how Visual J# adds support for the Java language on the .NET Framework 


Upgrading from Visual J++ 6.0 
How to: Upgrade Visual J++ 6.0 Applications That Use Resources 


Explains how to convert the resource files to a format supported by the .NET Framework before you can embed or link an 
existing Visual J++ resource to managed assemblies to use on the common language runtime. 


How to: Convert a Visual J++ Project 

Shows you how to open and convert your own Visual J++ project. 
How to: Create a Visual J# Project from Existing J++ Code 

Contains an example that shows you how to upgrade a Visual J++ project to Visual J#. 
Visual J# Upgrade Report 


Contains information about the upgrade process and a list of issues that need to be addressed before your project can be 
run. 


How to: Upgrade a J++/ActivexX Application 
Explains how the Visual Studio Conversion Wizard converts your J++ ActiveX projects to Visual J#. 
Upgrading Visual J++ 6.0 Applications That Access COM Components 


Demonstrates how you can compile and run a Visual J+ + 6.0 Java-language/COM application that accesses COM 
components in Visual J#. 


What's New 
What's New in Visual J# 2005 


Lists the new features in this release of Visual J#. 


Using Multiple Versions Side by Side 
How to: Set Versioning for the Visual J# Redistributable 


Explains how you can set the version, as well as other information, from within your Visual Studio project. 
How to: Use an Application Configuration File to Target a .NET Framework Version 


Explains how to use an application configuration file to specify which versions of the INET Framework an application or 
component supports. 
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Web Applications (How Do | in Visual J#) 


This page links to help on widely used Web application tasks. To view other categories of popular tasks covered in Help, 
How Do | in Visual J#. 


Web Sites 
Getting Started - Creating Web Sites 


Provides an overview of creating different types of Web sites, working with Web servers and Visual Web Developer, and 
testing Web sites. 


Learning More - Creating Web Sites 

Provides more in-depth information about working with ASP.NET Web sites. 
Walkthrough Topics — ASP.NET Web Sites 

Provides links to tutorials on creating ASP.NET Web sites in Visual Web Developer. 


Web Controls 
ASP.NET Web Server Controls 


Contains links to topics that describe what ASP.NET Web server controls are and how to work with them. 
Working with ASP.NET Web Server Controls 


Contains links to topics that contain the information about how to add Web server controls to your ASP.NET Web pages, how 
to change their appearance, and how to program the controls. 


Individual ASP.NET Web Server Controls 
Contains links to topics that provide information about each Web server control. 
ASP.NET User Controls 


Contains links to topics that provide information on how user controls work, how to create them, and how to add them to 
ASP.NET Web pages. 


Web Pages 
Walkthrough: Creating a Basic Web Page in Visual Web Developer 


Guides you through creating a simple page by using Visual Web Developer, illustrating the basic techniques of creating a 
new page, adding controls, and writing code. 


Walkthrough: Creating a Basic Web Page with Code Separation in Visual Web Developer 
Illustrates how to use Visual Web Developer to create an ASP.NET page with code separation. 
Walkthrough: Code Editing in Web Pages in Visual Web Developer 
Illustrates how to correct errors, refactor code, rename symbols and insert code snippets. 


Data Access 
ASP.NET Data Access Overview 


Provides information on data source controls and data-bound controls. 
How to: Secure Connection Strings When Using Data Source Controls 


Describes how to store connection strings in the connectionStrings configuration section in the Web.config file, and how to 
use the command-line .NET Framework tool to encrypt connection strings for additional security. 


How to: Bind to Data in a Templated Control 
Provides information on how to bind a control to data using templates. 


Security 
ASP.NET Web Application Security 


Provides information on the security infrastructure in ASP.NET, and on ASP.NET features for authentication, authorization, 
and process impersonation. 


Managing Users by Using Membership 


Provides information on ASP.NET membership that enables you to validate and manage user information for your web 
application. 


Managing Authorization Using Roles 


Helps you to manage authorization, allowing you to specify which resources various users in your application are allowed to 
access. 


Encrypting Configuration Information Using Protected Configuration 
Provides information and links to topics on encrypting configuration information using protected configuration. 


Deployment 
How to: Configure Published Web Sites 


Provides a procedure to configure a published Web site. 
Walkthrough: Deploying an ASP.NET Web Application Using XCOPY 

Provides a procedure to deploy or update individual files in an ASP.NET Web application from the command line. 
How to: Manage Security Lockdown Console Items 

Provides a procedure to manage items in the security lockdown console. 
How to: Configure ASP.NET Applications for an ASP.NET Version 

Describes the process to configure an ASP.NET application to target a specific version of the .NET Framework. 
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Windows Applications (How Do | in Visual J#) 


This page links to help on widely used Visual J# Windows application tasks. To view other categories of popular tasks covered 
in Help, see How Do | in Visual J#. 


In General 
How to: Use AWT Frames 


Demonstrates how to create your own Microsoft® Notepad-style editor application using AWT. 
WFCUsingWinForm Sample (Extend WFC Application Built in Visual J++ 6.0 Using Windows Forms) 


Demonstrates how a WFC application built in Visual J+ + 6.0 can be extended using Windows Forms. A simple WFC 
application built in Visual J++ 6.0 is upgraded to Visual J#. 


ActiveX Controls 
How to: Add ActiveX Controls to Windows Forms 


Shows how to put ActiveX controls on Windows Forms. 


Controls 
Button Control Overview (Windows Forms) 


Describes binding an event handler to a button control. 
How to: Add Buttons to a ToolBar Control 
Describes how to add buttons at design time and programmatically. 
How to: Designate a Windows Forms Button as the Accept Button Using the Designer 
Describes how to designate a button control to be the accept button, also known as the default button. 
How to: Designate a Windows Forms Button as the Cancel Button Using the Designer 
Describes how to designate a button control to be the cancel button. 
How to: Define an Icon for a ToolBar Button 
Describes designating an icon for a button at design time and programmatically. 
TextBox.Wrap Property 
Demonstrates how to get or set a value indicating whether the text content wraps within a multiline text box. 
How to: Determine When Formatting Attributes Change in the Windows Forms RichTextBox Control 
Describes how to respond to changes in formatting attributes. 
How to: Display Scroll Bars in the Windows Forms RichTextBox Control 
Describes the seven possible values for the Scrollbars property of the RichTextBox control. 
How to: Display Web-Style Links with the Windows Forms RichTextBox Control 
Describes how link to a Web page with the RichTextBox control. 
How to: Load Files into the Windows Forms RichTextBox Control 
Call the LoadFile method to display a plain-text, Unicode plain-text, or Rich-Text-Format (RTF) file. 
How to: Save Files with the Windows Forms RichTextBox Control 
To save a file, call the SaveFile method. 
How to: Set Font Attributes for the Windows Forms RichTextBox Control 
Describes using SelectionFont and SelectionColor. 
How to: Set Indents, Hanging Indents, and Bulleted Paragraphs with the Windows Forms RichTextBox Control 


Describes using the properties that indent paragraphs and format paragraphs as bulleted lists. 


How to: Respond to Windows Forms CheckBox Clicks 

Describes programming an application to perform some action depending upon the state of the check box. 
How to: Set Options with Windows Forms CheckBox Controls 

Describes how to use the CheckBox control to give users True/False or Yes/No options. 
How to: Access Specific Items in a Windows Forms ComboBox, ListBox, or CheckedListBox Control 


Describes how to access specific items in a Windows Forms combo bo, list box, or checked list box to programmatically 
determine what is in a list, at any given position. 


How to: Add and Remove Items from a Windows Forms ComboBox, ListBox, or CheckedListBox Control 
Demonstrates the simplest method of binding items to the controls, assuming no data binding. 
How to: Create a Lookup Table for a Windows Forms ComboBox, ListBox, or CheckedListBox Control 
Describes creating binding a lookup table to a control. 
How to: Bind a Windows Forms ComboBox or ListBox Control to Data 
Describes binding data to a control. 
How to: Sort the Contents of a Windows Forms ComboBox, ListBox, or CheckedListBox Control 
Describes how to display sorted data using a data source that supports sorting and then having the data source sort it. 
How to: Change the Windows Forms MonthCalendar Control's Appearance 
Describes customizing the appearance of the Windows Forms MonthCalendar control. 
How to: Display More than One Month in the Windows Forms MonthCalendar Control 
Describes displaying and arranging more than one month in the control. 
How to: Display Specific Days in Bold with the Windows Forms MonthCalendar Control 
Describes using the three properties that control the appearance of individual dates. 
How to: Select a Range of Dates in the Windows Forms MonthCalendar Control 
Describes selecting a range of dates in the month calendar control. 
How to: Modify the Size or Placement of a Picture at Run Time (Windows Forms) 
Describes how to set the SizeMode property on the Windows Forms PictureBox control to align or stretch the picture. 
How to: Load a Picture Using the Designer (Windows Forms) 
Describes loading and displaying a picture on a form at design time by setting the Image property to a valid picture. 
How to: Set Pictures at Run Time (Windows Forms) 
Describes how to programmatically set the image displayed by a Windows Forms PictureBox control. 
How to: Add a Control to a Tab Page 
Contains the steps for adding a tab control programmatically. 
How to: Add and Remove Tabs with the Windows Forms TabControl 
Adding and removing tabs from the Windows Forms TabControl can be done in the designer or with code. 
How to: Group Windows Forms RadioButton Controls to Function as a Set 
Describes grouping RadioButton controls as a set to function independently of other sets. 
How to: Give Your Control a Transparent Background 


Explains that by default, controls do not support transparent backcolors; however, you can allow your control to have a 
background color that is opaque, transparent, or partially transparent by using the Control.SetStyle method in the 
constructor. 


How to: Add to or Remove from a Collection of Controls at Run Time 


Describes how a common task in application development is adding and removing controls to any container control on your 


forms. 
Walkthrough: Authoring a User Control with Visual J# 


Shows how to create a simple user control and then how to extend the functionality of this control through inheritance. 


Dialog Boxes 
How to: Display Dialog Boxes for Windows Forms 


Display a dialog box in the same way you display any other form in an application. 
How to: Close Dialog Boxes and Retain User Input 


Explains how to set the DialogResult property for all of the Button controls on a dialog box at design time. Setting the 
DialogResult property at run time allows you to dynamically handle user responses. 


How to: Create Dialog Boxes at Design Time 


Describes creating a dialog box at design time. 


Drag and Drop 
How to: Enable Drag-and-Drop Operations with the Windows Forms RichTextBox Control 


Describes how to perform drag operations by handling the DragEnter and DragDrop events. 


Drawing and Graphics 
Width 


Describes how to get and set the width of a pen. 
How to: Load a Picture Using the Designer (Windows Forms) 

Describes how to load and display a picture on a form at design time by setting the Image property to a valid picture. 
Lines, Curves, and Shapes 


Explains how to draw lines and shapes, including curves. 


Event Handling 


How to: Create Event Handlers at Run Time for Windows Forms 


Explains that creating an event handler at run time enables you to connect event handlers based on conditions in code at run 
time as opposed to having them connected when the program initially starts. 


Forms 
How to: Set the Screen Location of Windows Forms 


Describes how to specify where a form is to be displayed on the computer screen by entering values in the Location 
property. 


How to: Create Nonrectangular Windows Forms 
Learn to create forms in non-standard shapes. 
How to: Keep a Windows Form on Top 
Learn how to make a window stay on top of any other windows on the screen. 
Title 
Describes how to set or return the title of the specified form. 
Windows Forms Data Binding 


Explains that data binding in Windows Forms gives you the means to display and make changes to information from a data 
source in controls on the form. You can bind to both traditional data sources as well as almost any structure that contains 
data. 


System.Drawing.Imaging 
Describes how System.Drawing.Imaging provides advanced tools for image rendering. 


How to: Specify an Application Icon 


Describes how to bind an icon to an application. 


Localization 
How to: Support Localization on Windows Forms Using AutoSize and the TableLayoutPanel Control 


Describes enabling a layout that adapts to varying string lengths. 
Deployment and Localization 


Discusses planning for localization. 


Menus and Context Menus 
How to: Create Context Menus 


Explains how to create the ContextMenu component that gives users access to frequently used menu commands. 
How to: Add and Remove Menu Items with the Windows Forms ContextMenu Component 
Explains how to add and remove shortcut menu items in Windows Forms. 
Walkthrough: Creating Shortcut Menus for Bookmarks 
Demonstrates the creation of shortcut menus for Bookmark controls. 
Printing 
How to: Display the PrintDialog Component 


Describes displaying the PrintDialog component. 


See Also 
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XML Web Services (How Do | in Visual J#) 


This page links to help on widely used J# XML Web services tasks. To view other categories of popular tasks covered in Help, 
see How Do | in Visual J#. 


Walkthrough: Creating a Distributed Application 


Explains how to create a multitiered, distributed application. The application will consist of three logical tiers: data, business 
object, and user interface. 


Acronym-WebService Sample (Create and Consume an XML Web Service) 
Demonstrates how to create and consume a Web service. 
Securing XML Web Services Created Using ASP.NET 


Describes how ASP.NET operates in conjunction with Internet Information Services (IIS) to provide several authentication and 
authorization options. 


Creating 
XML Web Services Walkthroughs (Visual J#) 


Describes the process for writing a simple XML Web service using Visual J#. 


Accessing 
Walkthrough: Accessing an XML Web Service with a Visual J# Web Forms Client 


Explains how to create and access an XML Web service. 


Locating 
Web Services Discovery Tool (Disco.exe) 


Use the DISCO tool to find a Web service. 


Visual J# Concepts 


Using the Visual J# IDE 


The Visual J# is a lightweight set of tools for hobbyists, enthusiasts, and students who want to build dynamic Windows 
applications and Web sites. 


In This Section 
New Project Dialog Box (Visual J#) 


Provides steps for setting up a project. 
Visual J# Project Settings 

Provides steps for modifying projects. 
How to: Navigate and Search in Visual J# 

Provides steps for searching for objects and methods. 
How to: Insert Code Snippets (Visual J#) 

Provides steps for inserting pre-defined code blocks to simplify coding. 
How to: Enter Code in Visual J# 

Provides steps for adding J# code to your application. 
How to: Create a Visual J# Console Application 

Provides steps for building applications that run from a terminal window. 
How to: Create a Visual J# Windows Application 

Provides a step-by-step guide to building a web browser application using Windows Forms. 
Related Sections 
Visual J# Compiler 


Visual J# Reference 


New Project Dialog Box (Visual J#) 


The New Project dialog box contains a list of predefined Visual Studio project templates, which represent the types of projects 
you can create with Visual Studio. When you choose a Project Type, Visual Studio sets up the necessary compiler options, and 
adds basic assembly references to the project. All of the underlying code and resource files, such as icons, cursors, and so forth, 
are also generated so you can compile an empty stub project. Once generated, you can add your own implementations and 
compile from within the project. 


Visual J# provides four predefined project types: 


Project T |Project Description 
ype 





Windows |This project type is for creating Windows client applications. The project creates a Windows Form onto which you ca 
Applicatio|n drop other controls, and display text and graphics. For more information, 
n How to: Create a Visual J# Windows Application. 


Class Libr |A class library project creates a library file that can be referenced from other applications. 
ary 





Console [This project type is for creating command line utilities and applications. The output and input of the program occurs 
Applicatiojthrough a text-based terminal window. For more information, see How to: Create a Visual J# Console Application. 
n 














See Also 
Other Resources 


Using the Visual J# IDE 


Visual J# Project Settings 


Visual J# settings are designed to optimize the user experience and to maximize the productivity of J# developers. It enables 
you to customize and save your Visual Studio Integrated Development Environment (IDE) settings. 


You can also port or reload your IDE settings on other computers. For more information, see 
How to: Share Settings Between Computers. 


Windows and Views 
Feature Displayed by defau|Notes 





Class View Yes e Filtering is enabled 
e Class View folders are enabled 


Hides implemented interface nodes on classes. 





Command Window No Displays as a user option. 





Output Window Yes, when build start |Exposes GotoNextError commands through shortcut keys. 


s 














Solution Explorer Yes Synchronize selected file with open file in the Code and Text Editor is OFF b 
y default. 

Start Page Yes Only displays the first time you start the IDE. 

Task List (Visual Studio)|No It will not display because of any build command. 

Toolbox Yes Displays components in alphabetical order. 











In addition, the following elements have certain behaviors enabled when you select the Visual J# profile. 


Dialog Boxes 
Feature Behavior 








Quick Find, Find and Replace Window|Replaces one or more occurrences of a particular string. 





New Project Dialog Box When other platforms are installed on the machine, the IDE enables the combo box that 
allows you to specify the targeted platform. 


Options Dialog Box (Visual Studio) | |The More Options button displays options for Source Control, Device Tools, Database T 
ools, HTML Designer, and XML Designer. 











Keyboard 
Feature Behavior 
Shortcut Keys e Standard VS Editor 


e BRIEF Emulation 


e EMACS Emulation 





Miscellaneous Development Environment Elements 
Feature 


Windows Forms Designer settings The default view is the Code Editor, not the component designer view. 

















Main menus, shortcut menus, toolbars,com | e Short cut key stroke equivalents display next to main menu items. 
mands 





Shell appearance Has the common Visual Studio look and feel. 





Window management and layouts Default layout of windows: 


e The Solution Explorer, Class View, and windows display on the right side, at 
full length. 


Default layout of debugger windows: 
e By default, Autos, Locals, and Watch1, display at the bottom of the IDE. 


e@ Call Stack and Immediate windows in a separate window or at the bottom 
of the IDE. 


e The Output window will not display. 








See Also 

Tasks 

How to: Specify Settings for a Team 

Reference 

Advanced Build Settings Dialog Box (J#) 
Formatting, C#/J#, Text Editor, Options Dialog Box 





Visual J# Concepts 


How to: Create a Visual J# Console Application 


The purpose of this topic is to acquaint you with the Visual J# development environment as you build the simplest form of a 
Visual J# program, a console application. Console applications perform all their input and output at the command line, so they 
are ideal for quickly testing language features, doing simple exercises, and writing command line utilities. 





The features of the development environment discussed in this section will also be encountered when developing Windows 
Forms applications, so don't skip this part simply because you don't plan on writing console applications. 





In this section, you'll learn: 
e How to create a new console application. 
e How to view Solution Explorer. 
e How to keep your code nicely formatted. 
e How to use IntelliSense to make entering code faster and more accurate. 
e How to build and run your application. 


The program you create in this task makes use of the System.out Field to obtain and display a list of all the files, and their sizes, 
contained in a directory. You could use this code as a basis for a utility that searches a directory for a particular file name. 


The following example shows you how to create a simple console application called List Files that displays information about 
files from a particular directory. 


To create a console application 


1. On the File menu, click New, and then click Project. 

The New Project dialog box appears. This dialog box lists the different project types that Visual J# can create. 
2. Select the Console Application template, and change the name of your application to List Files. 
3. Click OK. 


Visual J# creates your project named after the project title, and opens the main Visual J# window, including the code 
pane, where you will enter and edit the J# source code that makes up your application. The project is stored in a 
temporary location until you actually save it. 


‘ Program.jsl | 


*$ List_Files.Program >| % main(String[]... 


package List_Files; 


Summary description for Program 
*) 
=| public class Program 
{ 
public static void main (String[] args) 


f 
i 


/ TODO: Add code to start application here 





Notice the toolbar at the top of the window. This toolbar contains icons for creating, loading and saving projects, editing 
your source code, building your application, and hiding and displaying other windows that make up the Visual J# 
environment. The four icons at the far right of this toolbar are used to open important windows such as Solution 
Explorer and the Toolbox. Point to any of these icons to get pop-up ToolTip Help. 


4. Click on the Solution Explorer tab on the right of the screen, or the Solution Explorer icon in the toolbar. 


Solution Explorer is a very useful pane, as it displays the various files that make up your project. The most important 
file in this project is the file Program,jsl, which contains the source code for your application. 





/ Program.jsl | 











a Files.Pr f +| eo: Solution Explorer vax 
package List_Files; ee) y 2) E] 
a ListFiles 
=F - =] Properties 
* Summary description for.. - «dj References 
*/ L.. wil) FTES 
=| public class Program 





{ 


- public static void main 


5. Now click to the right of the open curly brace ({) inside the main method, and press ENTER to start a new line. 
Notice how the editor automatically indents the cursor. 
6. Type the class name System. into the Code Editor. 


When typing a J# class name or keyword, you have a choice: you can either type the complete word yourself, or let the 
Intellisense tool that is part of the Code Editor do it for you. For example, when you type sys, a pop-up list of words is 
displayed as Intellisense attempts to predict the word you are typing. In this case, you won't see the word "System" 
displayed just yet, so either scroll down the list, or continue typing the word "system." When "system" is highlighted in 
the list, press ENTER, or TAB, or double-click it, and System will be added to your code. 





' Program.js!i* 


*$ List_Files.Program 














package List_Files; 


* Summary description for Program 
+) 
=| public class Program 
{ 
- public static void main (String[] args) 
{ 
System.| 
; “!AppDomain 
bard AccessViolationException 
3 Action<> 
ay ActivationArguments 
4 ActivationContext 
4% Activator 
4% AppDomain 


The advantage of using IntelliSense is that you can be certain the casing and the spelling are correct. Whether you type 
the code or let Intellisense do it is entirely up to you. 


7. Type a period and the class name out, followed by another period. 


As soon as you type the period after out, another IntelliSense list is displayed. This list contains all the possible classes, 
methods, and properties that are part of the out stream class. You want the PrintStream.println Method method, and you 
should be able to see it at the bottom of the list. Either finish typing println yourself, or press the DOWN ARROW key 
until it is selected, and press ENTER, or TAB, or double-click it. printIn will be added to your code. 


System.out.printin( B 
41 of 10 ¥ void PrintStream.printIn() 


8. Type an open parenthesis ((). You'll immediately see another Intellisense feature—the method signatures appear as a 
tool tip message. In this case you can see there are 10 different signatures, and you can look through them by clicking 
the UP and DOWN ARROW keys. 


9. Type the string "This program lists all the files in the directory." 


Type the message inside quotation marks, and add a closing parenthesis ()). You'll see a red wavy underline displayed as 
a reminder that something is missing. Type a semicolon (;) and the wavy underline will disappear. 


10. Finish the program. 


Type or copy and paste the following code to complete the program: 
import java.io.File; 


public class Program 


{ 
public static void main(String[] args) 
sf 
System.out.println("This program lists all the files in the directory:"); 
File filePath = new File("c:\\Program Files"); 
java.io.File[] fileList = filePath.listFiles(); 
for (int idx = @; idx < fileList.length; idx++) 
{ 
System.out.printin(fileList[idx]); 
} 
} 
} 


11. Run your program. 


Your first program is now complete and ready to compile and run. To do this, either press F5 or click on the Start icon in 
the toolbar. 


> 


Once the program compiles and runs, the Console window opens and a list of files and their sizes is displayed. Press 
ENTER to exit the program. 


12. If you are new to J# programming, this would be a good time to read the Visual J# Referencesection, and try out some of 
the language examples. If you want to know more about the Visual J# development environment, and how to create 
Windows Applications, move on to the next section, How to: Create a Visual J# Windows Application. 


See Also 
Other Resources 


Using the Visual J# IDE 


Visual J# Concepts 


How to: Enter Code in Visual J# 


The following examples show you how to use the Code Editor to insert code into your Visual J# application. You can either 
create a new jsl code file or open an existing one. 


To start and create a new project 


1. On the File menu, point to New, and then click New Project. 
The New Project dialog box appears. This dialog box lists the different project types that the Visual J# can create. 
2. Select the Console Application template, change the name of your application to CreateCode, and click OK. 


Visual J# creates your project named after the project title, and opens the Code pane, where you enter and edit the J# 
source code that makes up your application. The project is stored in a temporary location until you actually save it. 


The pre-generated code in your Program jjsl is color-coded. By default, the blue text contains application keywords, access 
modifiers, and method return types. For example, the phrase public class describes Programas class that anyone can 
use. 


Black bold text describes data types, methods or functions, and native data types. For example, Program happens to be 
the default class name for J# console applications. You can change the name to describe your application. 


Green text indicates that the information contains helpful comments and javadoc documentation comments. 


3. In the Program sl, click on the commented line directly below // ToDo: Add code to start application here, and 
press Enter. 


4. Click the blank line and begin entering your code. 


To enter code in an existing J# file 


1. In Solution Explorer, double-click on your Js| file. 
-or- 
From the File menu, point to Open, and then click File. Click on the appropriate folder to find the file. 
-or- 
Press CTRL+O and double-click on the file that you want to open. 
The file is displayed in the Code pane. 
2. Click ona blank line and begin coding. 
-or- 


3. Click at the beginning of any line, and press Enter. Then move to the blank line that you just inserted and begin coding. 


See Also 
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How to: Create a Visual J# Windows Application 


The purpose of this topic is to acquaint you with elements of the Visual J# development environment as you build a simple 
Visual J# program using Windows Forms. Windows Forms provides your project with the components that make up a 
standard Windows application user interface, including dialog boxes, menus, buttons, and many other controls. 


This example shows you how to create your own Web browser, which you can customize with shortcuts to your favorite Web 


sites. 





Note 








Many of the features of the development environment discussed in this topic will also be encountered when developing cons 
ole applications, so don't skip this part simply because you don't plan on writing Windows applications. 





In this section, you'll learn: 


How to create a new Windows application. 

How to toggle between Code and Design views. 
How to change the Windows Form's properties. 
How to add a menu control. 

How to create and populate a ComboBox control. 
How to use a Web Browser control. 


How to create handlers for controls. 


To create a J# Windows application 


1. 


On the File menu, point to New, and then click Project. 


The New Project dialog box appears. This dialog box lists the different default project types that you can use Visual J# to 
create. 


. Select Windows Application as your project type. 
. Type Web Browser in the Name box to change the name of your application. 


. Click OK. 


Visual J# creates your project, named after the project title, and then opens the Visual J# Windows Forms Designer. The 
default view is of your new Windows Form, Form1. You can change from this view to the source code view at any time 


by pressing F7 or by selecting Code from the View menu, and you can return to the Designer view by pressing 
SHIFT+F7. 





/Form1.jsl [Design]*  ~ Text | 


fi Form1 j—|Olx, 











Form1 is the form that is displayed when your application is launched. You can add various controls to this form, accept 
input from the user, display text and graphics, and do everything that a Windows application can do. Behind the scenes, 
the code that is required to manage the window has been created by Visual J#. J# keeps all of the code in the main file for 
the form because J# does not support partial types. 


5. Change the size of the Windows Form. 


If you aren't already in the Designer view, press SHIFT+F7. Click on the lower-right corner of the Windows Form, and 
when the cursor becomes a double-headed arrow, click and pull the corner of the form until it's approximately as wide 
and as deep as a quarter of your screen. This is the window in which your Web sites will be displayed, so you don't want 
it be too cramped. 


6. Change the title of the Windows Form. 


If the Properties window isn't already open, select Properties Window from the View menu. This window lists the 
properties of the currently selected Windows Form or control, and it's here you can make alterations to existing values. 


Find the property Text. In the column to the right, select Form1, and type Web Browser. Press ENTER or the TAB key to 
move focus from the control, and you'll see that the name on your Windows Form has changed. Notice that there is a 
similar field called (Name). This is the name of the class that contains the Windows Form. You can change it too, but if 
you do, remember that the rest of the code in this task refers to the old name of Form1. 





Properties v4 





En x 


Form1 System.Windows.Forms.Form 





Cursor Default 
* Font Microsoft Sans Serif 
ForeColor HM controitext 
FormBorderStyle Sizable 
RightToLeft No 
Web Browser 
UseWaitCursor False 
= Behavior iy] 
Text 


The text contained in the control. 





7. Add a Menu control. 


Open the Toolbox by selecting Toolbox from the View menu. Scroll down the list of controls until you get to 
MenuStrip. Drag this control to anywhere on the Windows Form. 


10. 





Form1.jsi [Design] * 








After you have released the MenuStrip control, you'll see that it creates a default menu at the top of the form. 
Populate the Menu. 


In the box that says Type Here, type Navigate to give the menu a name. When you press ENTER, new empty boxes 

appear in which you can create other menus and menu items. In the lower box, type Home. Press ENTER, and more 

boxes are displayed. Type Go Back. Press ENTER, and type Go Forward. These menu items form your basic Web site 
navigation controls. 





[_} 


Form1.js! [Design]* | 





fg] Form1 Tex) 


Navigate = | a ype I 


Home 
Go Back 
Go Forward 


- 





In order to make your source code more legible, you should rename the default names given to the menu items. If you 
open the Properties window and click on each menu item in turn, you will see they have Design Names such as 
menultem1, menultem2, and so on. 


Rename the menu items so that the Home item is called menultem_Home, Go Back is called menultem_GoBack, and 
Go Forward is called menultem_GoForward. 


Add a button. 


From the Toolbox, drag a button control to approximately the middle of the Windows Form, just below the menu bar. 
View the button in the Properties window, change the Text property to Go instead of button1, and change the design 
name from button1 to button_go. 


Add a ComboBox. 


Drag a ComboBox control from the Toolbox and position it to the left of the new button. Click and drag the edges and 
corners to resize and reposition the ComboBox until it is lined up with the button as shown in the following screenshot. 








Note 








11. 


12. 


13. 


14. 





When you are moving controls around a Windows Form, you will see blue lines displayed. These lines are guides that h 
elp you line up the controls vertically and horizontally. You can also line up controls by selecting more than one at a ti 
me. You can do this by dragging a selection box around the controls, or holding down SHIFT as you click on them. Then 
use the appropriate align and resize buttons, located on the Layout Toolbar, to situate the controls. 








Populate the ComboBox. 


A ComboBox provides a drop-down list of options from which the user can choose. In this program, the ComboBox is 
going to contain a list of your favorite Web sites for quick access. 


To create the list of sites, select the ComboBox, and view its properties. Click in the column next to the Items property, 
and you'll see an ellipses button (...). Click this button to open the String Collection Editor dialog box, in which you can 
add contents to the ComboBox. Add as many Web site URLs as you want, pressing RETURN after each. 


Add the WebBrowser control. 


Open the Toolbox, and scroll down until you locate the WebBrowser control. Drag the control to the Windows Form. 
Resize the WebBrowser control to fit nicely inside the Windows Form without obscuring the ComboBox and Button 
controls. If the WebBrowser control doesn't resize easily, open its properties, locate the Dock setting, and make sure 

that it is set to none. Setting the Anchor settings to Top, Bottom, Left, Right will cause the WebBrowser control to 

resize properly when you resize the application window. 


The WebBrowser control is the control that does all the hard work of rendering the Web pages. 
Add a handler for the Button control. 


You have now finished the design stage of your application, and are at the point when you need to start adding some J# 
code to provide the program's functionality. 


You need to add handlers for the button and for each of the menu options. A handler is a method that is executed when a 
particular control is activated. Visual J# creates empty handlers for you automatically. 


Double-click the button, and the Code editor for your project is displayed. You'll also see that the handler for the click 
event—the event message that occurs when the user clicks on a button—has been created for you. Add code to the 
handler method so it looks like the following code: 


private void button_go Click(Object sender, System.EventArgs e) 


{ 
webBrowser1.Navigate(comboBox1.get_SelectedItem().toString()); 


} 


This code takes the currently selected item from the ComboBox control, a string containing a Web URL, and passes it to 
the Web Browser's navigation method. The navigation method loads and displays the contents of the Web page at that 
location. 


Add handlers for the menu options. 
Return to the Designer view by pressing F7, and double-click on each of the menu items in turn. Visual J# creates 


handler methods for each. Edit these methods so they look like the following code: 


private void menuItem_Home_Click(Object sender, System.EventArgs e) 


{ 
// Go to Home Page menu option. 
webBrowser1.GoHome() ; 
} 
private void menuItem_GoForward_Click(Object sender, System.EventArgs e) 
{ 
// Go forward menu option. 
webBrowser1.GoForward(); 
} 


private void menuItem_GoBack_Click(Object sender, System.EventArgs e) 


15. 


16. 


17. 


// Go back menu option. 
webBrowser1.GoBack(); 





Each of these menu handlers calls a navigation method that is part of the Web Browser class. 





Note 





You can see from this code that the default names given to the menu options can become quite confusing. For this reas 
on, it's a good idea to change the name of each menu control as you create it, using the Properties window. The name 
of the handler will then reflect the name of the menu option. 











Add some initialization code. 


The last task is to add some more code to the Form1 method. This method is the constructor for the Form1 object, and is 
called when the Windows Form is being created. It's therefore the ideal location to place any code that is required to 
change the controls’ initial values or other settings. 


The following code will cause the Web Browser control to display your computer's default home page, and also set the 
initial value of the ComboBox. Change the method to contain the following code: 





public Form1() 


{ 
InitializeComponent(); 
comboBox1.set_SelectedIndex(@) ; 
webBrowser1.GoHome() ; 

i 





Build and run the program. 


Press F5 to build and run your Web browser. Your Windows Form should be displayed on the screen, and then should 
display your computer's default home page. You can use the ComboBox control to select a Web site, and click Go to 
navigate to it. The menu options enable you to return home, or move back and forth through previously visited Web 
sites. 


= 








Navigate 








msii. Search the Web: 









News & Sports 
Link Today on MSN 


Link 
Link 


Look it Up MSNBC NEWS 
Link Link 
Link Link 








| http://www.msn.com x] Go | 


If you are new to Visual J# programming, this would be a good time to read the Visual J# Reference section. If you want 
to know more about the Visual J# development environment, and how to create console applications using Intellisense 
in particular, read the previous section How to: Create a Visual J# Console Application. 
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How to: Navigate and Search in Visual J# 


There are various ways to move through text or code in the Code Editor using the mouse and navigation keys: 


e Use the arrow keys to move one character at a time, or the arrow keys in combination with the CTRL key to move one 
word at a time. Arrow keys move one line at a time also. 


e Click a location with the mouse. 
e Use the scroll bars or scroll wheel on the mouse to move through the text. 
e Use the HOME, END, PAGEUP, and PAGEDOWN keys. 


e Use CTRL+PAGE UP and CTRL+PAGE DOWN to move the insertion point to the top or bottom of the window, 
respectively. 


e Use CTRL+UP ARROW and CTRL+DOWN ARROW to scroll the view without moving the insertion point. 


e Use the Navigate Backward button to move the insertion point to previous locations in the active document, and the 
Navigate Forward button to return to more recent locations. 


Operations such as Incremental Search, Goto Line, Goto Definition, Beginning of Document, End of Document, Paste, 
and Insert File can move the insertion point a significant distance within the active document. The Navigate Backward and 
Navigate Forward buttons retain the last 20 locations of the insertion point. 


The following sections describe other ways to move to specific sections and lines of code: 
e Navigation bar 
e Bookmarks in the Bookmarks Window 
e Comment tasks in the Task List 
e Incremental searches 
e Go to Line command 


e Go to Definition command 


Navigating with the Navigation bar 


The Navigation bar consists of two combo boxes displayed at the top of the Code Editor. It allows you to navigate directly to a 
particular class or type, or to a procedure or member within it. Not every project incorporates the Navigation bar. The 
following descriptions show you how to use navigate through your code. 





Note 





The names of the two combo boxes on the Navigation bar vary depending on the type of project. For example, in Visual Bas 
ic projects, the boxes are named Class Name and Method Name. In C# projects, the boxes are named Types and Member 
s. 











To shift focus from the Code Editor to the Navigation bar 


e Press the shortcut key combination CTRL+F2. 


To return focus from the Navigation bar to the Code Editor 


e Press the ESC key. 


To shift focus from item to item on the Navigation bar 


e Press the TAB key. 


To select the Navigation bar item that has focus and return to the IDE 


e@ Press the ENTER key. 
To navigate to a class or type 
e Click its name in the Class Name/Types combo box in the upper left corner of the document. 
To navigate directly to a procedure in a class 
e Click a procedure in the Method Name/Members combo box in the upper right corner of the document. 


Navigating with Bookmarks 


Bookmarks help you navigate to sections of code more quickly. The following examples show you how to use Visual J# Express 
Edition bookmarks. 


To add a bookmark 


1. In the editor, select a line you want to return to at later time. 

2. On the Bookmarks toolbar, click the Toggle a bookmark on the current line. Button. 
_J 
-or- 
Press CTRL+K. 
A bookmark symbol is displayed in the left margin of the Code Editor to mark the line. 
J 

3. Keep pressing CTRL+K to toggle a bookmark on and off. 


To move through bookmarks in the active document 


1. On the Bookmarks toolbar, click Move the caret to the next bookmark. to scroll to the next bookmark in your code. 
-Or- 
Press CTRL+K and then CTRL+N to move to the next bookmark. 


Move the caret to the next bookmark. 


2. On the Bookmarks toolbar, click Move the caret to the previous bookmark. to scroll to the preceding bookmark in 
your code. 


-Or- 
Press CTRL+K and then CTRL+P to move to the previous bookmark. 


Move the caret to the previous bookmark. 


Another way to return to a location is by using the Navigate Backward and Navigate Forward buttons. 
To remove all bookmarks from a document 


e Inthe Bookmarks window, click the Clear Bookmarks button 


Press CTRL+K and then CTRL+L to erase all bookmarks from the active document. 


Delete all bookmarks in all files. 


Note 








To delete a single bookmark, right-click the bookmark and click Toggle Bookmark, or keep pressing CTRL+K until the 
bookmark is removed. 








Navigating with Comment Tasks 


A comment task begins with the phrase //ToDo and reminds you of code that requires completion. You can create comments 
tasks in your code that mark places to which you will need to return, and then navigate directly to those locations from the 
Task List. 


To create and use a comment task 


1. In the View drop-down list select Other Windows and then Task List. 
The task list grid displays a list of work items as well as their statuses. 
2. From the Comment drop down list, select Comments. 
All comment tasks in the code of the active document display. 


3. Add a comment task to your code, type two forward slashes followed by a space and then the keyword TODO. For 
example: // TODO Finish this code! 


As soon as you type TODO, this task is automatically added to the Comments list in the Task List. As you change the text 
in the comment task, the Comments list automatically updates. 


4. Click on any comment task to navigate to its location in your code. 


For more information, see Task List (Visual Studio). 


Incremental Search 


Incremental search helps you navigate directly to locations in the current document as you enter the search characters. The 
following instructions show you how to perform an incremental search. 


To navigate using incremental search 


1. Select Advanced on the Edit menu and choose Incremental Search. 
2. Begin typing the characters of the string you wish to find. 


As you add characters, the Code Editor highlights the first matches found in the current document. 


Go to Line command 


The following instructions show you how to use the Go to Line command to move the insertion point to a specific line 
number. 


To go to a specific line number 


1. In the General, All Languages, Text Editor, Options Dialog Box, select the Line Numbers option. 
2. With a document open in the Editor, select Go to Line from the Edit menu. 


3. Enter the line number you want to view. 


Go to Definition command 


The Go to Definition command navigates to the procedure for a local class declaration, method, or a variable definition. For 
example, if you define a procedure called MyProc(), and then later in your code make a call to MyProc (), you can navigate 
directly to the procedure for this method using Go to Definition. 


The following instructions show you how to find your local class declarations, methods, or variable definitions using the Go to 
Definition command. 


To go to the definition for the procedure or variable called 


1. Select any call to a procedure or variable. 
2. Press F12. 


The Code Editor displays the procedure or variable. 


3. To return to the point of the call, press the Navigate Backward button. 


If the definition lies outside your project, its source displays in the Object Browser. For further information, see 
Using the Object Browser. 
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How to: Insert Code Snippets (Visual J#) 


You can insert Intellisense Code Snippets using the navigation tools in the Code Editor or by dragging files from Windows 
Explorer. When you know the name of the snippet you want to insert, you can do so by typing its shortcut. When you need to 
browse for an appropriate snippet, you can use the snippet picker, which gives you categorized lists of snippets to choose 
from. 


There are three ways to insert code snippets. You can insert them using the Intelisense menu, type a shortcut, or drag them 
from Windows Explorer. The following procedures show you how to insert Intellisense Code Snippets: 


To insert a snippet by browsing in the Code Editor 


1. Right-click the Code Editor where you want to insert the code and point to Intelisense. 
2. On the shortcut menu click Expansion. 

-or- 

Type a question mark followed by TAB in the Code Editor to open the code snippet picker. 
3. On the snippet picker, navigate to the task of your choice and click it. 


The snippet code inserts into your code. Once you add the snippet into your code, you can use the Code Editor to 
customization it. For example you can replace variable names with more appropriate names. 


To insert a snippet when you know its shortcut 


e Type the shortcut for the snippet in the Code Editor followed by TAB. The snippet will be inserted. 
-Or- 


e Type the first few characters of the shortcut for the snippet in the Code Editor, followed by a TAB. A picker will appear 
with the list of snippets whose shortcuts begin with the characters you typed. 


To insert a snippet into your code using Windows Explorer 


1. Open Windows Explorer. 


2. Navigate in Windows Explorer to the folder that contains the file you want to insert. If you choose the default location 
for the installation of Visual Studio 2005, the snippets are stored in C:\Program Files\Microsoft Visual Studio 8\V 
C:\Program Files\Microsoft Visual Studio 8\VJ#\Expansions\. 


3. Drag the file from Windows Explorer to the place in your code where you want to insert it. 
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Upgrading from Visual J++ 6.0 


This section provides recommendations and procedures for upgrading Microsoft® Visual J++ 6.0® applications to Microsoft 
Visual J#. It includes topics on planning, troubleshooting, using resources, upgrading Java-language/COM interoperability 
projects, and upgrading from various com.ms.* packages. There are also topics on using the Visual J# Upgrade Wizard and the 
upgrade report. 


You can open and upgrade existing Visual J++ 6.0 projects using Visual J#, but in some cases you may need to modify your 
projects after upgrading them. 


In This Section 
Introduction to Visual J# for Visual J++ Users 


Discusses how Visual J# adds support for the Java language on the .NET Framework. 
Planning to Upgrade 

Provides a brief overview of upgrading from Visual J++ to Visual J#. 
Visual J# Upgrade Wizard 

Provides an overview of the Visual J# Upgrade Wizard and details on working with its features. 
Visual J# Upgrade Report 

Describes the format and purpose of the upgrade report. 
Upgrading a Visual J++ 6.0 Project 

Describes how to upgrade your Visual J++ 6.0 project to Visual J# using the Upgrade Wizard. 
Upgrading Visual J+ + 6.0 Applications That Use Resources 


Covers the procedure to convert resources used by a Visual J++ 6.0 project into NET Framework resources, including 
compatibility issues involved with embedding or linking a resource. 


Upgrading Projects Using Java-Language/COM Interoperability 
Discusses how to compile, debug, and run Java-language/COM components developed with Visual J++® 6.0. 
Upgrading Applications That Dynamically Load Classes 
Contains sections about the CLASSPATH variable and binding. 
Upgrading Applications That Use Custom Class Loaders 
Presents the argument against using custom class loaders in Visual J#. 
Upgrading Applications That Use the Visual J++ 6.0 Security Semantics 
Discusses security semantics and applications that use third-party providers. 
Upgrading from com.ms.* Packages to . NET Framework Class Libraries 


Shows the .NET Framework class library equivalents to some of the commonly used com.ms.* packages. Includes topics on 
upgrading from the com.ms.xml.*, com.ms.mtx, and com.ms.wfc.html! packages. 


Common Issues in Upgrading Projects from Visual J++ 6.0 
Lists issues that may be encountered after upgrading your project to Visual J#. 
Conditional Debugging Support 


Provides information about when to use the Visual J++ 6.0 @conditional attribute versus the .NET ConditionalAttribute 
class. 


Working with Both Visual J++ 6.0 and Visual J# 


Explains how you can work on Visual J++ 6.0 and Visual J# side-by-side after upgrading a Visual J++ 6.0 solution. 


Related Sections 
Language Support 


Provides reference information about Visual J++ 6.0 and .NET Framework features that are supported and not supported in 
Visual J#. 


Class Library Support 

Lists the packages supported and not supported, as well as implementation-specific details for the class library support. 
Visual J# Upgrading Reference 

Provides help for issues detected by the Upgrade Wizard during upgrade of projects from Visual J++ 6.0 to Visual J#. 
Upgrading Projects Using Java-Language/COM Interoperability 

Discusses the considerations while upgrading Visual J++ 6.0 projects that make use of Java-language/COM interoperability. 
Visual J# 

Provides links to various areas of the Visual J# documentation set. 
Visual J# Migration 


Describes the tools available to convert Java and J++ applications, applets, and bytecode to Visual J#. 
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Introduction to Visual J# for Visual J++ Users 


The Visual J# product: 


e Adds support for the Java language on the .NET Framework. This product brings the power and richness of the NET 
Framework to Java-language programmers, and enables you to carry forward existing Java-language skills and code. 


e Enables you to participate in the vision of XML Web Services and leverage the rich programming frameworks of 
ASP.NET, ADO.NET, and Windows Forms libraries to create compelling applications. 


e Provides a seamless upgrade path for Visual J++ developers. It is fully integrated with Visual Studio, and presents a 
familiar interface for Visual J++ developers. 


See Visual J# Overview for an overview of the product. 


Visual J# can exist side-by-side with Visual J+ + on the same system. During upgrade, the source files and other files in the 
project are not modified. The existing project file is also untouched. You can open the existing Visual J++ project and work on 
the application in Visual J++ even after you upgrade to Visual J#. 


The following are some of the key aspects of upgrading to Visual J#: 


e Development in Visual J# targets the NET Framework, that is, the output of Visual J# projects are binaries in the 
Microsoft Intermediate Language (MSIL). These are executed on the common language runtime (CLR) with the runtime 
support provided by the Visual J# implementation. 


e Most of the functionality from the JDK 1.1.4 libraries is available in the Visual J# implementation. For details, see 
Class Library Support. 


e The Visual J# compiler supports all key features of the language and also fully supports consuming the .NET Framework. 
It also supports the extensions supported in Visual J++, such as J/Direct and Java/COM interoperability. 


e There is no design-time support for WFC projects. Only new applications created using any of the Visual J# project 
templates have design-time support. However, you can extend existing applications by adding new functionality enabled 
by Visual J#. For example, you can extend a WFC application with Windows Forms. See WFCUsingWinForm Sample for 
more information. 


e Resource file formats are different. For more information, see Upgrading Visual J++ 6.0 Applications That Use Resources. 


e Visual J# can be used to open and upgrade projects created using Visual J++ 6.0. Opening a Visual J++ project in Visual 
J# starts the Upgrade Wizard, which eases the transition to the new product. The Upgrade Wizard creates a new project 
to which your existing project files are added. During the upgrade, no source files are modified. Additionally, the wizard 
analyzes your project to identify any issues. These are listed in an upgrade report, which is added to the new project. Each 
issue has a link to a topic in the documentation describing how to address it. 
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Upgrade Planning 


In most cases, Visual J# provides a simple upgrade experience for Visual J++ projects. However, you should ensure that your 
project is building and running successfully in Visual J++ before attempting to upgrade. You should also set the active 
configuration of the Visual J++ project to Release and verify that the application is running before upgrading. This will result in 
an easier upgrade. 


There are some features in Visual J++ which are not supported in Visual J#, or have compatibility issues in Visual J#. See 

Class Library Support and Language Support to determine possible work that may be required to get your application running 
successfully in Visual J#. Common Issues in Upgrading Projects from Visual J++ 6.0 lists a number of issues that you may 
encounter in upgrading your application. 


The Upgrade Wizard sets project properties and references for COM and .NET components based on your input, as well as the 
analysis of the project files. For very large projects, analysis may take some time, comparable to the time required to build the 
upgraded project. Although the wizard allows you to skip the analysis step by clicking the Finish button, it is recommended 
that you do not. The upgrade report that is created by the wizard identifies many of the issues in getting your application 
successfully running on Visual J#. This list of issues may be useful in determining the amount of work required to upgrade 
successfully. 


See Also 
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Visual J# Upgrade Wizard 





Note 





The dialog boxes and menu commands you see might differ from those described in Help depending on your active settings 
or edition. To change your settings, choose Import and Export Settings on the Tools menu. For more information, see 
Visual Studio Settings. 











Visual J# includes an Upgrade Wizard to assist you in upgrading your projects from Visual J++ 6.0 to Visual J#. 


To access the Upgrade Wizard, open any Visual J++ 6.0 solution (.sIn) file or project (.vjp) file in Visual J#. If the Visual J++ 
solution has more than one project, the wizard is started for each project. 


The wizard then takes you through a series of steps to identify issues in upgrading and running your application on Visual J#. 
The issues detected are displayed in an upgrade report. For more information, see Visual J# Upgrade Report. 


The wizard creates a new project in the same location as the original project, and adds the source files from the Visual J++ 
project to the new project. No changes are made to the source code. The wizard analyzes the source files to determine whether 
there are any issues in upgrading the project to Visual J#. The results of the analysis are used to set the appropriate project 
properties in the upgraded project. All unsupported functionality issues and compatibility issues detected in the analysis are 
added to the upgrade report. 


The wizard attempts to add references to COM and .NET Framework components detected as being used by the project. 
Resource (.resources and .properties) files in the project are also upgraded to the .NET Framework resource (.resx) file format 
by the wizard. 


On the first page of the wizard, you can choose one of the following: 
Cancel 
Cancels the upgrade to Visual J#. 
Next 
Takes you to the second page of the wizard. 
Finish 


Upgrades the project immediately, without analyzing the project files. You will have to manually make any changes required 
to the new project properties and source files, in order to build and run the upgraded project. 


For help using the wizard, press F1 while the wizard is displayed. 


In This Section 
Upgrade Wizard: Choose a Project Type 


Provides details on using the wizard to choose a project type. 
Upgrade Wizard: Add Project References 


Provides details on using the wizard to add project references. 
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Upgrade Wizard: Choose a Project Type 





Note 





The dialog boxes and menu commands you see might differ from those described in Help depending on your active settings 
or edition. To change your settings, choose Import and Export Settings on the Tools menu. For more information, see 
Visual Studio Settings. 











The Visual J# Upgrade Wizard attempts to determine the type of project to which the Visual J++ project should be upgraded. 
In cases where the project can be upgraded to more than one type, you can choose which project type to create. 


On this wizard page, you can select the project type, and click Next to continue with the wizard. To upgrade immediately and 
bypass the remaining wizard steps, click Finish. 


The project type choices are as follows: 
Console Application 


If your Visual J+ + project was intended to run as a command-line application using the Jview.exe tool, it should be upgraded 
to a console application under Visual J#. If you intend to use the classes in this project in another project, you should 
consider creating the new project as a class library. For example, you should choose Class Library if you are upgrading a 
project containing a class library or a control. Only class library projects can have their output referenced in other projects 
under Visual Studio. 


Windows Application 


If your Visual J++ project was created as an application using Windows Foundation Classes (WFC) or AWT, it should be 
upgraded to a Windows application under Visual J#. If you intend to use the classes in this project in another project, you 
should consider creating the new project as a class library. 


Class Library 


If your Visual J++ project was created such that its classes could be used in other projects, or if it was created as a COM DLL, 
it should be upgraded to a class library under Visual J#. A Visual J++ control project should also be upgraded to a class 
library project. 


If you want to change the project type after upgrading the project, you can change the project properties in Visual J# to select 
the project type manually. For information, see Setting Visual J# Project Properties. 
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Upgrade Wizard: Add Project References 


The Visual J# Upgrade Wizard attempts to analyze your Visual J++ 6.0 project files to determine the properties for the 
upgraded Visual J# project, as well as identify any unsupported APIs or compatibility issues. To analyze the sources completely, 
the wizard requires references to all classes used in the Visual J++ 6.0 project that are not defined in the project itself or in 
Visual J# class libraries. See Class Library Support for a list of supported classes under Visual J#. References to COM type 
libraries describing COM classes or interfaces used in the project are also needed for the analysis to be complete. 


If your project does have external references, and you choose not to add these references using this wizard page, the wizard 
can upgrade the Visual J++ 6.0 project to Visual J#. However, to build and run the upgraded project, you may need to add the 
external references to the project later. 


The CLASSPATH setting defined for the Visual J++ project, if any, is displayed on this wizard page. You can then identify the 
locations of external references. 


Click the Add button to select one or more .NET Framework components, also referred to as INET Framework class libraries or 
assemblies, or COM type libraries to add to the references list. Use the Remove button to remove items from the list. 


The .NET Framework and COM components added to the references list will be added to the upgraded project's references list. 


It is recommended that you add all known references to the list before upgrading. If you do not add items to the references list, 
the upgrade analysis will attempt to identify unresolved external references in the project, as follows: 


e The registry will be searched for COM references. 


e Class references will be searched in the CLASSPATH defined in the Visual J++ project. 


If your Visual J++ project uses classes from another library or project, you should add a reference to them. Under Visual J++ 
6.0, the CLASSPATH setting of the project is used to search for referenced classes. If any of these classes are not part of the 
Visual J# class libraries, you will need to add a reference to a class library (DLL) that contains implementations of the 
referenced classes. 


If your Visual J++ project uses classes or interfaces defined in a COM DLL or type library, you can add the DLL or type library 
(tlb) file to the references list. If classes in your project extend or implement classes and interfaces defined externally and 
references to them are not available, analysis may be incomplete for those classes. 


If you do not have the source files, you can convert class (.class) files or archive (.cab, jar, or zip) files to class libraries using the 
Visual J# Binary Converter Tool. 
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Visual J# Upgrade Report 


The Visual J# Upgrade Wizard creates an upgrade report for every project that is upgraded from Visual J++ 6.0 to Visual J#. 
This report is added to the upgraded project. By default, the upgrade report will be opened when the wizard is closed. The 
upgrade report contains information about the upgrade process and a list of issues that need to be addressed before your 
project can be run. 


The upgrade report is in HTML format; you can view it within the Visual Studio development environment by double-clicking 
the file in Solution Explorer, or you can view it in an external browser by choosing Browse With from the File menu. 


There are three sections in the report: 


e The first portion contains general information about the upgrade, including location of the upgraded project and time of 
upgrade. 


e The second portion contains a list of issues identified during upgrade. By expanding the section for each category of 
issues, you can see the details of the issues, including impact of the issue and number of occurrences in the project. You 
can further expand each issue to see relevant details such as the files where the issue has been detected. Each category 
and issue description is a link to a help topic with more information on how to address the issue. 


e The last portion contains additional upgrade information, such as a list of references added to the upgraded project. 
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How to: Upgrade a Visual J++ 6.0 Project 





Note 





The dialog boxes and menu commands you see might differ from those described in Help depending on your active settings 
or edition. To change your settings, choose Import and Export Settings on the Tools menu. For more information, see 
Visual Studio Settings. 











Visual J++ 6.0 solutions and projects can be easily upgraded to Visual J# using the Visual J# Upgrade Wizard. If a Visual J++ 
solution is opened in Visual Studio, you will be prompted to upgrade each project using the Upgrade Wizard. An upgrade 
report is generated and added to each upgraded project. This report lists the upgrade issues discovered during analysis of 
project files by the Upgrade Wizard. 





Note 





None of the source files in the project are modified during the upgrade. 








Before starting to upgrade, it is required that you close the solution if it is opened in Visual J++ 6.0. Also, if the project is in 
source control, the solution file should have write access. 


To upgrade a Visual J++ 6.0 project to Visual J# 


1. Open your project in Visual J++ 6.0. Set active configuration to Release. Build the project. Run the application and make 
sure there are no errors. 


2. Close Visual J++ 6.0 and start Visual Studio (with Visual J# installed). On the File menu, point to Open, and click Project. 


3. Browse to the location of the Visual J++ project in the Open Project dialog box and select the project (.vjp) or solution 
(.sIn) file. This will launch the Upgrade Wizard. 


4. On the first page of the wizard, you can click Finish to bypass project analysis. It is recommended that you continue with 
all wizard steps. 





Tip 





For more information, press F1 while in the wizard. 











5. On the second page of the wizard, choose from the available project types to upgrade your project. 





4Tip 





For an explanation of available options, click the More Information link on the lower right corner of the page. 











6. On the third page of the wizard, add references to COM libraries and .NET Framework components containing classes 
used in the project. 





4Tip 





For more information on adding references, click the More Information link on the lower right corner of the page. 








7. Click Next to begin analysis of your project files to detect upgrade issues. This may take a few minutes, depending on the 
size of your project. 


8. When analysis is complete, the wizard will display the next page. Click Finish to complete upgrading your project. The 
upgraded project will appear in Solution Explorer. 


9. By default the upgrade report will be opened. If it is not open, double-click the _UpgradeReport.htm node in Solution 
Explorer to view the upgrade report. 


10. Review the upgrade report. Fix all issues that will result in build errors and run-time errors. 





4Tip 








Click the description of any issue to display a help topic for the issue. 








11. Press F5 to build and run the upgraded project. 


Some of the build settings that are configurable independently for Debug and Release versions in Visual J+ + 6.0 are now 
common properties in Visual J#. For example: 


e Output Type indicates a Windows application, console application, or class library. 
e Startup Object indicates the class whose main method is called when the application starts. 


When upgrading to Visual J#, values for the above properties are taken from Release settings of the Visual J++ project. For 
help with some common issues with upgraded projects, see Common Issues in Upgrading Projects from Visual J++ 6.0. 


During the upgrade process, the extension .old is appended to the Visual J++ solution file for backup purposes. For example, 
vj6App.sin is renamed vj6App.sin.old. The new solution file created by the upgrade process has the same name as the original 
Visual J++ solution file, vj6App.sin, and the new project files have the extension .vjsproj. 


To use the original (backup) Visual J++ solution in Visual J++ 


1. Rename the new upgraded solution file to some other name, for example, vj6App.new.sIn. 


2. Rename any file with .suo extension. For example, rename vj6App.suo to vj6App.new.suo. 


Note 


By default, files with the .suo extension are hidden in Windows. 





3. Remove .old from the .sIn.old extension appended to the original solution file. For example, vj6App.siIn.old becomes 
vj6App.sin. 


4. Open the solution file from step 3 in Visual J++. 





Note 





The wizard may not be able to detect all issues in the upgrade, especially if all required references were not specified on page 
3 of the wizard. 
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How to: Upgrade Visual J++ 6.0 Applications That Use 
Resources 


The dialog boxes and menu commands you see might differ from those described in Help depending on your active settings 


or edition. To change your settings, choose Import and Export Settings on the Tools menu. For more information, see 
Visual Studio Settings. 





Before an existing Visual J++ resource can be embedded or linked to managed assemblies for use on the common language 
runtime, the resource files must be converted to a format supported by the NET Framework. 


Although the file extension for resources under both the INET Framework and Visual J++ 6.0 is .resources, the two files formats 
are, in fact, very different and are not interchangeable. 
Converting Resources 


When upgrading a Visual J++ project, the Visual J# Upgrade Wizard automatically converts the Visual J++ resource 
(.resources and .properties) files associated with the upgraded project into .NET Framework resource (.resx) files. When the 
project is later built in Visual J#, the .resx files are converted into NET Framework resource (.resources) files and embedded 
into the output of the project. 


Resources in file formats other than .resources or .properties (like .omp or .gif) are not automatically handled by the Upgrade 
Wizard. These resources need to be manually converted to .resx file format and added to the upgraded project. 


The following steps show how to manually convert Visual J++ 6.0 project resources into NET Framework resources. 


To manually convert resources 


1. Identify all resource files used in the Visual J++ project. 


2. Convert these resource files to NET Framework resource (.resx) files using the Vjsresgen.exe tool provided with the 
Visual J# samples. 


3. Add the .resx files generated to the upgraded project. 


4. To compile a project from the command prompt, convert the resource in .resx file format to the .resources file format 
using the .NET Framework tool Resource File Generator (Resgen.exe). This prepares the resources for embedding or 
linking into a managed assembly. 


5. Specify the Visual J# compiler /resource option to embed the resource into the managed assembly. If the application is 
only available in .class format, use the Visual J# Binary Converter Tool and specify the /linkresource option. 


Resource Compatibility Issues with Visual J++ 6.0 


In Visual J+ + 6.0 every resource is associated with a class. Resources associated with a class should be embedded or linked 
into the same assembly that the class is contained in. 


e In Visual J#, if the original Visual J++ resource file is modified, the INET Framework resource file needs to be re-created 
and added to the assembly again. 


e Dynamically generating and consuming resources is not supported. 


e Resource files attached using the /win32res compiler option cannot be accessed using the Class.getResource or 
Class.getResourceAsStream method. 


e Resources associated with a class should be embedded or linked into the same assembly that the class is contained in. If 
a single resource is shared among multiple classes, the resource must be embedded or linked into each of the assemblies 
the classes are built into. 


For more information on Visual J# compiler options used to embed or link resources into managed assemblies, see 
Visual J# Compiler Options. For more information on the Visual J# Binary Converter Tool (Jolmp.exe) options, see 
Visual J# Binary Converter Tool. 


For more information on Resgen.exe, see Resource File Generator (Resgen.exe). 
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Upgrading Projects Using Java-Language/COM Interoperability 


This section discusses how to compile, debug, and run Java-language/COM components developed with Visual J++® 6.0 in 
Visual J#. 


In This Section 
Overview: Upgrading Java-Language/COM Components 


Provides an overview of Visual J++ 6.0 projects using Java-Language/COM interoperability and how to upgrade them. 
Background: COM Interop in Visual J++ 6.0 

Describes accessing COM components from the Java language and accessing Java-language components from COM. 
Background: COM Interop on the Common Language Runtime 

Describes accessing COM components from managed code and accessing managed components from COM. 
Upgrading Visual J++ 6.0 Applications That Access COM Components 


Provides detailed steps and background information on how to compile and run in Visual J# a Visual J++ 6.0 application that 
accesses COM components. 


Upgrading Visual J+ + 6.0 Components Exposed to COM 


Provides detailed steps and background information on how to compile and run in Visual J# a Visual J++ 6.0 application that 
is accessed from COM components. 


Unsupported Scenarios in Visual J# 
Discusses Java-language/COM scenarios not supported in Visual J#. 
Known Issues and Workarounds 


Discusses workarounds for Java-language/COM scenarios. 


Related Sections 
Interoperating with Unmanaged Code 


Describes interoperability services provided by the common language runtime. 
Upgrading from Visual J++ 6.0 

Provides recommendations and procedures for upgrading Visual J++ 6.0 projects to Visual J#. 
COMCallsJava Sample 

Demonstrates upgrading Visual J+ +6.0 Java-language components exposed as COM DLLs. 
JavaCallsCOM Sample 

Demonstrates upgrading Visual J++ 6.0 Java-language/COM applications to Visual J#. 
Visual J# 


Provides links to various areas of the Visual J# documentation set. 
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Overview: Upgrading Java-Language/COM Components 


Visual J# supports interoperability between managed applications and COM components. This support includes the ability to 
compile and run existing Visual J++ 6.0 components as well as newer code written to use NET Framework interop semantics. 


Therefore, managed applications and COM components are able to access each other's services. Subsequently, developers can 
combine the Java-language syntax with COM's advantages and develop applications that interact with operating system 
components, applications, and services written in any COM-compliant language on any platform. 


For new applications, the recommended way to interoperate between COM components and managed code is to use the .NET 
Framework interop semantics provided by the common language runtime and tools. For more information about using the 
common language runtime semantics for COM interop, see Interoperating with Unmanaged Code. 


Visual J# supports compiling and running Visual J++ 6.0 Java-language/COM components. This includes: 


e Support for most of the Java-language/COM interop scenarios and features available in Visual J++ 6.0 and the 
Microsoft® SDK for Java. 


e Source compatibility for Visual J++ 6.0 Java-language/COM applications, allowing them to be compiled and run with 
little or no source code changes. This includes being able to compile and run wrappers generated by the JActivex™ tool 
in existing Visual J++ 6.0 applications and the @com directives found in these wrappers. 





Visual J# does not guarantee complete source compatibility to compile and run all existing Visual J++ 6.0 Java-language/CO 
M applications. See Unsupported Scenarios in Visual J# for more information. 
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Background: COM Interop in Visual J++ 6.0 


Visual J++ 6.0 supported two major usage scenarios in Java-language/COM interop. 


In This Section 
Accessing COM Components from the Java Language 


Describes how to use Java Callable Wrappers (JCWs) to access COM components from Java-language code. 
Accessing Java-Language Components from COM 


Describes Visual J++ 6.0 support for compiling and registering Java-language classes as COM components. 


Related Sections 
Upgrading Projects Using Java-Language/COM Interoperability 


Discusses the considerations while upgrading Visual J++ 6.0 projects that make use of Java-language/COM interoperability. 


Visual J# Concepts 


Accessing COM Components from the Java Language 


To access a COM component, run the JActiveX tool on a COM type library (.tlb file) or a COM DLL containing an embedded 
type library. The JActiveX tool, which ships with Visual J++ 6.0 and the Microsoft SDK for Java, generates wrappers for each 
coclass and COM interface in the type library. These wrappers, called Java Callable Wrappers (JCWs), are proxies for the actual 
COM objects and contain @com directives that are understood by the Java-language compiler (jvc.exe). You then import these 
wrappers into an application and compile the wrappers along with the application code. The @com directives in the wrappers 
are compiled into attributes in the .class files and are interpreted at run time by the Microsoft Java Virtual Machine (MSJVM). 


To create an instance of a COM object, call new on the appropriate wrapper. The object can then be cast to the interfaces and 
methods can be called on them. MSJVM uses the @com directives in the generated wrappers to do the following: 


e Locate and call CoCreatelInstance on the COM coclass. 
e Translate method calls on the wrapper to calls on the actual COM object. 
e Manage references to the COM object. 


e Marshal parameters between COM and the Java language. 


Java-language developers will use the COM object just as if they were using any other Java-language object, and without 
dealing with any of the details, as a typical COM developer would. 


You can also host ActiveX controls in the Java language. 


See Also 
Other Resources 
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Accessing Java-Language Components from COM 


Visual J++ 6.0 supports projects that compile their Java-language classes into COM DLLs or ActiveX controls (OCXs). These 
COM DLLs or ActiveX OCXs are registered and used from tools like Visual Basic 6.0 and Visual C++ 6.0. You could alternatively 
use command-line tools like VJReg and JavaReg, which ships with Visual J++ 6.0 and the Microsoft SDK for Java, to register 
Java-language classes that contain the @com.register attribute as COM or ActiveX controls so that Visual Basic 6.0 and Visual 
C++ 6.0 could access them. 


For more information about compiling and running Java-language/COM components, see the related documentation in the 
Visual J++ 6.0 documentation (MSDN) or the Microsoft SDK for Java. 


See Also 

Other Resources 

Background: COM Interop in Visual J++ 6.0 
http://www.microsoft.com/java/resource/java_com2.htm 
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Background: COM Interop on the Common Language Runtime 


You can access COM components from managed clients, and you can access a managed server from COM clients using the 
.NET Framework COM interop semantics. 


In This Section 
Accessing COM Components from Managed Code 


Describes how to use Runtime Callable Wrappers (RCWs) to access COM components from managed code. 
Accessing Managed Components from COM 


Describes how to use the Regasm.exe tool to register a managed DLL as a COM component. 


Related Sections 
Upgrading Projects Using Java-Language/COM Interoperability 


Discusses the considerations while upgrading Visual J++ 6.0 projects that make use of Java-language/COM interoperability. 
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How to: Access COM Components from Managed Code 





Note 





The dialog boxes and menu commands you see might differ from those described in Help depending on your active settings 
or edition. To change your settings, choose Import and Export Settings on the Tools menu. For more information, see 
Visual Studio Settings. 











Running the Type Library Importer tool (Tlbimp.exe) on a COM type library or a COM DLL containing an embedded type 
library generates managed wrappers for the COM component. The Tlbimp.exe tool ships with the .NET Framework SDK and 
with Visual Studio. These wrappers can then be referenced in any managed application that needs to access the classes in the 
COM DLL. 


The wrappers generated are called Runtime Callable Wrappers (RCWs) and are proxies for the actual COM objects. The RCWs 
contain certain .NET Framework interop attributes that are interpreted by the common language runtime to create instances of 
the actual COM objects at run time. 


To access COM components from managed code 


1. For the COM DLL that you want to access from your Visual J# application, generate managed wrappers from the COM 
type library, using Tlbimp.exe, as follows: 


tlbimp /out:FB.d1l My.tlb 


2. Reference the generated wrappers in your application. You can now access the COM components by calling new on the 
appropriate wrapper. When compiling your sources, reference the generated wrappers as follows: 


vjc /reference:FB.d1ll application_sources 


3. To create an instance of a COM object, use new on the appropriate managed wrapper for the coclass. You can then cast 
the object to an appropriate interface and call methods on it. The common language runtime uses the interop attributes 
contained in the wrappers to locate and call CoCreatelnstance on the COM coclass, translate method calls on the 
wrapper to calls on the actual COM object, manage references to the COM object, and marshal parameters on COM 
types to and from .NET Framework types. 


This support also includes being able to host ActiveX controls in Windows Forms. 
See Also 
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How to: Access Managed Components from COM 





Note 





The dialog boxes and menu commands you see might differ from those described in Help depending on your active settings 
or edition. To change your settings, choose Import and Export Settings on the Tools menu. For more information, see 
Visual Studio Settings. 











The Assembly Registration tool (Regasm.exe) can be used to register a managed DLL as a COM component; and thus, allow 
such tools as Visual Basic and Visual C++ to access the managed component as a COM DLL or ActiveX control. Additionally, 
the Type Library Exporter tool (Tlbexp.exe) or the /tlb option in Regasm can be used to generate a type library for the managed 
component. These tools ship with the .NET Framework SDK and with Visual Studio. 


Basic steps to access managed components from COM 


1. Use the INET Framework tool Regasm.exe to register your component as a COM server: 





| 
Regasm /tlb:mytlb.tlb /codebase managedobj.d11l 
2. The managed class being registered as a COM component is now accessible from unmanaged clients. 


For more information about COM interop using .NET Framework semantics, see Interoperating with Unmanaged Code. 


See Also 
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Upgrading Visual J++ 6.0 Applications That Access COM 
Components 


You can compile and run a Visual J++ 6.0 Java-language/COM application that accesses COM components in Visual J#. 


In This Section 
How to: Upgrade Visual J++ Applications That Access COM Components 


Provides the steps for upgrading a Visual J++ 6.0 application that accesses COM components to Visual J#. 
Design Overview: Accessing COM Components 


Discusses the design features that allow upgrades of Visual J++ 6.0 applications that access COM components to run in the 
.NET Framework. 


Handling the Threading Model of COM Components 


Describes differences between how the threading model for COM objects is handled by the Microsoft Java Virtual Machine 
(MSVJM) and by the .NET Framework common language runtime. 


Related Sections 
Upgrading Projects Using Java-Language/COM Interoperability 


Discusses the considerations while upgrading Visual J++ 6.0 projects that make use of Java-language/COM interoperability. 


How to: Upgrade Visual J++ Applications That Access COM 
Components 


The following steps show how to manually upgrade a Java-language/COM component from the command prompt. When 
upgrading Visual J++ projects in Visual Studio, the Visual J# Upgrade Wizard automates many of these steps. 


To upgrade Visual J++ applications to Visual J# 


1. Generate managed wrappers for the type library of the COM component using the Tlbimp.exe tool. Usually, this is done 
as follows: 


tlbimp.exe /out:managed_WrapperDLL COMComponent.tlb 


2. Compile the Java-language application along with the JActiveX wrappers, referencing the managed wrapper generated 
by Tlbimp. Use the Visual J# compiler, vjc.exe, to do this. Usually, this is done as follows: 


vjc ApplicationSources JActiveXWrapperSources /r:managed_WrapperDLL 


3. Run the generated .exe file to run the application. 


4. The application can be debugged using the debugging tools available in the .NET Framework, CorDbg.exe or DbgClr.exe, 
or by using the Visual Studio debugger. For more information about these tools, see 
Interoperating with Unmanaged Code and Debugging. 


Managed wrappers generated by Tlbimp are not compatible with JActiveX wrappers. Therefore, any plans to discard the 
JActiveX wrappers and directly import the managed wrappers into the application would mean major source code 
changes in the application. For example, the methods on the Tlbimp-generated managed wrappers accept .NET 
Framework types as parameters and return values, while the methods on the wrappers generated by the JActiveX tool 
accept Java-language types as method parameters and return values. Other differences between these wrappers include 
how properties and events are exposed, how error HRESULTs are reported, and the interfaces the wrappers implement. 


When upgrading Visual J++ 6.0 Java-language/COM applications to Visual J#, manually editing the JActivex generated 
wrappers to add .NET Framework COM interop attributes or APIs can lead to unexpected run-time issues. Mixing such 
attributes in Visual J++ 6.0 as @com and @dll with NET Framework COM interop attributes is not supported and is 
strongly discouraged in both upgraded Visual J++ 6.0 Java-language/COM applications as well as new applications 
written with Visual J#. 


See Also 
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Design Overview: COM Component Accessing 


As the fundamental goals were to maintain source compatibility and use the interop support provided by the common 
language runtime, Visual J++ 6.0 Java-language/COM components are compiled and run in Visual J# using both the JActivex 
wrappers and the Tlbimp-generated managed wrappers. 


To upgrade the Visual J++ 6.0 application, compile it and the JActiveX-generated wrappers using vjc.exe, referencing the 
managed wrapper assemblies generated by Tlbimp. The Visual J# compiler (vjc.exe) is a @com-aware compiler. At compile 
time vjc.exe generates an implementation of the JActiveX wrappers that use the Tlbimp-generated managed wrappers. The 
compiler emits code such that each JActiveX wrapper connects to the corresponding managed wrapper and holds a reference 
to it. Whenever a new instance of the JActiveX wrapperis created, a new instance of the corresponding managed wrapper is 
also created. This in turn will trigger the creation of the COM coclass, which is done by the .NET Framework interop 
infrastructure. 


Members of the JActiveX wrappers are mapped to the members of the managed wrappers. Therefore every method invocation 
on the JActiveX wrapper causes the method on the managed wrapper to be invoked. The common language runtime will then 
invoke the corresponding method on the COM coclass. This mapping is done at compile time using the @com attributes in the 
JActiveX wrappers. 


The JActiveX wrapper implementations are also used to seamlessly hide the differences between the two wrappers. The 
JActiveX wrapper implementation marshals Java-language types to .NET Framework types before calling methods on the 
managed wrappers. The runtime will then marshal them to the appropriate COM types. The reverse is also done for method 
return values. Therefore, these applications continue to use the JActiveX-generated wrappers but now use the common 
language runtime support to create instances of the COM objects and call methods on them. 


The benefit of this approach is that the application can continue to use the JActiveX-generated wrappers in its code. 


Java-Language/COM Component After Upgrade to Visual J# 


COM objects continue to be exposed as objects that inherit the same com.ms.* classes and interfaces as in Visual J++ 6.0. To 
the application, these wrappers have the same layout and run-time characteristics as in Visual J++ 6.0. Casting to COM 
interfaces and calling methods on the interfaces work as in Visual J++ 6.0. 


Java-language types passed to COM methods are marshaled to appropriate COM types, and COM method return values are 
marshaled to the appropriate Java-language types. The mapping between the two types is similar to that in Visual J++ 6.0 and 
includes interfaces such as IUnknown and IDispatch and data types such as VARIANTs, SAFEARRAYs, structs, enums, and 
user-defined classes and interfaces. 


The JActiveX wrapper throws a com.ms.com.ComFailException for error HRESULTs returned by COM methods. 
Semantics to sink COM events and access properties remain unchanged. 


Java-language objects can implement COM interfaces. When such an object is passed to COM, invoking QueryInterface on 
the object for that interface would return the correct pointer. 


See Also 
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Handling the Threading Model of COM Components 


While running Visual J++ 6.0 Java-language/COM components in Visual J#, be aware of some of the differences between how 
the threading model for COM objects is handled by the Microsoft Java Virtual Machine (MSJVM) and by the .NET Framework 
common language runtime. Because the COM interop support in Visual J# is layered on .NET Framework COM interop, these 
issues affect Visual J# Java-language/COM applications. 


e Marshaling of COM Interfaces Across Apartment Boundaries 
e@ Handling Messages Sent to STA Objects 


See Also 
Other Resources 
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Marshaling of COM Interfaces Across Apartment Boundaries 


COM interfaces that cannot be marshaled across apartment boundaries in a pure COM-calling-COM scenario cannot be 
marshaled on the common language runtime across threads with incompatible apartment models. That is, if any COM 
interface is not marshalable across apartment boundaries, the methods on the corresponding JActiveX wrapper for that 
interface cannot be called from a thread in an incompatible apartment model. 





Note 





This scenario is supported on the Microsoft Java Virtual Machine (MSJVM) but is not supported on the common language ru 
ntime. MSJVM allows COM interfaces to be called from threads in incompatible apartment models and handles marshaling o 
f the interface pointers, transparent to the Java-language developer. 











By default, all threads in the common language runtime (and therefore for Visual J++ 6.0 applications upgraded to Visual J#) 
belong to the multithreaded apartment (MTA). In other words, managed threads are by default initialized to support 
multithreaded objects only, leaving synchronization and marshaling concerns up to the developer. 


Therefore, this issue becomes prominent when upgrading Visual J++ 6.0 applications that host single-threaded apartment 
(STA) COM objects. In such applications, an attempt to call the methods of any pure |Unknown (vtable) interface implemented 
by the COM object will result in an exception being thrown. Pure [Unknown interfaces by themselves cannot be marshaled 
across apartments. As all threads belong to the MTA by default, a call on these interfaces will therefore result in the 
com.ms.com.ComFailException. The solution to this issue is to make the COM interface marshalable across apartments, 
perhaps in one of the following ways: 


e Generate and register a proxy/stub DLL from the IDL file of the COM component. This can be done using the MIDL tool. 


e Make the interfaces dual or dispatch, and then register the type library to enable COM for type-library—based marshaling. 
This is possible only when the types used in the interfaces are automation compatible. For more information about 
marshaling COM interfaces across apartment boundaries, see the MSDN documentation. 


e Make the apartment model of the managed thread hosting the COM object compatible with the threading model of that 
object. As all threads are MTA by default, an STA COM object can be hosted by setting the apartment model of the thread 
to STA. This can be done in two ways: 


e Specify the /** @attribute System.STAThread () */ attribute on the entry point function main. This will make 
the main thread of the application an STA thread. For example: 





/** @attribute System.STAThread () */ 
public static void main(String args[]) 


{ 


new STACOMObject(); 
} 


e Call the ApartmentState property on the INET Framework class Thread to make it an STA. This can only be done 
before any calls to COM components are made. See ApartmentState for more information. 


System. Threading. Thread.get_CurrentThread().set_ApartmentState(System. Threading.A 
partmentState.STA) 


Note 


This workaround is specifically required when upgrading WFC applications that host ActiveX controls from Visual J++ t 
o Visual J#. In such cases, you must add the /** @attribute System.STAThreadAttribute() */ attribute to the entry 
point function main if the main thread is hosting the ActiveX control or use the ApartmentState property if any other t 
hread hosts the ActiveX control. 











See Also 
Reference 
Handling the Threading Model of COM Components 


Visual J# Concepts 


Handling Messages Sent to STA Objects 


If a single-threaded apartment (STA) thread hosting an STA COM object blocks, the common language runtime typically 
performs implicit pumping on behalf of the COM object. However, there are certain conditions under which the common 
language runtime will not perform this implicit pumping: 


e If the thread blocked on a call to Thread.Sleep. 


e If the thread crossed the managed-native boundary through either platform invoke or J/Direct and was blocked while in 
native code. 


In such cases, no messages will be delivered to the STA COM object. 


The solution to this issue is to implement an explicit message pump for that thread, using the classes in the com.ms.win32 
package, as shown in the following example: 


com.ms.win32.MSG msg = new com.ms.win32.MSG(); 
while (com.ms.win32.User32.GetMessage(msg, @, 0, @)) 
{ 
com.ms.win32.User32.TranslateMessage(msg) ; 
com.ms.win32.User32.DispatchMessage(msg) ; 


See Also 
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How to: Upgrade Visual J++ 6.0 Components Exposed to COM 





Note 





The dialog boxes and menu commands you see might differ from those described in Help depending on your active settings 
or edition. To change your settings, choose Import and Export Settings on the Tools menu. For more information, see 
Visual Studio Settings. 











You can compile and run a Visual J++ 6.0 Java-language/COM component that is accessed from COM clients. The steps below 
show how to manually upgrade a Java-language/COM component from the command prompt. When upgrading Visual J++ 
projects in Visual Studio, the Visual J# Upgrade Wizard automates many of these steps. 


To upgrade to Visual J# 


1. If the Java-language/COM component was implemented using the templates generated by the JActiveX tool (using the 
/¢2j option) or your Java-language component implements a type library interface, you need to do the following before 
step 2: 


Use the Tlbimp.exe tool, which ships with the .NET Framework and Visual Studio, to generate managed wrappers from 
the type library that was used to generate the JActiveX templates. For example: 


tlbimp.exe /keyfile:interopKey.snk COMComponent.tlb 





Notice that the managed assembly emitted is signed with a key pair generated by the NET Framework tool sn.exe. This 
avoids the "assembly is not strongly signed" warning when running Regasm. 


It is assumed that a type library exists for the Java-language component. When creating COM DLL or Control projects, 
Visual J++ 6.0 automatically creates type libraries for the Java-language component exposed to COM. A type library for 
the Java-language class can also be created using the VJReg.exe tool or JavaReg.exe tool, which ships with Visual J++ 6.0 
and the Microsoft SDK for Java, if a type library does not already exist. 


2. Compile the Java-language/COM component with the Visual J# compiler (vjc.exe). For example: 


vjc /target:library JavaSources 


Note 


If the Java-language/COM component was implemented using the templates generated by the JActiveX tool (using the 
/¢2j option) or your Java-language component implements a type library interface, then you need to reference the ma 


naged wrapper assemblies generated in the previous step when compiling the Java-language/COM component: vic 
/c:TlbimpGeneratedWrappers JavaSources 








You need to sign the assembly to be able to register it in the next step using the /codebase option in 

Assembly Registration Tool (Regasm.exe). To sign an assembly, attach the AssemblyKeyFile attribute found in the 
System.Reflection namespace to one of the files in your project. For example, /** @assembly 
System.Reflection.AssemblyKeyFile ("myKey.snk") */, where myKey.snk is a key pair file generated by the .NET 
Framework tool sn.exe. 


If the Java-language/COM component was accessed by COM clients using the type library generated by the VJReg.exe 
tool, the COM client would use the dispinterface exposed on the component and would have cached the Displds of the 
members. The Displds of the class members are not guaranteed to be the same on Visual J#. This may cause existing 
COM clients to fail. To avoid this, if a type library exists for the Java-language/COM component, ensure that the type 
library is registered on the computer and the GUID of the type library is specified using the typelib parameter in the 
@com. register directive, if it was not already found, for the component. The Visual J# compiler (vjc.exe) will issue the 
warning VJS1553 in such cases. For more information, see Compiler Warning (level 2) VJS1553. 


3. Register the generated DLL or EXE using the Regasm.exe tool, which ships in the .NET Framework and Visual Studio. For 
example: 








Regasm /codebase generated_DLL_or_EXE 





When upgrading Visual J++ 6.0 Java-language/COM applications to Visual J#, manually editing the JActiveX generated 
wrappers to add .NET Framework COM interop attributes or APIs can lead to unexpected runtime issues. Mixing such 
attributes in Visual J++ 6.0 as @com and @dll with NET Framework COM interop attributes is not supported and is 


strongly discouraged in both upgraded Visual J+ + 6.0 Java-language/COM applications as well as new applications 
written with Visual J#. 


See Also 
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Design Overview: Access by a COM Component 


To upgrade the Visual J++ 6.0 application, compile it using the Visual J# compiler (vjc.exe). At compile time, vjc.exe creates an 
equivalent wrapper class that has the same public methods, properties, and fields that a Java-language class exposed to COM 
had in Visual J++ 6.0. The difference is that the wrapper class methods take the equivalent .NET Framework types as 
parameters and return values. The wrapper is marked as ComVisible (true). When you run the Regasm.exe tool on the emitted 
DLL, the wrapper class is registered with the CLSID specified in the @com.register attribute of the Java-language class, not the 
actual Java-language class itself. 


COM clients interact directly with the wrapper generated by vjc.exe rather than the Java-language object. The methods are 
accessible using scripts or by COM clients that use the IDispatch interface to invoke methods. The structure of the wrapper 
and the type library generated for this class are similar to what COM clients expect from Java-language objects in Visual J++ 
6.0. 


The wrapper internally creates instances of the Java-language object, maps its methods to those on the Java-language object, 
and handles all differences between the Java-language class and the actual exposed wrapper class, including marshaling of 


types. 
The benefit of this approach is that the COM application is unaware that the Java-language component is now running on the 


common language runtime, rather than on the Microsoft Java Virtual Machine (MSJVM). The COM client view of the Java- 
language object remains unchanged. 


Java-Language/COM Component After Upgrade to Visual J# 


COM types are marshaled to appropriate Java-language types, and Java-language method return values are marshaled to 
COM types. The mapping between the two types is similar to that in Visual J++ 6.0. This includes interfaces such as Unknown 
and IDispatch and data types such as VARIANTs, SAFEARRAYs, structs, enums, and user-defined classes and interfaces. 


The appropriate HRESULTs are returned to the COM client when Java-language exceptions are thrown. The mapping between 
the exceptions and HRESULTs should be the same as in Visual J++. 


See Also 
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Unsupported Scenarios in Visual J# 


This section discusses unsupported scenarios in the following areas: 
e Java Language Calling COM 
@ COM Calling the Java Language 


See Also 
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Java Language Calling COM 


This section discusses unsupported scenarios in the following areas: 
e Support for JActivex Options 
e Partial Support for @com Directives 
e Threading Model Issues 
e@ Hosting ActiveX Controls in the Java Language 


See Also 
Reference 
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Support for JActiveX Options 


Wrappers created using the Add COM Wrapper wizard in Visual J++ 6.0 are generated with the following options of JActivex: 





/wfc /w /xi /X:rkc /1 FileName.tmp /nologo /d ProjectName COMDLLNAME.d11 











These wrappers will compile in the Visual J# compiler (vjc.exe). The following table shows JActiveX options that are not 
supported. 


Translation 























JActiveX option Description Result 

/bx+ Expose ActiveX controls as a Java Bean. Compile error 
/X:m- Disable auto-marshaling. Ignored 

/Xs2 Represent unsigned 2-byte integers as ‘char’. Ignored 

/XMi Represent void pointers as ‘int’. Ignored 

Output 

JActiveX option Description Result 

/ci:as Create Eventinfo entries for all source interfaces (WFC only). Compile error 





Miscellaneous 





























JActiveX option |Description Result 

/t jnffile Specify JNF file (Java-type-library information file) for custom settings (default is none). Compile error 
Javatlb 

JActiveX option Description Result 

/x2 Represent all 2-byte integers as ‘char’. Ignored 

/xh Do not map S_FALSE to ComSuccessException. Ignored 

/n jnffile Specify JNF file for custom marshaling (default is none). Compile error 
/G3.1 Target 3.1 Microsoft Virtual Machine for Java (default is /G4). Ignored 

/G4 Target 4.0 Microsoft Virtual Machine for Java (default is /G4). 











The values in the table's Result column are defined as follows: 
Compile error 

The wrappers generated might not compile in vjc.exe. 
Ignored 


The wrappers generated will compile, but code in these wrappers specific to these options is ignored. At run time, this might 
lead to marshaling and threading-model incompatibility issues with respect to Visual J++ 6.0. 


The Visual J# compiler might not compile wrappers emitted by older versions of tools released prior to JActivex. 


The JActiveX tool does not ship with Visual J#. The JActiveX tool ships in Visual J++ 6.0 and the Microsoft SDK for Java. For 
more information on JActivex, see the Visual J++ 6.0 documentation (MSDN) or the documentation in the Microsoft SDK for 
Java. 


See Also 
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Partial Support for @com Directives 


The following table shows which attributes in the supported @com directives are ignored. 


@com directiv 
es 


Ignored attributes 





@com.class 


DynamicCasts 





@com.interfac 
e 


@com.method 


@com.paramet 
ers 


@com.structm 
ap 


Thread 


addFlagsVtable 


customMarshalFlags, thread,type = CUSTOM | CUSTOMBYREF | CUSTOMBYVAL, customMarshal, siz 
e, byref, and array 


customMarshalFlags, customMarshal, addFlags, thread 





@com.struct 


safe, safeAddFlags 





@com.register 


typelib, version, description 














Wrappers containing some of the above directives or attributes will compile, but run-time incompatibility issues might arise 


with respect to Vi 


sual J++ 6.0, especially in marshaling and threading. 


As the customMarshalFlags, customMarshal, and type = CUSTOM | CUSTOMBYREF | CUSTOMBYVAL parameters to the 
@com.parameters and @com.structmap directives are not supported, Visual J# does not support custom marshaling. The 


Visual J# compile 


r cannot compile JActiveX-generated wrappers containing directives that have these parameters. 


If the JTLBATTR_IID_IS and JTLBATTR_SIZE_IS macros are used in the IDL file of the COM component to propagate iid_is and 
size_is information to the type library, the JActiveX-generated wrappers contain directives that use the type = CUSTOM and 


customMarshal 


parameters. Therefore, such wrappers cannot be compiled by the Visual J# compiler. For more information 


on JTLBATTR_IID_IS and JTLBATTR_SIZE_IS, refer to the documentation in Visual J++ 6.0 or in the Microsoft SDK for Java. 


See Also 
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Threading Model Issues 


When running Visual J++ 6.0 COM components in Visual J#, there are known threading-model incompatibility issues. For 
more information, see Handling the Threading Model of COM Components. 


See Also 
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Hosting ActiveX Controls in the Java Language 


Only JActiveX wrappers generated for ActiveX controls using the /wfc option are supported. This is the default option used 
when ActiveX controls are dragged and dropped onto a WFC Form in the Visual J++ 6.0 forms designer. 


See Also 
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COM Calling the Java Language 


The following are unsupported: 


e Incompatibilities with Visual J++ 6.0 exist in the set of interfaces exposed by COM Callable Wrappers (CCWs) of the Java- 
language components. In Visual J#, the following interfaces are not exposed by the CCWs: 


e |ProvideClassinfo2 and IExternalConnection 


e [Persist, IPersistStreamInit, and IPersistStorage (exposed in the MSJVM when a class implements 
java.io.Serializable or java.io.Externalizable) 


e Marker interfaces on the class like com.ms.com.NoAutoMarshaling and com.ms.com.NoAutoScripting are ignored. 
Visual J++ applications that depend on the functionality provided by these interfaces may need to be appropriately 
modified during upgrade. For more information, see Issues and Workarounds: Java Language Calling COM. 


© There is currently no support to sink events fired by Java-language/COM classes in COM clients. 
e There is no marshaling support for VARIANTs of type VT_BYREF. 
In Java-language objects exposed to COM, the following @com directives are ignored by the Visual J# compiler (vjc.exe): 


e @com.transaction 

e @com.typeinfo 
Exposing WFC controls or Java Beans as ActiveX controls is not supported in Visual J#. 
There is no support for Java-language monikers in Visual J#. 


See Also 
Reference 
Unsupported Scenarios in Visual J# 
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Known Issues and Workarounds 


This section discusses workarounds for known issues related to upgrading: 
e Issues and Workarounds: Java Language Calling COM 
e Issues and Workarounds: COM Calling the Java Language 
e Upgrading Java-Language/COM Components That Use Custom Marshaling 


See Also 

Reference 

Unsupported Scenarios in Visual J# 

Other Resources 

Upgrading Projects Using Java-Language/COM Interoperability 
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Issues and Workarounds: Java Language Calling COM 


This topic discusses how to resolve issues you may encounter when calling into a COM component from a Visual J# client. 


e If the package name of the JActiveX wrappers is same as the name of the namespace under which the managed 
wrappers are generated, you will get a compiler error. 


To resolve, use the /namespace option while generating managed wrappers using the Tlbimp.exe tool. For more 
information about Tlbimp options, see Interoperating with Unmanaged Code and Type Library Importer (Tlbimp.exe). 


e In cases where the Java-language application references two or more COM DLLs that have COM interfaces or coclasses 
with the same names and GUIDs, it might be necessary to explicitly resolve the name clash using the vjc.exe /jcpa option. 
Java-language interfaces (those not marked with @com directives) can be marshaled to COM only if the COM side 
expects an IDispatch-derived interface. In other cases, such interfaces cannot be marshaled. Currently, marshaling is 
fully supported only for COM interfaces that were generated from JActivex. 


e Marker interfaces in the JActiveX wrappers like com.ms.com.NoAutoMarshaling and com.ms.com.NoAutoScripting 
are ignored. Visual J++ applications that depend on the functionality provided by these interfaces may need to be 
appropriately modified during upgrade, for the following reasons. 


When implemented by a class, the com.ms.com.NoAutoScripting interface prevents the Microsoft Java Virtual 
Machine (MSJVM) from exposing an IDispatch implementation in the COM Callable Wrapper of the class. This could be 
used to prevent instances of this class from being called by such scripting engines as VBScript or Visual Basic. As Visual 
J# does not support this interface, the COM Callable Wrappers of classes implementing this interface will now expose an 
IDispatch implementation after the upgrade. 


As for the com.ms.com.NoAutoMarshaling interface, it prevents the MSJVM from exposing the free-threaded 
marshaler in the COM Callable Wrapper of the class. This could be used when creating COM local servers where the 
Java-language/COM object must be placed in a particular apartment. As Visual J# does not support this interface, the 
COM Callable Wrappers of classes implementing this interface will now expose the free-threaded marshaler after the 
upgrade. 


e Currently, non-failing HRESULTs like S_FALSE are always treated as S_OK and no exceptions of type 
com.ms.com.ComSuccessException are thrown. 


e There is no support for marshaling of arrays. In the current release of Visual J#, only the first element of the array is 
marshaled from the Java-language class to the COM client or vice versa. 


e JActiveX wrappers that have been edited by the developer before compilation might not compile in vjc.exe. If compilation 
succeeds, there is still a possibility of incompatibility issues at run time. 


e If the accessor method of a COM property on a dispinterface does not return anything, then trying to read the value of 
that property from the Java-language client will result in a ComFailException. The workaround is to always return some 
value from the COM server. 


e Visual J# does not support the following scenarios: 
e@ Marshaling of multi-dimensional safe arrays as parameters to COM methods. This will result in run-time failures. 


e Marshaling of parameters of type STRUCT** where STRUCT is a COM structure defined in the type library. In this 
case, Visual J# gives compile-time errors. 


e Astack trace during debugging might not be the same as it was in Visual J++ 6.0, because the Java-language/COM 
interop support in Visual J# is layered on top of NET Framework COM interop. 


See Also 
Reference 
Known Issues and Workarounds 
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Issues and Workarounds: COM Calling the Java Language 


This topic discusses how to resolve issues you may encounter when calling into a Visual J# component from a COM client. 


e When trying to register a Visual J++ 6.0 Java-language class that is not marked with the @com.register directive (for 
example, a class that was registered using the JavaReg.exe tool with the /clsid option), a CLSID is automatically 
generated for that class. This might cause existing COM clients to break. In such cases, you will need to attach the 
@com.register attribute to the class and specify the CLSID the client expects. 


e In Visual J++ 6.0, any generic Java-language object could be passed to COM as a parameter to a method. COM clients 
can access methods of that object using IDispatch or the specific COM interfaces that it implements. 


In Visual J#, a generic Java-language object cannot be marshaled in this fashion to COM. The object is callable from COM 
only in one of the following scenarios: 


e Itis an @com.register attributed class. 
e It implements a COM interface generated using the JActiveX tool or com.ms.com interfaces. 


If an object does not meet these conditions, it is still callable from COM but it may result in unexpected behavior at 
runtime. 


This restriction does not apply if you are writing new code that uses .NET Framework COM interop semantics and uses 
only .NET Framework types. 


e When upgrading Visual J++ 6.0 Java-language/COM components that were not built using JActivexX template classes 
(/¢2j) or do not implement interfaces generated by the JActiveX tool, you must ensure that a type library exists for the 
component being upgraded and that the type library has been registered on the machine. Otherwise, the Visual J# 
compiler will emit warning VJS1553. 


The workaround is to perform one of the following before starting the upgrade to Visual J#: 


e Using the vjreg.exe tool that ships in Visual J++ 6.0, generate and register a type library for the Java-language 
component being exposed to COM, as follows: 


vjreg /typelib SomeTypeLib.tlb JavaComponent.class 


-or- 


If a type library for the component also exists on the machine but is not registered, use the following: 


vjreg /regtypelib SomeTypeLib.tlb JavaComponent.class 


e Managed Java-language components registered and exposed to COM cannot coexist with their Visual J++ 6.0 
counterparts on the same computer. When a managed Java-language class is registered as a COM server, it is registered 
with the same GUID used by the class in Visual J++ 6.0. Therefore, the coclass entries are overwritten with the 
InProcServer32 as mscoree.dll, rather than msjava.dll. Subsequently, the class can no longer be used with Visual J++ 6.0. 
Developers who want to host the Java-language class in COM using both Visual J++ 6.0 and Visual J# will be unable to 
do so unless they use the tools in Visual J++ 6.0 or the Microsoft SDK for Java to reregister the .class file. 


e Currently, public fields or methods that follow the getXXX/setXXX naming pattern in Java-language components are not 
exposed to COM clients as properties. 


e If the Java-language class implements a COM interface, only the methods belonging to the COM interface can be 
accessed using the IDispatch interface from COM. The other public methods of the class that do not belong to the 
implemented COM interface are not visible to COM. If the Java-language class does not implement any COM interfaces, 
then all its public methods are accessible from COM using IDispatch (that is, late-bound scenarios such as scripts). 


See Also 
Reference 
Known Issues and Workarounds 
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Upgrading Java-Language/COM Components That Use Custom 
Marshaling 


Visual J++ 6.0 allows developers to custom marshal method parameters and structures during Java-language/COM interop. 
When the /t jnffile or the /n jnffile option is used when running the JActiveX tool on a type library, the wrappers generated 
contain additional information required for custom marshaling. The ,jnf file used with the /t or /n option specifies the custom 
marshaler class that must be used to marshal a specific Java-language type to the corresponding native type. Additional 
information on custom marshaling in Visual J++ 6.0 can be found in the documentation for Microsoft Visual J++ 6.0 or the 
Microsoft SDK for Java. 


Microsoft Visual J# does not currently support custom marshaling. Attempting to compile JActiveX wrappers that use custom 
marshalers to marshal Java-language types to native types results in a compile-time error. 


The common language runtime provides native support for COM interop and custom marshaling. Users can specify a custom 
marshaler class that can be used to custom marshal managed types to their corresponding native representations and vice 
versa. For additional information on custom marshaling on the common language runtime, see Custom Marshaling. 


When upgrading Java-language/COM applications that use custom marshaling, a possible upgrade path is to rewrite the 
component to directly use the managed wrappers generated by the Tlbimp.exe tool rather than use the JActiveX wrappers. The 
common language runtime allows developers to specify custom marshaling classes that marshal method arguments during 
COM interop. By writing such a custom marshaler, you can marshal a managed type written in Java-language to its native 
representation. 


See Also 
Reference 
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Upgrading Applications That Dynamically Load Classes 


This section discusses the following issues: 
e No Support for CLASSPATH Variable 
e Compile-Time Binding 
e Runtime Binding: Class.forName Semantics 


See Also 
Other Resources 
Class Library Support 


Visual J# Concepts 


No Support for CLASSPATH Variable 


Visual J# does not support the CLASSPATH environment variable. This affects: 
e The way applications locate and load classes bound to the application, both at compile time and at run time. 
e The way in which resource files are located and loaded by applications. 


See Also 
Reference 
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Compile-Time Binding 


For classes bound to an application at compile time, the application's metadata includes references to the assemblies that 
contain these classes. At run time, when these classes are referenced, the corresponding assemblies are located and loaded by 
the common language runtime using its assembly loading heuristics. 


For information about how the common language runtime locates and loads assemblies, see 
How the Runtime Locates Assemblies. 


See Also 
Reference 
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Runtime Binding: Class.forName Semantics 


Classes loaded using the Class.forName API are dynamically bound to the application at run time. 


The Class.forName(String className) method does not use the CLASSPATH environment variable to locate classes. Instead, 
a search for classes is conducted in the following locations, in order: 


1. The calling assembly 

2. All assemblies currently loaded into the current application's AppDomain 

3. Assemblies specified in the <CODEBASE> tag of the application configuration (.config) file 
4. The ApplicationBase of the application 


5. All managed DLLs found in the directories specified by the <PROBING> tag of the application configuration file 


The search terminates if the class is found at a particular step. If no configuration file is found, or if errors are encountered in 
parsing the configuration file, steps 3 and 5 are skipped. If the class is not found in any of the steps, 
ClassNotFoundException is thrown. 


Visual J# also provides an additional method in the class java.lang.Class for locating and loading classes from an assembly, as 
follows: 


Class.forName(String assemblyName, String className, boolean absolutePath) 
| 


This method searches for the class specified by the className parameter in the assembly specified by the assemblyName 
parameter. The assemblyName parameter should specify the display name of the assembly (see AssemblyName Class for 
more information). If the Boolean parameter absolutePath is True, then assemblyName represents an absolute path that 
specifies the location of the assembly. If absolutePath is False, then it is assumed that no path has been specified and the 
common language runtime assembly search heuristics are used to locate and load the assembly. If the class is not found in the 
specified assembly or the specified assembly could not be found, ClassNotFoundException is thrown. 


For more information, see Global Assembly Cache, Assemblies, Application Domains, and 
How the Runtime Locates Assemblies. 


See Also 
Reference 
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Upgrading Applications That Use Custom Class Loaders 


There is no ClassLoader support for converting bytecode into a Class object. 


The following methods are not supported: 


e ClassLoader.defineClass 


e ClassLoader.resolveClass 


These methods throw com.ms.vjsharp.MethodNotSupportedException in Visual J#. 


Custom class loaders extend java.lang.ClassLoader and override the loadClass method for their specific implementation. If 
these loadClass implementations call either or both of the above two ClassLoader methods, they need to be modified to load 
managed assemblies and then look for the specified classes therein. 


As ClassLoader.defineClass and ClassLoader.resolveClass are no longer supported, Class.getClassLoader always returns 
null, even when using a custom class loader. 


Custom class loaders are not recommended for developers using Visual J#. Instead, use NET Framework APIs for locating and 
loading classes from Microsoft intermediate language (MSIL) assemblies. 


See Also 
Reference 
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Upgrading Applications That Use the Visual J++ 6.0 Security 
Semantics 


Applications written in Visual J# follow the security semantics of the NET Framework and common language runtime. This 
applies to both new applications written in Visual J# that target the .NET Framework libraries, as well as Visual J++ 6.0 
applications that have been upgraded using Visual J#. 


Custom Security Managers in Visual J# Applications 


Visual J# does not support custom security managers. Therefore, the following methods in the java.lang.System and 
java.lang.SecurityManager classes are not supported and throw the com.ms.vjsharp.MethodNotSupportedException 
exception: 


e System.setSecurityManager 

e SecurityManager.classDepth 

e SecurityManager.classLoaderDepth 
e SecurityManager.currentClassLoader 
e SecurityManager.currentLoadedClass 
e SecurityManager.getClassContext 

e SecurityManager.inClass 

e SecurityManager.inClassLoader 


e The System.getSecurityManager method will always return null. 


When upgrading an existing Visual J++ 6.0 application that implements a custom security manager and uses the methods 
listed above to help implement a security policy, the application must be modified to use the security semantics and classes 
provided by the .NET Framework. 


This usually means using the equivalent APIs in the System.Security namespace and modifying the .NET Framework security 
policy on the machine to help enforce the required restrictions. 


Accessing Classes in the JDK level 1.1.4, WFC, and Other com.ms.* Packages 


In Visual J#, only fully trusted applications can access the classes in the JDK level 1.1.4, WFC, and com.ms.* packages. This 
means that only applications that run in the My Computer code group or a code group to which the .NET Framework security 
policy has granted the FullTrust permission set, can access these classes. Attempting to access these classes from a partially 
trusted caller will result in a security exception. 


However, Visual J# only checks the immediate callers of these classes. Therefore, developers will still be able to build fully 
trusted but secure libraries and expose them to partially trusted code. Developers of such libraries must make sure that their 
libraries are fully secure and does not leave the machine vulnerable to exploits. 


The JDK level 1.1.4 classes in Visual J# are designed to demand for appropriate NET Framework permissions before 
performing sensitive operations. Therefore, fully trusted callers of these classes will be able to fully enforce the semantics of 
Deny and PermitOnly. Also, when second level callers (potentially malicious) call these trusted callers, some level of protection 
is afforded by these demands (in that these second level callers will not be able to perform operations for which they do not 
have permissions). 


However, unlike the JDK level 1.1.4 classes, the classes in the WFC and com.ms.* packages do not perform any demands for 
.NET Framework permissions. Therefore, fully trusted callers of these callers will not be able to implement the semantics of 
Deny and PermitOnly. (Certain classes like file |/O will do a full stack walk for unrestricted permission set and are an exception). 


See Also 

Reference 

Upgrading Applications That Use Third-Party Security Providers 
Other Resources 

Class Library Support 
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Upgrading Applications That Use Third-Party Security 
Providers 


Visual J# allows users to add third-party security providers that then can be used for operations such as generating keys and 
signatures. Users can specify, through a security configuration file, the security providers installed in the system and the order 
in which the providers are to be searched for an algorithm implementation. 


See the SecurityProviders Sample for an example of how to use a security configuration file. 


Visual J# users can use the configuration file, vjsharp.config, in the %windir%\Microsoft.NET\Framework\v<%version%> 
directory to specify these settings. This is an XML file, and all of the security settings are specified under the <security> tag of 
this file. The typical format of this file is as follows: 


<vjsharpconfiguration> 
<security> 
<packageinfo> 
<description>Description of the package</description> 
<loadinfo class="packageName.className, assemblyName, Version=assemblyVersion, 
Culture=assemblyCulture, PublicKeyToken=assemblyPublicKeyToken"> 
<load/> [|| <noload/>] 
</loadinfo> 
</packageinfo> 


</security> 
</vjsharpconfiguration> 


The tags in the file are used as follows: 


<packageinfo> 


Specifies all of the installed security providers. 


<description> 


Allows the user to provide a description of the package and has no role in loading a provider. 


<loadinfo> 


Specifies the name of the provider class for the security provider package and assembly in which it is located. For assemblies 
installed to the Global Assembly Cache, the name of the assembly should also include the version, culture, and public key 
token of the assembly. If only the assembly name is specified, only the ApplicationBase is used to locate the assembly. For 
assemblies not installed to the Global Assembly Cache, you can also specify the fully qualified path to the assembly. In such a 
case, the specific assembly is loaded from the specified directory. 


<load>or <noload> 


Specifies if the assembly should be loaded or ignored for the current search. Specifying <noload> causes the assembly to be 
ignored. 


The vjsharp.config file is not created by default during installation. When no configuration file exists, the default security 
provider is used. 


To use a different provider, create this file in the %windir%\Microsoft.NET\Framework\v<Version> directory. The format of the 
file should be as specified above. The providers are loaded in the order in which they appear within the <security> tag. Errors 
encountered in the format of a <packageinfo> tag are silently ignored. The assemblies of the providers listed in this file must 
be installed to a location such that the .NET Framework common language runtime assembly search heuristics for locating and 
loading assemblies can find them. When the vjsharp.config file is specified, the default provider is not searched unless specified 
in the file. A <loadinfo> tag for the default provider might look something like the following: 


<loadinfo class="com.ms.vjsharp.security.provider.ms, vjslib, Version=1.0.4030.0, Culture=n 
eutral, PublickeyToken=B80725BFD0434260" > 

<load/> 
</loadinfo> 


See Also 

Tasks 

SecurityProviders Sample (Specify Third Party Security Providers) 
Reference 
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Upgrading from com.ms.* Packages to Equivalent .NET 
Framework Class Libraries 


Visual J# supports com.ms.* packages that are critical to successfully upgrading Visual J++ 6.0 applications to Visual J#. The 
complete list of packages is available in Supported Class Libraries. 


The .NET Framework class library provides functionality equivalent to many of the unsupported com.ms.* packages. Many of 
these com.ms.* classes have direct equivalents in the .NET Framework class library. 


The table below shows .NET Framework equivalents to some of the commonly used com.ms.* packages: 











com.ms.* package -NET Framework class library 
com.ms.mtx System.EnterpriseServices 
com.ms.asp System.Web 

com.ms.iis.asp System.Web 
com.ms.util.xml System.Xml 

com.ms.xml.om System.Xml 
com.ms.xml.parser System.Xml 

com.ms.xml.util System.Xml 

com.ms.security System.Security and System.Security.Policy 
com.ms.security.permissions System.Security.Permissions 
com.ms.vm System.WeakReference 





Upgrade prescriptions are also provided on moving from many of the com.ms.* packages listed above to the corresponding 
.NET Framework namespaces. 


In This Section 
Upgrading Components That Use the com.ms.xml.* Package 


Shows how an application that reads a simple XML file can be upgraded using the classes in System.Xml. 
Upgrading Components That Use the com.ms.mtx Package 


Shows how an application that uses the com.ms.mtx package can be upgraded using the classes in 
System.EnterpriseServices. 


Upgrading Components That Use the com.ms.wfc.html Package 
Shows how to upgrade the <OBJECT> tag in com.ms.wfc.html package code. 


Related Sections 
Upgrading from Visual J++ 6.0 


Provides recommendations and procedures for upgrading Visual J++ 6.0 projects to Visual J#. 
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Upgrading Components That Use the com.ms.xml Package 


The classes in the com.ms.xml.* packages can be used to load, read, modify, and save XML documents. The documentation in 
Visual J++ 6.0 and the Microsoft SDK for Java discuss these classes in detail. Visual J# does not support these packages. While 
upgrading a Visual J++ application that uses these packages, it is recommended that you move to the corresponding classes in 
the .NET Framework System.Xml namespace. 


The classes in System.Xml provide functionality equivalent to the com.ms.xml.* packages and are conformant with W3C 
standards. In the com.ms.xml.* packages, the Document, ElementCollection, Elementimpl, and Element classes are among 
the most used. The XMLDocument, XMLNodeList, and XMLNode classes in System.Xml are direct equivalents. 


Example 


The following example shows how a Visual J++ application that reads a simple XML file can be upgraded to Visual J# using the 
classes in System.Xml. 


SampleFile.Xml 


<?xml version="1.0" encoding="utf-8" ?> 
<bookdetails> 
<publisher>Microsoft Press</publisher> 
<book> 
<name>Designing Component-Based Applications</name> 
<price>12.45</price> 
</book> 
<book> 
<name>Professional Visual C++ MTS Programming</name> 
<price>21.98</price> 
</book> 
<book> 
<name>Essential COM+, 2nd Edition</name> 
<price>33.10</price> 
</book> 
</bookdetails> 


Visual J+ + 6.0 Application 


import com.ms.xml.om.*; 
public class XMLUpgrade 
{ 


public static void main(String[] args) 
{ 
try 
{ 
// Create an XML document object and load an XML file 
Document xmlDoc = new Document(); 
xmlDoc.load("SampleFile. xml") ; 


// Get the root node of the document 

Element xmlElement = xmlDoc.getRoot(); 

// Get a collection of child nodes under the root node 
ElementCollection xmlEleCo1 = xmlElement.getChildren(); 
// Get all nodes named 'book' in the collection 
ElementCollection xmlEleCo2 = (ElementCollection) 
xmlEleCo1.item("book") ; 

int length = xmlEleCo2.getLength(); 

for (int i=@; i < length; i++) 


{ 
// Retrieve the current element (book) from the collection 
Element xmlElement1 = xmlEleCo2.getChild(i); 
// Print the non-marked up text of the first child 
// (book name) 
System.out.println(xmlElement1.getChild(1).getText()); 

} 


catch(Exception e) 


System.out.println("An exception occurred"); 





After Upgrading to Visual J# 





import System.Xm1.*; 
public class XMLUpgrade 
af 
public static void main(String [] args) 
{ 
try 
{ 
// Create an XML document object and load an XML file 
Xm1Document xmlDoc = new Xm1lDocument(); 
xmlDoc.Load("SampleFile.xml "); 


// Get all nodes named 'book' in the document 
Xm1NodeList xnl = xd.GetElementsByTagName( "book" ) ; 
int length = xnl.get_Count(); 


Xm1lNode xn = null; 

for (int i=@; i < length; i++) 

{ 
// Retrieve the current element (book) from the collection 
xn = xnl.Item(i); 


// Print the non-marked-up text of the first child 
// (book name) 
System.Console.WriteLine(xn.get_FirstChild().get_InnerText()); 
} 
} 


catch (Exception e) 


{ 
} 


System.Console.WriteLine("An exception occurred"); 











Note 





The changes to the source code need to be made manually. The Upgrade Wizard will not automatically add the .NET Framew 
ork classes to the application. 





See Also 
Reference 
Upgrading from com.ms.* Packages to Equivalent .NET Framework Class Libraries 
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Upgrading Components That Use the com.ms.mtx Package 


The classes in the com.ms.mtx package make Microsoft Transaction Server (MTS) functionality available to Java-language 
developers. The documentation in Visual J++ 6.0 and the Microsoft SDK for Java discusses these classes in detail. Visual J# 
does not support the com.ms.mtx package. While upgrading Visual J++ applications that use this package, it is recommended 
that you move to the corresponding classes in the .NET Framework System.EnterpriseServices namespace. The classes in 
System.EnterpriseServices provide functionality equivalent to the classes in the com.ms.mtx package. 


The canonical form of writing MTS components in Visual J++ using the com.ms.mtx package is shown below: 


public int transactMethod () 


{ 
IObjectContext context; 


boolean success = false; 
IMtxComp mtxComp = null; 


// Obtain MTS context 
context = (I0bjectContext) Mtx.GetObjectContext(); 


// Obtain resources. For example, database connections 

// Use resources 

// Perform one piece of work for one client 

// Invoke other MTS components to do some of the work 

mtxComp = (IMtxComp) context.CreateInstance(CMtxComp.clsid, IMtxComp.iid) ; 


// all went well 
success = true; 
return @; 


finally 
{ 


// release resources 
if (success) 
context.SetComplete(); 
else 
context.SetAbort(); 


Some of the commonly used classes are com.ms.mtx.lObjectContext, com.ms.mtx.|GetContextProperties, 
com.ms.mtx.Context, and com.ms.mtx.MTx. The ContextUtil class in the System.EnterpriseServices namespace is a 
direct equivalent to the com.ms.mtx.lObjectContext and com.ms.mtx.Mtx classes. The other classes in the com.ms.mtx 
package like ISharedProperty, ISharedPropertyGroup, and ISharedPropertyGroupManager also have direct equivalents 
in the .NET Framework System.EnterpriseServices namespace. 


Example 


The following example shows how a Visual J++ application will be upgraded to Visual J# using the classes in 
System.EnterpriseServices. 


The Visual J++ 6.0 application 


import com.ms.mtx.*; 


/** @com.transaction(required) */ 
/** @com.register(clsid=E96931CC-DFDC-497C-B695-F9EC12F8F470) */ 
public class MtxServer 


{ 
public String transactMethod(String name) 


{ 
String greeting = null; 
boolean complete = false; 


try 
t 


// This would probably be a database write in 
// real world application code 


greeting = "Hello, " + name; 
complete = true; 


} 
finally 
{ 
IObjectContext ctx = MTx.GetObjectContext(); 
if (complete) 
{ 
ctx.SetComplete(); 
} 
else 
{ 
ctx.SetAbort(); 
} 
} 


return greeting; 


After Upgrading to Visual J# 


The code below illustrates how equivalent functionality can be achieved using the classes in the .NET Framework 
System.EnterpriseServices namespace. Methods of the public interfaces of the upgraded component must use types from 
the .NET Framework rather than Java-language types. 


import System.EnterpriseServices.*; 
import System.Runtime.InteropServices. *; 


/** @attribute GuidAttribute("E96931CC-DFDC-497C-B695-F9EC12F8F470") */ 
/** @attribute TransactionAttribute(TransactionOption.Required) */ 

// The class has to extend System. EnterpriseServices.ServicedComponent 
public class MtxServer extends ServicedComponent 


{ 
public String transactMethod(String name) 
{ 
String greeting = null; 
boolean complete = false; 
try 
{ 
// This would probably be a database write in 
// real world application code 
greeting = "Hello, " + name; 
complete = true; 
} 
finally 
{ 
if (complete) 
ContextUtil.SetComplete(); 
} 
else 
{ 
ContextUtil.SetAbort(); 
} 
} 
return greeting; 
; 
} 


In some cases, the com.ms.mtx package is used in components that use the com.ms.asp package to retrieve the context 
object. In such cases, the INET Framework System.Web.HttpContext class can be used to retrieve the Request or Response 
object. 


See Also 
Reference 
Upgrading from com.ms.* Packages to Equivalent .NET Framework Class Libraries 
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Upgrading Components That Use the com.ms.wfc.html Package 


Visual J# fully supports the com.ms.wfc.html package. However, the parameters of the <OBJECT> tag have been changed to 
enable classes to be loaded from managed assemblies in a version-aware manner. Therefore, when upgrading Visual J++ 6.0 
components that use the com.ms.wfc.html package, the HTML pages that contain the <OBJECT> tag need to be appropriately 
modified. 


The <OBJECT> tag used in Visual J++ 6.0 is as follows: 


<OBJECT CLASSID="java:com.ms.wfc.html.DhModule" height=@ width=@ ... VIEWASTEXT> 
<PARAM NAME=__CODECLASS VALUE=UserClass> 
<PARAM NAME=CABBASE VALUE=UserCabFile.CAB> 
</OBJECT> 
| 


The <OBJECT> tag that must be used in Visual J# is as follows: 


<OBJECT CLASSID="CLSID: CF83EA5E-@FFD-4476-9BF7-6C15F7F8BDCF" height=@ width=@ ... VIEWASTEX 
T> 
<PARAM NAME=CODECLASS VALUE=UserAssembly#UserClass> 
</OBJECT> 
| _| 
where: 
CLASSID 


Refers to the control used by Visual J# to host the user-defined class. Developers should not change this value. 


CODECLASS 


Refers to the user-defined class (that extends DhDocument) and the managed assembly that contains this class. The '#' 
token separates the assembly name and the class name. The assembly name must be the name of the file and must include 
the file extension. An attempt will be made to load the assembly from the same location that the HTML page that accesses it 
is located. It is also possible to specify a relative path for the assembly. 


Note 


The user-defined class is always hosted on latest version of Visual J# installed on the machine. 


Note 


In this release of Visual J#, the vJSVERSION parameter tag is no longer supported and will be ignored if included in an <OBJE 
CT> tag. 











For example, a typical <OBJECT> tag used in Visual J# might look as shown below: 


<OBJECT CLASSID="CLSID: CF83EA5E-@FFD-4476-9BF7-6C15F7F8BDCF" height=@ width=0 ... VIEWASTEX 
T> 
<PARAM NAME=CODECLASS VALUE=MyAssembly.d11l#MyUserClass> 


| </OBJECT> 





Visual J# will load and run a component only if it is fully trusted by the .NET Framework security policy on the client computer. 
In order to be considered fully trusted by the security policy on the client, one of the following conditions must hold: 


e The component must have been signed with a key pair and the .NET Framework security policy on the client computer 
modified to grant the FullTrust named permission set to all components or applications signed with this key pair. 


e The component must have been signed with an Authenticode certificate and the .NET Framework security policy on the 
client computer modified to grant the FullTrust named permission set to all components or applications signed with this 
certificate. 


e The .NET Framework security policy on the client computer has been modified to grant the FullTrust named permission 
set to controls downloaded from the Web site where the component is hosted. 


A component that is not considered fully trusted by the client computer will not be allowed to run. When a page containing 
such a component is loaded in Internet Explorer, an error message is displayed in the status bar. Based on the Internet Explorer 
security setting on the client, loading a page with such a component might cause an ActiveX warning dialog box to be shown 
every time the page is loaded. The user must click OK on the dialog to proceed with loading the component. 


See Also 
Reference 
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Common Issues in Upgrading Projects from Visual J++ 6.0 


In general, you should ensure that a project in Visual J++ 6.0 is able to build and run in that environment before attempting to 
upgrade it to Visual J#. If a project has build errors in Visual J++ 6.0, it is likely that the upgrade analysis will be incomplete and 
will fail to detect some or all of the upgrade issues. 


There are a number of differences between Visual J# projects and Visual J++ 6.0 projects. Some of the issues related to 
upgrading projects are the following: 


e CLASSPATH is a feature in Visual J++ 6.0 that allows the user to specify the locations to look for additional references. 
This setting is not supported in Visual J#. To add additional references, create a library of the files in the CLASSPATH and 
add that library as a reference to the Visual J# project. See Adding and Removing Project References for more 
information. See Visual J# Binary Converter Tool for information on how to convert libraries and applications available 
only as bytecode (.class) files to MSIL assemblies. 


Output packaging is now done using Setup Projects in Visual Studio. Packaging format information, such as packaging of 
the project as a CAB, ZIP, or self-extracting executable file, is not upgraded to the new project. 


Deployment information like company name and product version, which is stored in the packaged executable, is 
upgraded as assembly properties in Visual J#. See Setting Assembly Attributes to learn more about assembly attributes 
and how to use them. 


Pre-build and post-build settings are not supported in Visual J#. These settings from the Visual J++ 6.0 project are not 
upgraded to Visual J#. If you want a custom build step on a Visual J# project, add a C++ Makefile project (see 

Creating a Makefile Project) to your solution and change the Configuration Type property to Utility (see 

General Property Page (Project) for more information). See Understanding Custom Build Steps and Build Events for more 
information. 


Source control settings from the Visual J++ 6.0 project solution are not upgraded to the Visual J# solution file. The new 
Visual J# solution file and project file (.sIn and .vjsproj) have to be added to source control. Use the Change Source 
Control command on the Source Control menu to rebind the projects to their server locations. 


In Visual J++ 6.0, one project can access the classes defined in another project. If such a project is opened in the Visual J# 
development environment, it will not compile. You need to add a project reference, as follows: 


1. 


2. 


4. 


Open the Visual J++ 6.0 solution in Visual J# and, when prompted, upgrade each project in the solution. 


If necessary, add a reference to the vjswfc.dll and vjswfchtml.dll. See Add Reference Dialog Box for more 
information. 


. Make sure the Output Type property of the project whose class is being referenced is a Class Library project. 


Build the project. 


Make a reference to the project that contains the class from the project that uses the class. 


e Ina Visual J++ 6.0 solution that contains multiple projects, if one or more projects are not upgraded the first time you 
upgrade the solution, the remaining projects are marked as non-buildable. The next time you open the upgraded 
solution, you are prompted to upgrade the remaining projects. Even after upgrading them, they continue to be marked as 
non-buildable in the solution. This means that when you build the solution, these projects are skipped. 


To include these in the solution build, do the following: 


1. 
2. 


3. 
4. 


Right-click the solution node in Solution Explorer, and choose Properties. 


In the Solution Property Pages dialog box, select the Configuration subfolder of the Configuration Properties 
folder. 


In the Configuration combo box at the top of the dialog box, choose All Configurations. 


For each project, ensure that the check box in the Build column is selected. 


e Visual J# supports the Visual J++ 6.0 extensions that are listed in Support for Visual J++ 6.0. Note that the 
@conditional attribute works only for methods and callers in the same compiled unit. See 
Conditional Debugging Support for more information. 


e A Visual J++ 6.0 solution containing multiple projects and one or more circular dependencies cannot be upgraded to 
Visual J#. For example, if a Visual J++ 6.0 solution contains projects A and B, A can use classes in B and B can use classes 
in A if the Merge all Project-specific Classpaths in solution property is set (it is set by default for all projects). 


In Visual J#, this solution would be upgraded so that project A adds a reference to project B and project B adds a 
reference to project A, so long as both projects were class library projects. However, circular references are not allowed in 
Visual J#. Thus, you need to combine both the projects into a single assembly in Visual J#. 


See Also 
Other Resources 
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Conditional Debugging Support 


Visual J# supports the Visual J++ 6.0 @conditional attribute for selective application debugging. However, both the 
attributed method and the method caller must be part of the same compiled unit. If the calling method and the target method 
are in different assemblies, you can use the .NET Framework class, ConditionalAttribute instead. 


See Also 
Other Resources 
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Working with Both Visual J++ 6.0 and Visual J# 


After upgrading the Visual J++ 6.0 solution, you can work on Visual J++ 6.0 and Visual J# side-by-side. The original Visual J++ 
6.0 solution can be opened and run on Visual J++ 6.0, while the upgraded solution can be opened and run on Visual J#. This 
lets you try the various features of both environments. 


The new Visual J# solution (.sIn) file cannot be opened in Visual J++ 6.0. 


After upgrade, the upgrade report generated by the Upgrade Wizard will get added to the Visual J++ 6.0 project, since the 
report is generated in the same directory as the original project. This will not affect building and running the Visual J++ 6.0 
project as the upgrade report is an HTML file. 


Since the source files are shared between original and upgraded projects, any changes made to sources in one project will 
affect the other project. 


See Also 
Other Resources 
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Visual J# Migration 


Visual J# provides wizards and command-line tools to assist you in converting older Java and J++ applications, applets, and 
bytecode. Once the conversion is complete, the J# application runs on the .NET Framework without the Java Virtual Machine 
(JVM). 


Tools to Convert Legacy Applications 


You can quickly convert most VJ++ and Java applications to Visual J# using one of these tools: 


e The J# Upgrade Wizard automatically converts your existing J++ projects to Visual J#. For more information, see 
How to: Create a Visual J# Project from Existing J++ Code. 


e The command line Visual J# Binary Converter Tool converts certain Java-language bytecode (.class) files to Microsoft® 
intermediate language (MSIL). For more information, see 
Visual J# Binary Converter Tool (for Java-Language Bytecode to MSIL Conversions). 


e The downloadable HTML Applet to Object Tag Converter upgrades Java Applets to Microsoft J# Browser Controls. For 
more information, see HTML Applet to Object Tag Converter. 


Supported 

The Visual J# conversion tools support upgrades to the following types of applications: 
e Visual J++ 6.0 code and projects. 
e Java applet source code for browser and applet standalone applications. 
e Database applications that use JDBC. 


e .NET Framework CodeDOM. CodeDOM, or Code Document Object Model metadata that describes the structure of a 
piece of source code for rendering application text in multiple languages. 


e@ COM Interop applications with a client and remote or local server. 


Not Supported 


You can manually convert code that utilizes the following legacy packages, library, and custom attributes: 


e@ CLASSPATH feature of VJ++ 6.0. 
e Java Native Interface or Remote Method Invocation. 
@ sun.io.*, sun.net.*, and netscape.* packages. 


e JDK 1.1.4. 


See Also 

Tasks 
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Visual J# Binary Converter Tool (for Java-Language Bytecode to 
MSIL Conversions) 


The Visual J# Binary Converter Tool Ublmp.exe) converts certain Java-language bytecode (.class) files to Microsoft® 
intermediate language (MSIL). This tool enables developers to convert most JDK 1.1.4 level libraries and applications available 
only as bytecode files to MSIL assemblies. Once converted, these applications can run on the .NET Framework. 


You can use this tool only if the Java-language sources for the applications or libraries are not available. If Java-language 
sources are available, it is recommended that you use the Visual J# compiler (vjc.exe) instead. 


JbImp [options] <class_files> [ [options] <class files> ...] 


Parameters 
Class_files 


The names of any .class files to convert. This option lists both directories and files. Directory and file names can contain the 
asterisk (*) and question mark (?) as wildcards. You can also specify a CAB, ZIP, or JAR file here. 


/delaysign 


Specifies whether an assembly will be fully or partially signed. Use /delaysign if you want to place only the public key in the 
assembly. 


By default, /delaysign is not in effect. 

The /delaysign option has no effect unless used with /keyfile or /keycontainer. 
/help/? 

Prints a summary of the JbImp.exe options. 
/k[eyfile]:file 


Signs the generated assembly with the keyfile file. An assembly with a strong name is created with the keypair specified in 
file. This file is typically generated using the sn.exe utility. Place the string in double quotation marks ("") if it contains a 
space. 


/keycontainer:string 


Specifies a key container name for a key pair to give an assembly a strong name. Place the string in double quotation marks 
("") if it contains a space. 


/linkres[ource]:file[,identifier] 


Creates a link to a managed resource. Optionally specifies a logical name used to load the resource. The default is the name 
of the file. 


/m[ain]:class 


Specifies the entry point for the executable file. The list of .class files is parsed to find the class named class. If such a class 
exists and has a method with the signature public static void main(String[] args), then this method is set as the entry 
point. Otherwise, conversion stops. 


If this option is not selected, the first class that has a method with the signature public static void main(String[] args) 
will be the entry point. If no such class exists and the /target:exe option is selected, conversion stops. 


The class name specified in the argument can be a simple name or a fully qualified name that includes the package name. 
/nologo 

Suppresses converter banner information. 
/out:file 

Specifies the output file name and creates a .NET Framework assembly file with the name file. 


/r[eference]:files 


Uses the .NET Framework Microsoft intermediate language (MSIL) assembly files to resolve metadata references in the .class 
files. 


/recurse dir 


Recurses through subdirectories of the parent directory dir, looking for .class files. This option is meaningful only when 
class_files include directory names. 


/res[ource]:file[,identifier] 


Embeds a managed resource in the assembly. Optionally specifies a logical name used to load the resource. The default is the 
name of the file. 


/securescoping 


Follows rules for secure scoping. This is an advanced option that can be used to map Java-language package scope to .NET 
Framework assembly scope. If this option is not specified, package and protected scoped members in the Java-language 
bytecode are mapped to public scope in the output assembly. 


/t[arget]:library 
Generates a DLL. Sets no entry point, even if main is present. 
/t[arget]:exe 


Generates an executable (.exe) file. This is the default setting for the /target option. One of the input .class files must 
implement main. 


/t[arget]:module 


Generates an MSIL module. A module cannot be loaded and run by the common language runtime, but a module can be 
used by the Visual J#, and other, compilers to access the types in the module. 


/usestubrefs 
Uses stub types, fields, and methods for unresolved references. 


If a class is referenced and not present in the input, the CLASSPATH environment variable is automatically searched for the 
missing class and the first found location is displayed with the error information. If this option is not specified, conversion 
stops if any of the referenced classes are not present in the input. If this option is specified, stub types are emitted into the 
created assembly for each of the missing classes. This causes the conversion to succeed, but will cause an exception to be 
thrown when an attempt is made to access a missing class member at run time. 


Supported 


The Visual J# Binary Converter Tool supports the following operations: 


e Conversion of .class files generated from certain Java-language code. The Visual J# Binary Converter Tool will convert 
code that uses functionality in most of the JDK 1.1.4 level class libraries. 


e Conversion of .class files containing most Microsoft Visual J++ ® 6.0 extensions, including delegates and J/Direct®. 
e Recursively search subdirectories for .class files to convert. 
e Import and use existing .NET Framework assembly DLL or EXE code. 
e Create a strong-named assembly that can be installed into the Global Assembly Cache (GAC). 
Not Supported 
The Visual J# Binary Converter Tool does not support the following: 
e Code that uses Java-language/COM interop technology. 
e Code that uses functionality in class libraries above the JDK 1.1.4 level. 


e Code that uses certain functionality in the JDK 1.1.4 level class libraries, including RMI, RNI, JNI, and applets. 


See Also 
Other Resources 
J# Operators 


Visual J# Reference 


Using Resources in Visual J# Applications 


You can store resource files (.resx), such as error messages, within your Visual J# project without worrying about a CLASSPATH 
to map their location. When you build your application, the linker embeds the resources into the assembly output. At run time, 
the common language runtime (CLR) uses .NET Framework semantics to locate and load the appropriate resource from the 
application path. 


There are three benefits to using the .NET Framework semantics for resources: 
e Fully managed, protected environment for running applications. 
e Built-in support for localization. 
e Simplified application deployment. 


When upgrading existing Visual J++ 6.0 projects, you can use the Visual J# Resource Generator (Vjsresgen.exe) command line 
tool or the INET Framework Resource File Generator Tool (Resgen.exe) to convert your resource files to the .resx file format. For 
more information, see How to: Upgrade Visual J++ 6.0 Applications That Use Resources. 


See Also 
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Visual J# Application Deployment 


Applications created using Visual J# rely on the Visual J# CodeDOM and Visual J# compiler for dynamic code generation and 
compilation on the server. You need to have redistributable components of Visual J#—that is, Visual J# class libraries, the 
Visual J# compiler, and the Visual J# CodeDOM— installed on the server where you will deploy the XML Web service or Web 
Forms application. Use the Visual J# Redistributable Package to distribute redistributable components of Visual J#. Other 
aspects of deployment are the same as for any other ASP.NET application. 


For more information, see Windows Installer Deployment Walkthroughs. 





Note 





All deployment walkthroughs apply to Visual J#. However, Visual J# components require additional redistributable compone 
nts, supplied with the Visual J# Redistributable Package. 





In This Section 
Visual J# Launch Condition 


Describes how to ensure that Visual J# redistributable components are installed on a target computer. 
Distribution of the Visual J# Redistributable Package 


Describes the contents of the Visual J# Redistributable Package. 


Related Sections 
Deploying Applications and Components 


Information about creating setup executables, packaging files, and creating Web sites. 
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Visual J# Launch Condition 


The Visual J# launch condition checks for the Visual J# Redistributable Package on a target computer during the installation of 
your application. During setup, the Visual J# launch condition searches for the version of the Visual J# Redistributable Package 
specified in the SupportedRuntimes property of the INET Framework launch condition. If the INET Framework launch 
condition is not present, the SupportedRuntimes value is used as the current version of the Visual J# Redistributable 
Package. 


If the required version of the Visual J# Redistributable Package is not found, the installation is halted. The user is presented 
with a Yes/No dialog box that contains the text specified in the Message property. If the user chooses Yes, a redirect displays 
the location specified in the InstallUrl property, which is, by default, a Microsoft Support Web site that contains a 
downloadable copy of the Visual J# Redistributable Package. In many cases, you will want to modify the InstallUrl property to 
point to your own location for the redistributable file. For example, if you are distributing your application on CD-ROM, you 
should include the redistributable file on the CD and change the InstallUrl property to the file path. If you change the 
InstallUrl property, you should also change the Message property to explain what is being installed and from where. 


Normally, the launch condition is automatically included to your deployment project when a dependency on the Visual J# 
Redistributable Package is detected. However, you may have to manually add the Visual J# launch condition to your setup 
project even if it does not have any explicit dependencies on the Visual J# Redistributable Package. For example, if Visual J# 
third-party components are zipped and available in a setup, then the deployment project will not detect the Visual J# 
dependency. 


Once added, it cannot be removed. If you decide that the dependency is no longer required, you can just recreate the project. 


The dialog boxes and menu commands you see might differ from those described in Help depending on your active settings 


or edition. To change your settings, choose Import and Export Settings on the Tools menu. For more information, see 
Visual Studio Settings. 





To manually add the Visual J# launch condition to your setup project 


1. In Solution Explorer, right-click the setup project to which you want to add the Visual J# launch condition. 
2. Click Add, and then click Merge Module. 

The Add Modules dialog box appears. 
3. Select the VJSharpRedist_x86.msm file, and click Open. 


The Visual J# merge module and launch condition are added to the Setup project. 


See Also 
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Distribution of the Visual J# Redistributable Package 


Applications and controls written in Visual J# require the Visual J# redistributable package to be installed on the computer 
where the application or control runs. 


The Visual J# redistributable package (vjredist.exe) is available by Web download from the Visual J# Download Center. 
Installing the .NET Framework redistributable package is a prerequisite to installing the Visual J# redistributable package. For 
more information, see Redistributing the INET Framework. 


The Visual J# redistributable package supports all platforms supported by the .NET Framework redistributable package. The 
Visual J# redistributable package has no additional system requirements other than the requirements of the .NET Framework 
redistributable package. 


The Setup program of the Visual J# redistributable package installs the same files on all supported platforms to support both 
server and client scenarios. 


All versions of the Visual J# Redistributable Package are available for download at the MSDN Download center. For more 
information, see Visual J# Redistributable Packages. 


Language Pack Support 


You can also install the different Visual J# Redistributable 2.0 Language Packs over the J# Redistributable 2.0 Second Edition, 
to show localized messages that have not changed between the 2.0 release and the 2.0 Second Edition release. After 
installation, messages that were changed for the 2.0 Second Edition release continue to be in English. 


If you are compiling in 64-bit and want to take advantage of the J# Redistributable 2.0 Language Packs, you have to install the 
different Visual J# Redistributable 2.0 Language Packs over the 64-bit editions of J# Redistributable 2.0 Second Edition and 
copy the file %WINDIR%\Microsoft.Net\Framework\v2.0.50727\XXXX\vjslibui.dll to 
%WINDIR%\Microsoft.Net\Framework64\v2.0.50727\XXXX\vjslibui.dll. XXXX should be replaced by the following numbers for 
different languages: 


e@ 1028 - CHT 
e 1031 -DEU 
e@ 1036 -FRA 
e 1040 - ITA 
e 1041 -JPN 
e 1042 -KOR 
e@ 2052 - CHS 
e 3082 - ESN 





Note 





The Visual J# 2.0 Redistributable Package - Second Edition only includes the JPN language pack. However, you can use 
the J# 2.0 Language Packs with the release. 
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Visual J# 64-bit Development 


Microsoft Visual J# 2.0 Redistributable Package — Second Edition enables Visual J# applications to run natively on 64-bit 
platforms. The packages contain support for a subset of features that shipped in previous 32-bit versions of the Visual J# 
Redistributable (version 2.0 and earlier). This section discusses the feature set that is enabled for 64-bit editions. 


Supported components 





Com Description 
pone 
nt 





Class |Class library support equivalent to most of the Java Development Kit (JDK) level 1.1.4 packages that were included in Vi 
librar |sual J++ 6.0 are enabled to run natively on 64-bit platforms. Some classes which support functionality equivalent to tha 
y sup |t of JDK level 1.2 (for more information, see Additional Class Library Support) are also enabled for native 64-bit executi 

port jon using Visual J#. 


Visual|The Visual J# compiler now supports the /platform option. 
J#co 
mpile 


MSBu |The changes are discussed in detail in the section named MSBuild Support. 


WoW |Apart from support for native 64-bit execution, Windows on Windows (WoW) support is enabled by default for Visual J 
suppo|# applications after you install Microsoft Visual J# 2.0 Redistributable Package — Second Edition on 64-bit platforms (x6 
rt 4 and IA64). 








MS Build Support 


Microsoft Visual J# 2.0 Redistributable Package — Second Edition has MSBuild support enabled (including cross compilation) 
from a command prompt. This enables you to build Visual J# project files (.vjsproj) and solution files (.sIn) that are created by 
using Visual Studio 2005 from a command prompt by using MSBuild. 


All Visual J# project and solution files that are created by using Visual Studio 2005 use the x86 architecture type. Modify the 
project and solution files to build them to a different architecture type as specified here: 


e anycpu, x64, or |A64 architecture types if using the 32-bit (or WoW) MSBuild task. 
e x86, x64, |A64 or anycpu type if using the 64-bit MSBuild task. 


The reason for this behavior is that the 32-bit or WoW MSBuild task, which is present at 
%SystemRoot%\Microsoft.Net\Framework\v2.0.50727, by default emits 32-bit (x86) architecture type binaries. The 64-bit 
MSBuild task, which is present at %SystemRoot%\Microsoft.Net\Framework64\v2.0.50727, by default emits anycpu binaries. 
This behavior differs from the default behavior that is expected from Visual J# project and solution files that are generated by 
Visual Studio 2005. 


There are two ways to build applications using MSBuild: 
e Build the *.vjsproj files by using the /property:platform=xxx option. 
e Build the *.sIn file with the /property:platform=xxx option. 
Each method is described in the following procedures. 
In the following procedure, xxx specifies the targeted platform type, one of: anycpu, x86, x64 or Itanium. 
To build applications for a specific platform architecture type by using MSBuild 
1. Build the *.vjsproj files by using the /property:platform=XXxX option. 


2. Add a new PropertyGroup section to the *.vjsproj file that is generated by Visual Studio 2005: 








<PropertyGroup Condition="_ '$(Configuration) |$(Platform)' == 'YYY|XXX' "> 
<DebugSymbols>true</DebugSymbols> 
<DebugType>full </DebugType> 
<Optimize>false</Optimize> 
<OutputPath>bin\Debug\</OutputPath> 
<PlatformTarget>Xxx</PlatformTarget> 
<DefineConstants>DEBUG; TRACE</DefineConstants> 
</PropertyGroup> 


To build applications for a specific platform architecture type by using MSBuild 


1. Build the *.sIn files by using the /property:platform=XXX option after you have modified the vsjproj file as described in 
the previous procedure. 


2. In the GlobalSection(SolutionConfigurationPlatforms) and GlobalSection(ProjectConfigurationPlatforms) 
sections, add the "configuration | platform" preSolution and postSolution that you have included in your *.vjsproj files. 
For example, suppose you had added Debug! x64, you would modify your solution file as follows: 


GlobalSection(SolutionConfigurationPlatforms) = preSolution 
Debug|x86 = Debug| x86 
Release|x86 = Release|x86 
Debug|x64 = Debug|x64 
EndGlobalSection 
GlobalSection(ProjectConfigurationPlatforms) = postSolution 
{E2D2EA3E -@E77-4C82-8AA4-D94FFC1EB7F6}.Debug|x86.ActiveCfg = Debug|x86 


{E2D2EA3E-@E77-4C82-8AA4-D94FFC1EB7F6}.Debug|x86.Build.@ = Debug|x86 
{E2D2EA3E-@E77-4C82-8AA4-D94FFC1EB7F6}.Release|x86.ActiveCfg = Release 


| x86 

{E2D2EA3E-@E77-4C82-8AA4-D94FFC1EB7F6}.Release|x86.Build.@ = Release|x 
86 

{E2D2EA3E -@E77 -4C82-8AA4-D94FFC1EB7F6}.Debug|x64.ActiveCfg = Debug|x64 

{E2D2EA3E -@E77 -4C82-8AA4-D94FFC1EB7F6}.Debug|x64.Build.@ = Debug|x64 
EndGlobalSection 


Because adding new options at the beginning of the .sIn file changes the default compile properties of the file, this is not the 
recommended approach. 


If a solution has multiple projects which must be compiled for different platforms, iterate through each Visual J# project and 
compile them separately instead of compiling them as a single solution file. 





Visual Studio does not recognize and open project and solution files that are edited manually. To use Visual Studio 2005 to o 
pen and edit project and solution files, it is recommended that you maintain a separate copy of the files for manual editing. 





Known Issues 
Setup experience for Microsoft Visual J# 2.0 Redistributable-Second Edition Package is not completely localized. 


The Setup experience for Microsoft Visual J# 2.0 Redistributable-Second Edition Package is not completely localized. Other 
than the EN-US and JPN download page, no separate localized download pages are available for the Second Edition of the J# 
Redistributable. The Setup language is also US-English and JPN, respectively. Parts of the user interface prompts and messages 
in the Setup user interface (Ul) are displayed in US-English when you install the product on non US-EN operating systems. 


e Platforms Affected: x86, x64, IA64 


To resolve this issue 


e No action is needed. The redistributable package is installed and operates on non-US-EN and JPN operating 
environments. 


A synchronized method that has security callouts may not save a return value after control returns to the calling function in an 
application that is built by using the 64-bit version of the .NET Framework 2.0. 


In an application that is built by using the 64-bit version of the Microsoft .NET Framework (version 2.0 or3.0), a synchronized 
method that has security callouts may not save a return value after control returns to the calling function. This breaks the AWT, 
Swing and Zip functionality of Visual J# applications on 64-bit platforms. 


e Platforms Affected: x64, |A64 


To resolve this issue 
e Install the software update for the issue. See Knowledge Base article 917882 for additional information. 
java.lang.Thread behavior is inconsistent and threads do not start at times. 
The behavior of java.lang.Thread is inconsistent and at times the thread does not start. 


e Platforms Affected: |A64 


To resolve this issue 
e Install the software update for the issue. See Knowledge Base article 913469 for additional information. 


Values between System.Double.Epsilon (4.94065645841247E-324) and approximately 1/2 Epsilon (2.470328229206232730000E-324) 
are rounded off to zero instead of Epsilon. 


On 64-bit platforms, values between System.Double.Epsilon (4.94065645841247E-324) and approximately 1/2 Epsilon 
(2.470328229206232730000E-324) are rounded off to zero instead of Epsilon. 


e Platforms Affected: x64, |A64 


To resolve this issue 
e Change the application code-base to suite the above behavior 


64-bit Visual J# applications that reference v1.1 Visual J# binaries (compiled with v1.1 Visual J# compiler) crash. 


Applications that are built with the 64-bit Visual J# compiler (targeting anycpu or IA64 platform type) that are executed on a 
64-bit Itanium platform crash if an assembly compiled with version 1.1 of the Visual J# compiler is passed as reference. 


e Platforms Affected: |A64 


To resolve this issue 


e Build the application as 32-bit platform specific by using the /platform:x86 option on the 64-bit Visual J# 
compiler and execute them in WoW mode on Itanium architecture 


java.util.GregorianCalendar.add method returns wrong value when one month is added to a date like Jan 31st 2004. 


The java.util.GregorianCalendar.add method returns a wrong value when one month is added to a date like January 31, 
2004. The date is moved to March 2, 2004 instead of February 29, 2004. 


Applications by default continue to use java.util.GregorianCalendar.add ina similar way as with previous releases. 


e Platforms Affected: x86, x64, |IA64 


To resolve this issue 


e Use the setMonthJustified() method added to the com.ms.vjsharp.util.GregorianCalendarHelper Class. 
Calling this method enables the modified behavior for the GregorianCalendar Class in the appdomain. 


See Also 
Other Resources 
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Visual J# Tasks 


You can perform the following tasks with Visual J#. 


In This Section 
Common Programming Tasks 


Describes how to replace the implementation of a Visual J# library class with your own implementation. 
Migrating from Java 

Describes how to upgrade Java-like applications and older J+ projects to Visual J#. 
Integrating COM Applications with J# 

Describes how to create Visual J# COM client and server components and interface with other COM servers. 
Compiling J# Applications 

Describes how to build a J# application from Visual Studio. 
Accessing Data with J# 

Describes how to query data. 
Managing J# Projects 

Describes how to use Visual Studio to manage J# projects. 
Managing Serialization with J# 

Describes how to store and retrieve data temporarily. 
Upgrading to J# 

Describes how to upgrade older applications to Visual J#. 
Web Programming with J# 

Describes how to create reusable J# web components. 
Creating Windows GUI Applications with Visual J# 

Describes how to use Visual J# to create user interfaces for applications. 
How to: Access Resources from a .properties File 

Provides a code example that shows how to share a .properties file between Visual J# and a legacy application. 
How to: Call a Method in a DLL from Visual J# 

Provides steps to show how to call both static and dynamic methods from the Visual J# library. 
How to: Create a Visual J# Project from Existing J++ Code 

Provides the steps necessary to upgrade a Visual J++ project to Visual J#. 
How to: Deploy J# Browser Controls 

Describes how to create a simple control, deploy the control to a Web site, and display it on a Web page. 
How to: Implement an Interface in J# 

Provides code that shows you how to implement the java.lang.Comparable interface to compare bank transactions. 
How to: Validate User Input in a Console Application 

Provides steps for creating a console application that verifies the user entered a first and last name at run time. 
How to: Write a Package Scoped Class 


Provides examples that show how to package scoped classes. 


Related Sections 


Upgrading from Visual J++ 6.0 


Provides information and links to topics on upgrading applications to Visual J#. 
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Common Programming Tasks 


This section describes how your J# application can extend or interact with other applications. 


In This Section 
How to: Replace the Implementation of a Class in Visual J# Library with My Own Implementation 


Describes how to bypass common implementations for class methods with customized implementations. 


See Also 
Other Resources 


Compiling J# Applications 
Migrating from Java 


Visual J# Concepts 


How to: Replace the Implementation of a Class in Visual J# 
Library with My Own Implementation 


It is possible for you to create your own implementation of many vjslib.dll classes because the compiler uses implicit 
references to vjslib.dll. At the final stages of compilation, if the compiler does not find an implementation from your code, it 
resolves the references to vjslib.dll. 
To create your own implementation 
1. Create a new console application, and replace the code found in Program,jsl with the following: 
package MyPackage; 


import java.util.*; 


public class simple 


public static void main(String[] args) 
1 
Vector v = new Vector(); 
} 
; 


2. Right-click Solution Explorer, and on the shortcut menu, click Add a New Item. 
3. Select Class, and type the name Vector.jsl. 
4. Replace the existing code with the following code: 

package MyPackage; 


public class Vector 


{ 
public Vector() { System.out.println("Vector"); } 


/* 
public class String 


{ 
public String() { System.out.println("String") ; 


5. Press F5 to compile and run the application. 

Notice that the console output comes from your own Vector class. 
6. Uncomment the entire String class. 
7. Press F5 to compile. 


The code fails to compile because it cannot resolve the class name. You cannot replace the implementation on core 
classes in java.lang.Object or java.lang.String. 


The error is: /target is ‘exe’ but no suitable main method was found in compilation. 


Robust Programming 


e You cannot replace the implementation on core classes in java.lang.Object or the java.lang.string. 


See Also 
Tasks 


How to: Create a Visual J# Console Application 
How to: Call a Method in a DLL from Visual J# 
How to: Implement an Interface in J# 
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Migrating from Java 


The purpose of this section is to assist you in migrating legacy applications to the J#. 


In This Section 
How to: Compile a Java-language Application in Visual J# 


Describes how to convert a legacy Java application to a J# application. 
How to: Convert Java-Language Bytecode to MSIL Code 
Describes how convert an executable Java application to an executable J# application. 
How to: Create Enumerated Constants 
Describes how to use enumerations rather than constants to represent sets of data. 
How to: Write a Class Loader 
Describes how to write a class that can instantiate other classes based on your own criteria. 
See Also 


Other Resources 
Common Programming Tasks 
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How to: Compile a Java-language Application in Visual J# 


You can compile many of your Java Development Kit (JDK) 1.2 applications seamlessly in J#. Applications use Abstract Window 
Toolkit (AWT) or native java functionality compile with little or no manual upgrading. 


The following procedure shows you how to create your own project, add your existing java files, and compile them with J#. 


The dialog boxes and menu commands you see might differ from those described in Help depending on your active settings 


or edition. To change your settings, choose Import and Export Settings on the Tools menu. For more information, see 
Visual Studio Settings. 





To compile your JDK application in Visual J# 


1. Create a new console application. 


The console application displays a default J# application file. Since your application is not currently working with J#, the 
Program sl is not necessary. 


2. In Solution Explorer, right-click on the Program.jsl file and point to Exclude From Project. 


Visual Studio removes the Program.jsl from the project without deleting the file. When you compile, the Program jsl 
will not be included in the list of files to build. If you change your mind and would like to add the Program.jsl back into 
the project, you may do so. You may add any kind of file, however, Visual J# will only compile files with the java or js| 
extensions. 


3. Right-click on the project name, point to Add, and then Existing Item to add your .java files to the project. 
4. Ctrl + Click on one or more existing.java files. 
5. Press OK to add them to the new project. 
The files you just added display in the Solution Explorer. 
6. Click File and Save All to store the project. 
7. Right-click on the project name and point to Properties. 
The Configuration dropdown list shows which configuration is active. 
8. In the Configuration dropdown list select Debug or Release. 


When you compile with the Debug configuration, the compiler adds symbols for stepping through the code. The Release 
configuration creates a smaller assembly for distribution. 


9. Press F5 to run compile and run the program. 
-or- 
Click Debug Start. 
-or- 
Click Build Solution. 


Visual J# compiles the project and places the .exe assembly in the bin\debug directory depending on the configuration 
setting. 


10. At the bottom of the screen, review the compiler status in Output window. 
11. If the program did not compile, click on the Error tab for details. 


12. Highlight the error, and press F1 for detailed help about how to correct the problem. 


See Also 
Tasks 


How to: Create a Visual J# Console Application 


Other Resources 
Visual J# Compiler 


Visual J# Concepts 


How to: Convert Java-Language Bytecode to MSIL Code 


You can quickly convert many legacy Java applications to Visual J#. The Visual J# Binary Converter Tool Jblmp.exe) converts 
certain Java-language bytecode (.class) files to Microsoft intermediate language (MSIL). This command-line tool enables 
developers to convert most JDK 1.1.4-level libraries and application bytecode to MSIL assemblies. Jblmp.exe also converts 
J/Direct code. 





Note 





Use this tool only if the Java-language sources for the applications or libraries are not available. If Java-language sources are 
available, it is recommended that you use the Visual J# compiler (vjc.exe) instead. 








For more information, see Visual J# Binary Converter Tool (for Java-Language Bytecode to MSIL Conversions). 
To convert bytecode 


1. Open Visual Studio Command Prompt. 


2. To convert a single Java class to an EXE file, simply name the class. For example: 


jbimp /target:exe /out:myAssembly.exe myClass.class 


3. To convert a JAR, ZIP, or CAB archive containing classes, just name the archive file. For example: 





jbimp /target:exe /main:myMainClass /out:myAssembly.dll c:\myClass.jar 








See Also 
Tasks 
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How to: Create Enumerated Constants 


Enumerations make it possible to create your own data types, making code easier to read and more reliable. J# enables you to 
create your own data types using the enum keyword. These data types enable you to declare a set of names or other literal 
values that define all of the possible values that can be assigned to a variable. 


For example, if your program deals with the days of the week, you might want to create a new type called weekDay, as 
demonstrated in the following procedure. 


To create an enum 


1. Create a console application called Enums. 


2. Replace the Programs! with the following code: 
import System.*; 


public class Program 


{ 
enum WeekDay 
{ 
Sunday (@), Monday, Tuesday, 
Wednesday, Thursday, Friday, 
Saturday 
} 


The enum data type makes your code more readable and also prevents an illegal or unexpected value from being 
assigned to the variable. You can use parentheses to set the value of any of the elements. Even though the default value 
of the first element is zero, for demonstration purposes, the value for Sunday is set to (0). 


3. Before the last closing brace insert the following main method: 


public static void main(String[] args) 


{ 
System.DateTime currentDate = System.DateTime.get_Now(); 
System.out.println(currentDate.get_DayOfWeek()); 
DayOfWeek ActualDay = currentDate.get_DayOfWeek(); 
if ((int)WeekDay.Friday == (int)ActualDay) 
{ 
System.out.println("Today is " + ActualDay + ". Complete your timecard" 
)3 
i 
else 
{ 
System.out.println("Today is " + ActualDay + ". Complete your work"); 
} 
} 


First, the get_Now method retrieves the current date. Notice that instead of using the ToString() method, the printIn 
method automatically casts both the DateTime and the DayOfWeek enum to their respective String equivalent for 
displaying on the console window. 


Although the purpose of the enum data type is to hide the underlying integer value and so make your code more 
readable, it is still possible to deal with numbers if you use casting. For example, to determine whether today is Friday, 
you can cast and use the comparison operator: 


((int)WeekDay.Tuesday == (int) ActualDay) 


You can also assign a value to the enum. However, if you start assigning and testing for integer values, you might 
accidentally assign a value that has not been defined as part of the initial data type declaration. In this case, no 
compilation or exception would be raised, and one of the benefits of using the enum data type would be lost. 


4. Press F5 to compile and run your program. 


At run time, this program prints out the current day. If it is Friday, the application reminds you to complete your timecard. 
Otherwise, the application reminds you to move on to your regular work. 


See Also 

Tasks 

Enum Type Sample (Declare a Enumeration Type) 
Reference 

User-Defined Enumeration Types (J#) 
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How to: Write a Class Loader 


Occasionally, your applications might require a custom class loader that only instantiates classes based on your own criteria. 
This example shows how custom class loaders in existing Java-language applications can be modified to load classes from 
managed assemblies. The following example demonstrates how the common language runtime (CLR) can load classes based 
on whether the caller is a user or administrator. 





Note 





Class loaders are only intended to be used by existing Java-language applications. For new code, it is recommended that clas 
ses be searched and loaded from managed assemblies using the INET Framework's CLR semantics and APIs rather than usin 
g custom class loaders. 











When writing class loaders, note the following considerations: 


e Avoid using the resolveClass and defineClass methods in the class java.lang.ClassLoader because they are 
unsupported. 


e In existing Java-language applications, rewrite the loadClass() method to call one of the versions of the INET Framework 
Class.forName(), and then make appropriate entries in the application configuration (.config) file so that the CLR can 
locate and load managed assemblies for the application. If the managed assemblies reside in the application's working 
directory, then no configuration file is required and the Class.forName() search heuristics will locate the class. 


To write a class loader 


1. On the File menu, point to New, and then click Project. 


2. In the New Project dialog box, select Console Application, and in the Name box, type ClassLoaderSample. Click OK. 


3. In Solution Explorer, double-click Program,jsl, and add the following code: 


class SecurityClassLoader extends ClassLoader 
{ 
protected Class loadClass(String className, boolean resolve) 
throws ClassNotFoundException 


if ("SecureClass" == className) 

{ 
String user = System.getProperty("user.name") ; 
if (null == user) 


{ 
System.out.println("Class was not loaded. "); 
System.out.println( 
"user not found .name property is not set."); 
return null; 

} 

else if (user.equals("Administrator") ) 

{ 
System.out.println( 
"Load access granted on the class 'SecureClass.'"); 
return Class.forName(className) ; 

} 


// If user is not an administrator. 

System.out.printin(className + 
"was not loaded. Invalid class or username."); 

return null; 

} 


else if ("RegularClass" == className) 
return Class. forName(className) ; 


else 
throw new ClassNotFoundException(); 


public Class loadClass(String className) throws 
ClassNotFoundException 


return loadClass(className, true); 


public class ClassLoaderSample 


{ 


public static void main(String args[]) throws 


java.io. IOException 
SecurityClassLoader ccl = new SecurityClassLoader(); 


try 
{ 
Class cl; 
Object obj = null; 


System.out.println( 

"Attempting to load an instance of RegularClass."); 
cl = ccl.loadClass("RegularClass") ; 
if (null == cl) 

System.out.println( 

"Failed to load an instance of RegularClass."); 
else 

obj = cl.newInstance(); 


if (null != obj) 
System.out.println( 
"Successfully loaded an instance of RegularClass\n."); 


obj = null; 
System.out.println( 
"Attempting to load an instance of SecureClass."); 
cl = ccl.loadClass("SecureClass"); 
if (null == cl) 

System.out.println( 

"Failed to load an instance of SecureClass."); 
else 

obj = cl.newInstance(); 


if (null != obj) 
System.out.println( 
"Successfully loaded an instance of SecureClass."); 
} 
catch(Exception e) { 
if (e instanceof ClassNotFoundException) 
System.out.println( 
"Unable to find the specified class."); 
else if (e instanceof InstantiationException) 
System.out.println( 
"Unable to create an instance of the specified class."); 
else if (e instanceof IllegalAccessException) 
System. out.println( 


"Do not have proper access to the class."); 





4. Add a new class called SecureClass, by copying the following code: 


public class SecureClass 


{ 
SecureClass() 
if 
System.out.println( 
"In the constructor of class SecureClass"); 
} 
} 





5. Add a second class called RegularClass, and replace the contents with the following code: 








public class RegularClass 


{ 
RegularClass() 
i 
System.out.print1n( 
"In the constructor of class RegularClass"); 
} 
} 





6. Press F5 to build and run the sample. 


See Also 

Concepts 

Additional Class Library Support 
Other Resources 

Class Library Support 
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Integrating COM Applications with J# 


Component Object Model (COM) is an open software architecture that allows interoperability between an object broker (COM 
server) and object linking and embedding applications (COM clients). This section shows you how to write J# clients to interact 
with a COM server or create your own COM components. For more information, see 

COM: Component Object Model Technologies. 


In This Section 
How to: Reference a COM Object 


Describes how to reuse an existing COM object. 
How to: Generate a COM Component in J# 


Describes how to create a reusable COM component. 


See Also 
Tasks 


How to: Access a COM Component Written in VJ++ 
How to: Create a Component that Runs in the Browser 
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How to: Reference a COM Object 


A COM Object component is executable code contained in a dynamic-link library (.dll) or in an executable (.exe) file. 
Components provide one or more objects and self-contained units of code which perform specific functions within the 
component. Each object has methods, programmed procedures, and properties, behavioral attributes. 


This example demonstrates how Visual J# applications can access COM DLLs using the .NET Framework COM interop 
semantics. 


To reference a COM object 


1. In Solution Explorer, right-click on References and click Add Reference. 
2. Click the COM tab to display a list of registered J++ COM objects or other libraries and controls. 
3. Select the component, and click OK. 


4. From your client jsl file, add an import (Visual J#) statement that references the library. For example: 


import COMSERVERLib.*; 


5. Use the new (Visual J#) keyword to instantiate the object. For example: 


COMServer_DClass cd = new COMServer_DClass(); 


Example 

The following example shows how a Visual J# client can communicate with C+ + COM dispatcher and interface servers. The 
client gets an instance of the COM server and binds to the interface of each server. After the bind, the client begins 
communicating with both servers. Additionally, the client can launch events to COMServer_D, the dispatch server. 


//client.jsl 
import COMSERVERLib.*; 


public class Client { 
public Client() { 


// Create instances of the COM classes. 
COMServer_DClass cd = new COMServer_DClass(); 
IcOMServer_D cdi = (ICOMServer_D) cd; 


COMServer_IClass ci = new COMServer_IClass(); 
IcOMServer_I cii = (ICOMServer_I) ci; 


String greeting = "Ping: COMServer_D"; 
System.out.println(greeting) ; 


// Call a method on a Dispatch interface implemented 
//by COMServer_D CoClass. 
String reply = cdi.ReturnGreeting(greeting) ; 
if (null == reply) 
System.Console.WriteLine("Error: Unmanaged COM server returned a null string"); 
else 
System.Console.WriteLine(" [From Visual J# .NET] " + reply); 


// Call a method on an interface implemented by 
//COMServer_I CoClass. 
greeting = "Ping: COMServer_I"; 
System.out.println(greeting) ; 
reply = cii.ReturnGreeting(greeting) ; 
if (null == greeting) 
System.Console.WriteLine("Error: Unmanaged COM server returned a null string"); 


else 
System.Console.WriteLine(" [From Visual J# .NET] " + reply); 


//Add an event handler for the 'COMEvent' event 

//of the COMServer_D CoClass. 

_ICOMServer_DEvents_COMEventEventHandler eventHandler = new _ICOMServer_DEvents_COM 
EventEventHandler(this.COMEvent) ; 

cd.add_COMEvent(eventHandler) ; 


System.Console.WriteLine("\nCausing COMServer_D to fire an event"); 
cdi.FireCOMEvent(); 
} 


public void COMEvent() { 
System.out.printin(" An event was fired by the COM class COMServer_D"); 


} 


/** @attribute System.STAThread() */ 
public static void main(String args[]) throws java.io.IOException { 
new Client(); 


System.out.println("\nPress the Return key to continue..."); 
System.in.read(); 
} 
} 
//Dispatch ComServer D's code. 
#include "stdafx.h" 
#include "COMServer.h" 
#include "COMServer_D.h" 


LILTLLTTTLLTTTALT LTA LT TT ATT TAT TTA TTT ATTA TTT TT 
// CCOMServer_D 


STDMETHODIMP CCOMServer_D::InterfaceSupportsErrorInfo(REFIID riid) 


{ 
static const IID* arr[] = 
{ 
&IID_ICOMServer_D 
}3 
for (int i=@; i < sizeof(arr) / sizeof(arr[@]); i++) 
{ 
if (InlineIsEqualGUID(*arr[i],riid)) 
return S_OK; 
} 
return S_FALSE; 
} 
STDMETHODIMP CCOMServer_D::ReturnGreeting(BSTR Name, BSTR *Greeting) 
{ 


if (NULL == Name || NULL == Greeting) 
return E_POINTER; 


wprintf(L"\n[Unmanaged COM Server] Received string \"%s\" which I am returning to the c 
lient\n", Name); 

CComBSTR ccb; 

ccb.Attach(Name) ; 

ccb.Append(" Service is available"); 

*Greeting = ccb.Copy(); 

ccb.Detach(); 

return S_OK; 


} 


STDMETHODIMP CCOMServer_D: :FireCOMEvent() 
{ 

Fire_COMEvent(); 

return S_OK; 


STDMETHODIMP CCOMServer_D: :UseCallBack() 


{ 

printf_s(" [UnManaged] Method \"UseCallBack()\" called on the STA object CCOMServer_D" 
)3 

return S_OK; 
} 


//Interface ComServer I's code. 
#include "stdafx.h" 

#include "COMServer.h" 
#include "COMServer_I.h" 


LILTLLTTTLTTTT ALT LT ATT ATLT TAT TTA LTT TTT ATT TTT TTT TTT TAT TTT 
// CCOMServer_I 


STDMETHODIMP CCOMServer_I::InterfaceSupportsErrorInfo(REFIID riid) 
{ 


static const IID* arr[] = 


{ 
}3 


for (int i=@; i < sizeof(arr) / sizeof(arr[@]); i++) 


&IID_ICcOMServer_I 


if (InlineIsEqualGUID(*arr[i],riid)) 
return S_OK; 
} 
return S_FALSE; 
z 


STDMETHODIMP CCOMServer_I::ReturnGreeting(BSTR Name, BSTR *Greeting) 


if (NULL == Name || NULL == Greeting) 
return E_POINTER; 


wprintf(L"\n[Unmanaged COM Server] Received string \"%s\" which I am returning to the c 
lient\n", Name); 

CComBSTR ccb; 

ccb.Attach(Name) ; 

ccb.Append(" Service is available"); 

*Greeting = ccb.Copy(); 

ccb.Detach(); 


return S_OK; 


; 
STDMETHODIMP CCOMServer_I: :FireCOMEvent2() 
{ 
Fire_COMEvent2(); 
return S_OK; 
} 
See Also 
Tasks 
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How to: Generate a COM Component in J# 


COM components provide functionality that you can use in your code to perform specialized tasks. COM components are the 
key to building powerful, real-world applications. The following example shows you how to create a COM component and also 
how a client can use the component. 


To generate a COM Component 


1. On the File menu, point to New, click Project, and then click OK. 

2. In the New Project dialog box, click Class Library, and then in the Name text box, type IClock. 
3. Click OK. 

4. Right-click Solution Explorer, point to Add, and then click Component Class. 

5. In the Name box, type Clock, and click OK. 


6. Replace the contents of the Clock,jsl, with the following code: 


package IClock; 


import System.ComponentModel.*; 
import java.util.Date; 


public class Clock extends System.ComponentModel.Component 
{ 
private System.ComponentModel.IContainer components; 
private long startTime; 
private long stopTime; 
private long elapsedTime; 


public Clock() 


{ 
components = new Container(); 
//Add Clock Client to the component container. 
components.Add(this) ; 
InitializeComponent(); 
} 
public Clock(System.ComponentModel.IContainer container) 
af 
container.Add(this) ; 
InitializeComponent() ; 
} 
public void Start() 
{ 
System.out.printin("Starting the timer"); 
startTime = (new Date()).getTime(); 
} 


public long Stop() 

{ 
System.out.printin("Halting the timer"); 
stopTime = (new Date()).getTime(); 
elapsedTime = stopTime - startTime; 
Dispose(true) ; 
return elapsedTime; 


#region Component Designer generated code 
protected void Dispose(boolean disposing) 


{ 
//Remove Clock from the container. 
if (disposing) 
{ 
if (components != null) 
< 
components .Dispose(); 
} 
} 
//Dispose of the container itself. 
super.Dispose(disposing) ; 
} 
private void InitializeComponent() 
{ 
this.components = new System.ComponentModel.Container(); 
} 
#endregion 


7. Press F5 to compile the COM Server. 


To generate and register a type library 


1. Open a command line and type, tlbexp Clock.dll. 
2. Register the assembly to run locally by typing, regasm Clock.dll 
-Or- 


Register the assembly to run in the Global Assembly Cache (GAC) by typing, gacutil /i Clock.dll 


To build the client code 


1. From Visual Studio, on the File menu, point to New, and then click New Project. 

2. In the New Project dialog box, select Console Application, and in the Name box, type ClockClient. 
3. In the Solution Name box, select ConsoleApplication1, and type ClockClient. Click OK. 

4. In Solution Explorer, right-click ClockClient, and then click Add Reference. 

5. Click the Browse tab, and add the Clock.dll as COM server. 


6. In the Clockjsl file, replace the existing code with the following code: 


package ClockClient; 


import System.*; 
import IClock.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
Clock myclock = new Clock(); 
myclock.Start(); 
for (int idx = @; idx < 5000; idx++) 
{ 


//Generate some clock cycles. 


} 
long sysClock = myclock.Stop(); 
System.out.println("Time elapsed since you added and removed as a COM componen 


t " + sysClock + " milliseconds"); 


} 


7. Press F5 to compile and run your application. 


8. As the application runs, you can set various breakpoints on the COM server to see how myClock moves in and out of the 
container. 


Robust Programming 
Each time you add or change methods in the COM component, you must re-export and re-register the assembly using the 


tlbexp, and regasm or GAC utilities. 


See Also 
Tasks 
How to: Reference a COM Object 
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Compiling J# Applications 


You can compile J# source code to either executable (.exe) or dynamic link library (DLL) assemblies. Once compiled, the binary 
assemblies reside in either the bin\debug or bin\release directory, depending on your compiler switch settings. 


There are various ways to build your assemblies: 


Clicking Build Solution on the Build menu, or pressing CTRL+SHIFT, B, compiles one or more projects in the order that 
they are displayed in Solution Explorer or based on project dependencies that you specify. 


Clicking Build <project> on the Build menu compiles only the project that you select from Solution Explorer. 


Clicking Start Debugging on the Debug menu, or pressing F5, causes the program to be compiled with debugging 
symbols and information, and invokes your application in debug mode. 


Clicking Start Without Debugging on the Debug menu, or clicking CTRL+F5 compiles changes, if there are any, and 
starts your executable. 


Additionally, you can use the traditional command line switches to invoke the compiler. For example: 


vjc myProgram.jsl 


See Also 

Reference 

Building from the Command Line (Visual J#) 
Other Resources 

Visual J# Compiler Options Listed Alphabetically 
Compiler Errors VJSO001 Through VJS9999 


Visual J# Concepts 


Accessing Data with J# 


You can create robust local and remote database applications using the Java Database Connectivity DBC) interface. JDBC is 
programming framework for Java developers writing programs that access information from databases, spreadsheets, and flat 
files. JDBC is commonly used to connect a user program to a "behind the scenes" database, regardless of the database 
management software that controls the database. 


J# comes with JDBC-ODBC bridge that can be used to connect to any database that has a ODBC client connectivity support. 
Suitable driver shall be installed and also a ODBC DSN shall be configured on client computer for J# application to connect to 
database. 


In This Section 
How to: Use JDBC in an Application 


Describes how to access data using the Level 4 JDBC driver. 


See Also 
Other Resources 


Common Programming Tasks 


Visual J# Concepts 


How to: Use JDBC in an Application 


A Java database connection (JDBC) is a database driver that enables you to connect to a database programmatically. You use 
the connection as a bridge between your application and the actual database. 


Visual J# comes with an implementation of JDBC on top of ODBC [JDBC-ODBC bridge]. This bridge can provide application a 
way to connect to any database server having ODBC driver installed on client computer with Visual J#. 


The first step sets up a data source name (DSN) for managing user ID and password credentials on the Northwind Access 
database. The second step uses the DSN and the JdbcOdbcDriver to connect to the database, and return data. The code names 
the driver, Class. forName ("com.ms.jdbc.odbc.JdbcOdbcDriver"), and builds a connection string that names the DSN with 
server and authentication credentials, as follows: String url = "jdbc:odbc:vbuetools"; 


The last example executes the query. Using the while (rs.next()) statement, the code spins through the result sets and grabs 
the data. Once the data prints to the console, the con.close() statement closes the record set and drops the database 
connection. 


To set up a data source name 


1. Click Start, point to Control Panel, point to Administrative Tools, and then click Data Sources (ODBC). 
2. From the Administrative Tools screen, select Data Sources. 

3. On the ODBC Data Source Administrator page, click the System DSN tab, and click Add. 

4. On the Create New Data Source page, select Driver do Microsoft Access (*.mdb), and click Finish. 


This indicates the type of database. For your own applications, be sure to choose the driver that matches your database. 
In the case of SQL Server, scroll through the list and choose the driver that matches your version of SQL server. 


5. On the ODBC Microsoft Access Setup page, in the Data Source Name box, type JDBCdsn, and click Select. 
6. Select the Northwind.mdb, and click OK. 


7. On the Microsoft SQL Server DSN Configuration page, click With Windows NT authentication using the network 
login ID. 


This option enables you to access the data using your NT user ID and password. 
8. Click Next. 
9. Verify the connection, and click OK. 


The ODBC Administrative Tool stores the server name and credentials in the JDBCdsn.dsn binary file. At run time, your J# 
code accesses this information for connecting to the database. 


To access the data 


1. On the File menu, point to New, and click Project. 
2. Click Console Application, and in the Name box, type JDBC2. 


3. Replace the contents of the Program,jsl with the following code: 


import java.*; 

import java.sql.*; 

import java.util.*; 

import com.ms.jdbc.odbc.JdbcOdbcDriver ; 
public class Connect{ 


private java.sql.Connection con = null; 
private ResultSet rs; 


// Constructor: 
public Connect(){} 


private void FindEmployee() throws SQLException, ClassNotFoundException 
try 


Class.forName("com.ms.jdbc.odbc.JdbcOdbcDriver") ; 
String url = "jdbc:odbc:JDBCdsn"; 
con = DriverManager.getConnection(url, "", ""); 
Statement stmt = con.createStatement(); 
rs = stmt.executeQuery("Select EmployeeID, LastName, Title from Employees 
")3 
while (rs.next()) 
{ 
//Column names: 
System.out.printlin(rs.getInt("EmployeeID") + 
ame") + " " + rs.getString("Title")); 
} 
if(con != null) 
con.close(); 
con = null; 


+ rs.getString("LastN 


} 
catch (SQLException ex) 


{ 
throw ex; 
} 


catch (ClassNotFoundException clex) 


{ 


throw clex; 


private void closeConnection(){ 
try{ 
if(con != null) 
con.close(); 
con = null; 
}catch(Exception ex){ 
ex.printStackTrace(); 


public static void main(String[] args) throws Exception 
{ 
Connect myDbTest = new Connect(); 
try 
{ 
myDbTest.FindEmployee() ; 


} 


catch (Exception ex) 


{ 


ex.printStackTrace(); 
System.out.println("Error Trace in getConnection() : 


+ ex.getMessage()); 


w 


4. In the code you just added, verify that the data source name matches the one you created with the Administrative Tools. 
For example: 


String url = "jdbc:odbc: JDBCdsn"; 


5. Press F5 to compile and run the code. 


The program fetches each employee serial number, last name, and title from the Employees table of the Northwind 
database. 


Security 


For convenience, the database name can be stored in the DSN configuration. Proper care must be taken by the application to 
not hard code or store credentials in unsafe locations or less secure ways. For Web applications, be sure to encode, encrypt, or 
hash user IDs, passwords, and other database information. 


See Also 
Other Resources 


Access Modifiers (Visual J#) 


Visual J# Concepts 


Managing J# Projects 


Visual J# projects help you manage your application code and accompanying resources such as string tables and forms. 


In This Section 
How to: Set Versioning for the Visual J# Redistributable 


Describes how to change project properties to control application versioning. 


See Also 
Other Resources 


Upgrading to J# 


Visual J# Concepts 


How to: Set Versioning for the Visual J# Redistributable 


When distributing various classes as a single J# assembly, you do not need a Java Archive JAR) manifest to describe its contents. Instead, you can set the 
version, as well as other information, from within your Visual Studio project. With each new release of your application, you can simply change the 
AssemblyVersion parameter on the @assembly attribute. The following procedure shows you how to change your application or library's version number. 


To change the software version for your application 


1 
2. 


On the File menu, point to Open, and click Project/Solution. 


Select your project name, and click Open. 


. In Solution Explorer, click the AssemblyInfo,jsl. 


. Inthe AssemblyInfojsl file, search for and update the version information in the @AssemblyVersion parameter. For example: 


/** @assembly AssemblyVersion("2.1.0") */ 


. Press F5 to recompile your application. 


Your project compiles, and the current version information that you defined in the AssemblyVersion parameter is displayed on the application's 
Properties tab. 


. From Windows Explorer, find the assembly in your project's bin\debug or bin\release directory. 


. On the executable (.exe) or library (DLL) name, right-click Properties. 


The Properties window opens with general, version, security, and summary information. 


. Click the Version tab, and review the Value box next to Assembly Version. 


The version number you specified in the AssemblyVersion parameter is displayed. For example, 2.1.0. For more information, see 
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpref/html/frlrfSystemReflectionAssemblyCopyrightAttributeClassCopyrightTopic.asp. 


See Also 
Other Resources 


Migrating from Java 
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Managing Serialization with J# 


Serialization is the process of storing the state of an object or a portion of its members for use by another application or 
instance. Visual J# supports two modes of binary serialization. You can either serialize by implementing the traditional 
java.io.Serializable interface, or you can use the BinaryFormatter class from the .NET Framework. 


In This Section 
How to: Serialize My J# Class as Binary 


Describes how to store data temporarily for future use. 
How to: Deserialize Java Serialized Objects from the .NET Framework 
Describes how to store and retrieve data between various class instances. 
How to: Enable NET Framework Serialization on a Java Application 
Describes how to use the .NET Framework for binary serialization. 
How to: Convert Java Serialized Objects (.ser) to .NET Framework Serialized Objects 
Describes how to convert an existing serialized application to NET Framework for binary serialization. 
How to: Write a Custom Serializer for a J# Class Using the INET Framework 


Describes how to create a custom serializer that enables you to control the class member data that you would like to 
serialize. 


Related Sections 


Common Programming Tasks 


Visual J# Concepts 


How to: Serialize My J# Class as Binary 


Serialization is the process of storing the state of an object or a portion of its members for use by another application or 
instance. Binary serialization is a means of storing the data in a binary representation. 


For example, you can share an object between different applications by serializing it to the Clipboard. You can serialize an 
object to a stream, to a disk, to memory, over the network, and so forth. You can also use binary serialization to remotely pass 
objects by value from one computer or application domain to another. 


Your serializable class must: 
e Implement the java.io.Serializable interface. 
e Contain a public default constructor that takes no parameters. 


e Identify the fields that should be serializable, use the serialPersistentFields member to explicitly declare them 
serializable, or use the transient keyword to denote nonserializable fields. 


The following examples show you how to use binary serialization. The first example demonstrates that serialization can be 
automatic when you implement the Serializable interface. The second example shows you how to direct serialization to a 
specific file. Each example stores the data in a local directory. 


To serialize a simple class 


1. Create a console application, and name it Serialization. 


2. In Solution Explorer, make sure Program,jsl is selected, and then replace the code with the following: 


package Serialize; 


public class Address implements java.io.Serializable 


{ 
//Default CTOR Required for Serialization. 
public Address() { } 
public String Street; 
public String City; 
public String Region; 
public String PostalCode; 
public static void main(String[] args) 
{ 
Address customerAddress = new Address(); 
customerAddress.Street = "1111 White Street"; 
customerAddress.City = "Sturtevant"; 
customerAddress.Region = "WI"; 
customerAddress.PostalCode = "53177"; 
} 
} 


3. Click File, and then click SaveAll to store the project. 
4. Press F5 to compile and run the code. 
5. Review the serialization binary output in the following directory: Serialization\obj\ResGen.cache. 


Because the class implemented serialization, the common language runtime (CLR) automatically stores the serialized 
data in the ResGen.cache directory. 


To serialize to a specific output file 


1. Create a second console application, and name it Serialization2. 


2. In Solution Explorer, make sure Program,jsl is selected, and then replace the code with the following: 


package Serialize2; 
import java.io.*; 


public class Address implements Serializable 

{ 
//Default CTOR Required for Serialization. 
public Address() { } 


public String Street; 
public String City; 
public String Region; 
public String PostalCode; 


public void CacheAddress() 
{ 
try 
{ 
// Narious address checks should be put here: 
if (this.Street.length() > @) 
{ 
FileOutputStream fout = new FileOutputStream("serial.bin"); 
ObjectOutputStream out = new ObjectOutputStream(fout) ; 
//This is where the serialization takes place: 
out.writeObject(this) ; 
out.flush(); 
out.close(); 


F 
} 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
public Address RetrieveAddress() 
{ 
Address address2 = new Address(); 
try 
{ 


FileInputStream fi = new FileInputStream("serial.bin"); 
ObjectInputStream fs = new ObjectInputStream(fi); 
// Deserialazation: 
address2 = (Address)fs.readObject(); 
fs.close(); 
} 
catch (Exception ex) 


{ 
System.out.printin(ex.toString()); 


} 


return address2; 


public String toString() 


return + Street + + City + + Region + " " + PostalCode; 


public static void main(String[] args) 

sf 
Address customerAddress = new Address(); 
customerAddress.Street "1111 White Street"; 
customerAddress.City = "Sturtevant"; 
customerAddress.Region "WI"; 
customerAddress.PostalCode = "53177"; 
customerAddress.CacheAddress(); 


Address cachedAddress = new Address(); 
cachedAddress = customerAddress.RetrieveAddress(); 
System.out.println(cachedAddress.toString()); 


3. Click File, and then click Save All to store the project. 

4. Press F5 to compile and run the code. 
Serialization occurs while the CLR is executing the out .writeObject (this) ; statement. 
The console output is 1111 White Street Sturtevant WI 53177 

5. Review the serialization binary output in the following directory: Serialization2\bin\debug\serial.bin. 
Because the example uses the ObjectOutputStream statement without a full path, the binary is located in the debug 
directory. 

Robust Programming 
e The fields that you want serialized cannot have a static or transient access level. 
e If performance is an issue, use binary serialization instead of XML serialization. 


e Where appropriate, be sure to use the special serialization Javadoc tags @serial and @serialData to describe the 
serialized object. For more information, see How to: Generate XML Documentation from Javadoc Comments. 


Security 


For security purposes, do not include a user ID, password, or other confidential information in your serialized classes. 


See Also 
Other Resources 


Serialization Concepts 
Binary Serialization 


Visual J# Concepts 


How to: Deserialize Java Serialized Objects from the .NET 
Framework 


Deserialization is the process of retrieving stored data that an application previously persisted. Once retrieved, the common 
language runtime (CLR) maps the data to an instantiated object with identical fields. 


When you are deserializing: 


e Your class should have a default constructor — a constructor that takes no parameters — in order to be serialized. 
e You must cast the deserialized data to a class that matches the order of the serialized data. 
e Serialization occurs only on public data. 


e Aruntime exception occurs when the data types of the deserialized data do not match the class that receives the data. 


The following example caches application information by serializing and deseriailizing basic customer information. 
To deserialize data 


1. Create a console application called BinaryFormatter. 


2. In Solution Explorer, click Program,jsl, and then replace the codewith the following: 


package BinaryFormatter ; 

//Serialize, and then deserialize. 

import System.I0.*; 

import System.Runtime.Serialization.*; 

import System.Runtime.Serialization.Formatters.Binary.*; 


/** @attribute System.SerializableAttribute() */ 
public class Address 
{ 
//Default CTOR Required for serialization. 
public Address() { } 


public String Street; 
public String City; 
public String Region; 
public String PostalCode; 


public void CacheAddress() 
{ 
try 
{ 
// Narious address checks go here: 
if (this.Street.length() > @) 


{ 
FileStream fs = new FileStream("serial.text", FileMode.OpenOrCreate) ; 
BinaryFormatter bf = new BinaryFormatter(); 
//Serialization starts here. 
bf.Serialize(fs, this); 
fs.Flush(); 
fs.Close(); 
} 
} 
catch (IOException ex) 
{ 


System.out.println(ex.toString()); 


} 
public Address RetrieveAddress() 


sf 

Address address2 = new Address(); 

try 

x 
FileStream fs = new FileStream("serial.text", FileMode.Open) ; 
BinaryFormatter bf = new BinaryFormatter(); 
//Deserialization starts here. 
address2 = (Address)bf.Deserialize(fs); 
fs.Close(); 

} 

catch (Exception ex) 

sf 
System.out.printlin(ex.toString()); 


} 


return address2; 


public String toString() 


return + Street + + City + + Region + " " + PostalCode; 


public static void main(String[] args) 

{ 
Address customerAddress = new Address(); 
customerAddress.Street = "1111 White Street"; 
customerAddress.City = "Sturtevant"; 
customerAddress.Region "WI"; 
customerAddress.PostalCode = "53177"; 
customerAddress.CacheAddress(); 


Address cachedAddress = new Address(); 
cachedAddress = customerAddress.RetrieveAddress(); 
System.out.println(cachedAddress.toString()); 


3. Press F5 to compile and run the program. 
The data successfully stores and then retrieves the address. The output is: 1111 White Street Sturtevant WI 53177. 


4. From the BinaryFormatter\bin\debug\ directory, view the serial.bin file. 


See Also 

Tasks 

How to: Serialize My J# Class as Binary 
Other Resources 

Serialization Concepts 

Binary Serialization 
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How to: Enable .NET Framework Serialization on a Java 
Application 


You can use the .NET BinaryFormatter class and custom attributes to control INET Framework serialization. This class stores 
data for other classes in a more secure, non-viewable format. 


The following examples show you how to serialize or store J# application data. The first example demonstrates how to use the 
code /** @attribute System.SerializableAttribute() */ to store data for an entire class. 


The second example shows serialization for just one or more class members by demonstrating the @attribute 
System.AttributeUsageAttribute. Using the valueon parameter, you can also serialize other application elements such as 
constructs, return values, and events. 


For additional information, see AttributeTargets. 


To store data for an entire class 


1. Create a console application called BinaryFormatter. 


2. In Solution Explorer, click Program,js!, and replace the code with the following: 


package BinaryFormatter ; 


import System.I0.*; 
import System.Runtime.Serialization.*; 
import System.Runtime.Serialization.Formatters.Binary.*; 


/** @attribute System.SerializableAttribute() */ 
public class Address 
{ 
//Default CTOR Required for Serialization. 
public Address() { } 


public String Street; 
public String City; 
public String Region; 
public String PostalCode; 


public void CacheAddress() 


{ 
try 
{ 
// Narious address checks go here. 
if (this.Street.length() > @) 
{ 
FileStream fs = new FileStream("serial.text", FileMode.OpenOrCreate) ; 
BinaryFormatter bf = new BinaryFormatter(); 
//Serialization starts here. 
bf.Serialize(fs, this); 
fs.Flush(); 
fs.Close(); 
i; 
li 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
r 
i 


public Address RetrieveAddress() 


Address address2 = new Address(); 

try 

{ 
FileStream fs = new FileStream("serial.text", FileMode.Open) ; 
BinaryFormatter bf = new BinaryFormatter(); 
//Deserialization starts here. 
address2 = (Address)bf.Deserialize(fs); 
fs.Close(); 

} 

catch (Exception ex) 

{ 
System.out.printin(ex.toString()); 


} 


return address2; 


public String toString() 


return + Street + + City + + Region + " " + PostalCode; 


public static void main(String[] args) 

{ 
Address customerAddress = new Address(); 
customerAddress.Street "1111 White Street"; 
customerAddress.City = "Sturtevant"; 
customerAddress.Region "WI"; 
customerAddress.PostalCode = "53177"; 
customerAddress.CacheAddress(); 


Address cachedAddress = new Address(); 
cachedAddress = customerAddress.RetrieveAddress(); 
System.out.println(cachedAddress.toString()); 


3. Press F5 to compile and run the program. 


4. From the BinaryFormatter\bin\debug\ directory, view the serial.bin file. 


To serialize just a variable 


1. Create a console application called SerializeSomeParms. 


2. Replace the contents of Program,jsl with the following code: 


//** @attribute System.AttributeUsageAttribute(ValidOn = Parameter, AllowMultiple 
lse, Inherited = true) */ 

package SerializeSomeParms; 

//AttributeUsageAttribute(ValidOn = Parameter 


import System.I0.*; 
import System.Runtime.Serialization.*; 
import System.Runtime.Serialization.Formatters.Binary.*; 


public class Address 
{ 
//Default CTOR Required for Serialization. 
public Address() { } 
//** @attribute System.AttributeUsageAttribute(ValidOn = Parameter, AllowMultiple 


Ilse, Inherited = true) */ 
public String Street; 
public String City; 
public String Region; 


public String PostalCode; 


public void CacheAddress() 


{ 
try 
{ 
// Narious address checks go here. 
if (this.Street.length() > @) 
{ 
FileStream fs = new FileStream("serial.bin", FileMode.OpenOrCreate) ; 
BinaryFormatter bf = new BinaryFormatter(); 
//Serialization starts here. 
bf.Serialize(fs, this.Street); 
fs.Flush(); 
fs.Close(); 
: 
} 
catch (IOException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 
public String RetrieveStreet() 
{ 
String Street = new String(); 
try 
{ 
FileStream fs = new FileStream("serial.bin", FileMode.Open) ; 
BinaryFormatter bf = new BinaryFormatter() ; 
//Deserialize just the street; otherwise, 
//a runtime error occurs. 
Street = (String)bf.Deserialize(fs); 
fs.Close(); 
} 
catch (Exception ex) 
{ 
System.out.printin(ex.toString()); 
} 
return Street; 
} 
public static void main(String[] args) 
{ 


Address customerAddress = new Address(); 
customerAddress.Street "1111 White Street"; 
customerAddress.City = "Sturtevant"; 
customerAddress.Region "WI"; 
customerAddress.PostalCode = "53177"; 
customerAddress.CacheAddress(); 


String street = (String) customerAddress.RetrieveStreet(); 
System.out.println(street) ; 





Notice that the @attribute System.AttributeUsageAttribute is set to save just the Street data. 
3. \Press F5 to compile and run the program. 


4. Verify that the console application returns the street address, 1111 White Street. 


See Also 
Tasks 


How to: Deserialize Java Serialized Objects from the .NET Framework 


Visual J# Concepts 


How to: Convert Java Serialized Objects (.ser) to .NET 
Framework Serialized Objects 
The following examples show you how to convert a Java serialized application to a Visual J# application with .NET Framework 
serialized objects. 
To covert from Java to .Net Framework serialization 
1. Create a console application called ConvertSerialization. 


2. In the Program sl file, copy the following Java code. 


package ConvertSerialization; 
import java.io.*; 


public class Address implements Serializable 

{ 
//Default CTOR Required for Serialization. 
public Address() { } 


public String Street; 
public String City; 
public String Region; 
public String PostalCode; 


public void CacheAddress() 


{ 
try 
{ 
// Narious address checks go here. 
if (this.Street.length() > @) 
af 
FileOutputStream fout = new FileOutputStream("serial.bin"); 
ObjectOutputStream out = new ObjectOutputStream(fout) ; 
//Serialization starts here. 
out.writeObject(this) ; 
out.flush(); 
out.close(); 
} 
} 
catch (IOException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 
public Address RetrieveAddress() 
{ 
Address address2 = new Address(); 
try 
{ 


FileInputStream fi = new FileInputStream("serial.bin"); 
ObjectInputStream fs = new ObjectInputStream(fi); 

address2 = (Address)fs.readObject(); //Deserialazation starts here. 
fs.close(); 


} 


catch (Exception ex) 


System.out.println(ex.toString()); 


} 
return address2; 

} 
public String toString() 

si 
return "" + Street + " "+ City + " " + Region + " " + PostalCode; 

} 

public static void main(String[] args) 

1 
Address customerAddress = new Address(); 
customerAddress.Street = "1111 White Street"; 
customerAddress.City = "Sturtevant"; 
customerAddress.Region = "WI"; 
customerAddress.PostalCode = "53177"; 
customerAddress.CacheAddress(); 

} 








. Replace the import statement, import java.io.*;, with the following J# code: 





import System.I0.*; 
import System.Runtime.Serialization.*; 
import System.Runtime.Serialization.Formatters.Binary.*; 








These packages control how data can be serialized at run time. 


. Add T:System.SerializableAttribute, and update the class declaration to read: 





/** @attribute System.SerializableAttribute() */ 


public class Address 





The custom attribute, SerializableAttribute, stores data for the entire class. Also notice that you are no longer 
implementing the Java Serialization class. Instead, you are instantiating the BinaryFormatter class to serialize the data. 


. Replace the FileOutputStream fout = new FileOutputStream("serial.bin") statement with a similar FileStream 
statement: 





FileStream fout = new FileStream("serial.bin", FileMode.OpenOrCreate) ; 





The FileMode.OpenOrCreate enum states that you want the application to open either an existing file named serial.bin, 
or create a new one if none exists. 


. Replace the objectOutputStream out = new ObjectOutputStream(fout) ; Statement with the BinaryFormatter 


statement: 





BinaryFormatter out = new BinaryFormatter(); 





This line of code instantiates the BinaryFormatter class that performs the actual serialization of data on the input/output 
stream. 


. Replace the out .writeObject (this) ; statement with the following code: 


//Serialization: 


out.Serialize(fout, this); 





While the program is running, serialization occurs at this step. The this keyword indicates that all of the data in the 
CacheAddress class will be serialized. 


8. Capitalize the flush and close method names as follows: 


fout.Flush(); 
fout.Close(); 


9. On the File menu, click Save All to save the project. 
10. Compile and run the converted program. 


The BinaryFormatter class stores the ConvertSerialization\bin\debug\serial.bin file. 


To convert to .NET Framework deserialization 


1. Open the ConvertSerialization project, if it is not already open. 


2. At the end of the Address () constructor, add a Java RetrieveAddress method that contains deserialization code. 


public Address RetrieveAddress() 


Address address2 = new Address(); 
try 
{ 
FileInputStream fi = new FileInputStream("serial.bin"); 
ObjectInputStream fs = new ObjectInputStream(fi); 
address2 = (Address)fs.readObject(); //Deserialazation starts here. 
fs.close(); 
} 
catch (Exception ex) 
{ 
System.out.println(ex.toString()); 
} 
return address2; 
i 
public String toString() 
{ 
return "" + Street + " "+ City + " " + Region + " " + PostalCode; 
} 


3. Replace the stream classes with the following code: 


FileStream fs = new FileStream("serial.bin", FileMode.Open) ; 
BinaryFormatter bf = new BinaryFormatter(); 

//Deserialize here. 

address2 = (Address)bf.Deserialize(fs); 

fs.Close(); 


An instance of FileStream will try to open the stored data from seral.bin. If it fails, the Exception catch block handles 
the error. In addition, the Deseserialize method requires a class cast to the Address class in order to marshal the data 
correctly to each field. 


4. To verify the output, add the following code to main: 





Address cachedAddress = new Address(); 
cachedAddress = customerAddress.RetrieveAddress(); 


System.out.println(cachedAddress.toString()); 





5. Press F5 to compile and run the code. 


The console output shows an address of 1111 White Street Sturtevant WI 53177. 


See Also 
Tasks 
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How to: Write a Custom Serializer for a J# Class Using the .NET 
Framework 


A customized serializer enables you to control the class member data that you would like to serialize. This is particularly helpful 
when applications store precise data. This class has various helpful methods to store native data types. 


The following example shows you how to use the Externalizable class to store and retrieve GPS coordinates. The 
readDouble and writeDouble methods ensure precision on the map coordinates. 


To write a custom serializer 


1. On the File menu, point to New, and then click Project. 
2. Click Console Application, and in the Name box, type CustomSerial. 


3. In Solution Explorer, click Program,jsl, and replace the code with the following: 


package CustomSerial; 
import java.io.*; 


class CustomSerial implements Externalizable 


{ 


double XCoordinate; 
double YCoordinate; 


public CustomSerial() { } 


public CustomSerial(double Latitude, double Longitude) 
{ 


this.XCoordinate = Latitude; 
this.YCoordinate = Longitude; 


//Stores the data. 
public void writeExternal(ObjectOutput out) throws IOException 
{ 


out.writeDouble(XCoordinate) ; 
out.writeDouble(YCoordinate) ; 


//Reconstructs the data to an object. 
public void readExternal(ObjectInput in) throws IOException 


{ 
XCoordinate = in.readDouble(); 
YCoordinate = in.readDouble(); 
} 
public String toString() 
{ 
return "A{" + 
"x="_4 XCoordinate + ", y=" + YCoordinate + 
"HS 
} 
public static void main(String[] args) 
{ 


try 
{ 


FileOutputStream fout = new FileOutputStream("serial.bin"); 
ObjectOutputStream out = new ObjectOutputStream(fout) ; 
CustomSerial GPSCoordinates = new CustomSerial(-42.064478, 19.2179124) ; 


//Serialize with custom serializer. 
GPSCoordinates.writeExternal (out) ; 
out.flush(); 

out.close(); 


FileInputStream fin = new FileInputStream("serial.bin"); 
ObjectInputStream in = new ObjectInputStream( fin) ; 


//Deserialize here. 
GPSCoordinates.readExternal(in) ; 
System.out.println("Retrieving Stored coordinates as 


+ GPSCoordinates.to 


String()); 
in.close(); 
} 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 


4. Press F5 to compile and run the application. 


5. On the console output, verify that the deserializer retrieved both input values accurately by comparing them to the input 
values in the program The output is "Retrieving Stored coordinates as 42.064478 19.2179124." 


Subtle data errors can occur from customized serializers. In the previous example, if your serializer stored a double and 
then an int, be sure to read the double first, and then the int; otherwise, the data might not display correctly. Likewise, in 
the previous example, if the values were reversed, the coordinates would point to a completely different place on a map. 


If you want subclassed data serialized, be sure to make them externalizable also; otherwise, the subclassed data will not 
be serialized. 


See Also 
Other Resources 


Serialization Concepts 
Binary Serialization 
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Upgrading to J# 


This section shows you how to upgrade and integrate J++ applications with Visual J#. 


In This Section 
How to: Convert a Visual J++ Project 


Describes how to open a project in Visual J# Professional or Express. 
How to: Upgrade a J++/ActivexX Application 

Describes how to convert a J++ ActiveX application to Visual J#. 
How to: Access a COM Component Written in VJ++ 


Describes how to reuse J+ + components in your new Visual J# applications. 


See Also 
Concepts 
Visual J# Migration 


Visual J# C 


‘oncepts 


How to: Convert a Visual J++ Project 


Visual J# includes the Visual J# Upgrade and Conversion Wizards to assist you in converting your projects from Visual J++ 6.0 


toV 


isual J#. The following example shows you how to open and convert your own Visual C++ project. First the J# Upgrade 


Wizard creates the project framework. Then the Conversion wizard compiles the application based on the project type you 
select. 


To open a Visual J++ project 


1 


2. 


. On the File menu, click Open Project. 
From the Open Project window, choose the project (.vjp) or solution (.sIn) you want to convert, and click Open. 


The Visual J# Conversion Wizard Welcome window Is displayed. 


3. Click Next. 

4. In the Location for Backup field, identify the directory where the Upgrade Wizard can store your original project. Click 
Next. 
It is helpful to store the backup in the same directory as the project that you are converting. 

5. Click Finish. 
The Visual J# Conversion Wizard automatically converts the project to Visual J# and provides the status of 
the conversion. 

6. If errors occur during the conversion, click on the link to review the errors and remarks. 
-or- 
Click Close. 

7. After the conversion completes, on the Project menu, click Project Reload. 
The project refreshes with the new J# project, and starts the J# Upgrade Wizard. 

8. On the Upgrade Wizard Welcome page, click Next. 

9. On the Choose Project Type page, select Console Application, Windows Application, or Class Library to compile 
the type of application you want. Click Next. 

10. On the Add References to Project page, click Browse to create links to any INET Framework or COM libraries that your 
application uses. 
11. Click Next, and then click Finish. 
The compiler builds the assembly and places it in the bin\debug directory. 
See Also 
Tasks 


How to: Create a Visual J# Project from Existing J++ Code 


How to: Upgrade a Visual J++ 6.0 Project 
Other Resources 
Upgrading from Visual J++ 6.0 
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How to: Upgrade a J+ +/ActiveX Application 


The Visual Studio Conversion Wizard converts your J++ ActiveX projects to Visual J#. Before converting the project, consider 
the following recommendations: 


e If your application is stored in a source code repository, be sure that the files are available, because the wizard 
automatically checks them out during the conversion. 


e Allow the wizard to make the necessary backup files, because once the conversion completes, the project or solution will 
no longer load in the previous version of Visual Studio. 


The following instructions show you how to convert your own projects. 


To upgrade a project 


1. If the files are in a repository, be sure that all project files, and application source code are checked in. 
2. From Solution Explorer, point to Open, and click Project Solution. 
3. In the Open Project window, select the project file (.vjp) or solution file (.sIn) you want to upgrade, and click Open. 


The Visual Studio Conversion Wizard starts, and reminds you that once the conversion completes, the project or 
solution will no longer load in the previous version of Visual Studio. 


4. Click Next. 


5. On the Choose Whether to Create a Backup page, click Yes to store copies of the original project. If your project is in 
source code control and extra copies are not necessary, click No. 


6. On the Ready to Convert page, review the summary task list. Use the Back button to correct the backup location if 
necessary. 


If the solution, project, or code is under source code control, the wizard checks out the appropriate files and makes the 
necessary backups if applicable. The wizard converts the .vpn project information to a new .vjproj project file and updates 
the solution file. 


7. Click Close. 


8. On the Build menu, click Build Solution to recompile your application to a Visual J# application. 


See Also 
Other Resources 


Migrating from Java 
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How to: Access a COM Component Written in VJ++ 


Common Object Model (COM) objects provide a great way to encapsulate functionality and reuse it across multiple 
applications. You can use COM objects to expose specific functionality within your application. For example, you can create a 
set of routines that you want to use in more than one application. 


Because COM is not language-specific, COM objects can be easily integrated into applications developed in a variety of 
programming languages. You can use Visual J# to view and import COM objects that are registered on your system. During 
the import process, Visual J# creates class wrappers so that you can access COM objects just as you would other objects. 


The following example shows you how to create a reference to a COM component in your project. 


To import a COM component 


1. From Solution Explorer, right-click on References and select Add Reference. 
2. Click the COM tab to display a list of registered COM objects or other libraries and controls. 
3. Select the component you want to import, and click OK. 
The component is displayed in the list of references in Solution Explorer. 
4. To access the COM component in your J# application, add the appropriate import (Visual J#) statement, such as import 


ClockComponent. 


See Also 
Tasks 


How to: Generate a COM Component in J# 
How to: Reference a COM Object 
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Web Programming with J# 


While creating Web pages, you can use the Toolbox for adding graphical components to a form. This section shows you how to 
create and add your own components to the Toolbox. 


In This Section 
How to: Create a Component that Runs in the Browser 


Describes how to create a component that is displayed in the Toolbox for Web page development. 


Related Sections 
How to: Access a COM Component Written in VJ++ 


Visual J# Tasks 
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How to: Create a Component that Runs in the Browser 


Components are reusable libraries that inherit from System.ComponentModel.Component. You can use components in the 
same way as other libraries. 


The following example shows you how to create a library component, add it to a Web page, and deploy the component on a 
Web site. The Web page (.aspx) requests a street address for the South African corporate office. When the component receives 
this request, it returns the address for a company's Cape Town branch. 


To create the component 


1. 


2. 


From the File menu, point to New, and then click Project to open the New Project dialog box. 


In the New Project dialog box, select the Class Library project template from the list of J# Projects, and type 
BrowserComponent in the Name box. 


. On the Project menu, click Add Component. 


. In the Add New Item dialog box, select Component Class and type BrowserComponentjsl in the Name box. 


A component named BrowserComponentjsl is added to your class library. 


. In Solution Explorer, right-click BrowserComponentjsl, and click View Code. 


The code editor opens. Notice that System.ComponentModel.Component is displayed immediately after public class 
BrowserComponent. By default, a component inherits from the Component class provided by the system. The 
Component class provides many features for your component, including the ability to use designers. 


. In Solution Explorer, right-click Class1 jsl, and click Delete. This removes the default class for the class library, because 


you will not be using it for this particular component. 


. On the File menu, click Save All to save the project. 


. In BrowserComponentsl, add the following method: 


public String[] GetCompanyAddress(int CorpCode) throws IllegalArgumentException 


{ 
String Address[]; 


switch (CorpCode) 


{ 

case @: 
Address = new String[4]; 
Address[@] = "1234 White Street"; 
Address[1] = "Sturtevant"; 
Address[2] = "WI"; 
Address[3] = "53177"; 
break; 

case 1: 


Address = new String[4]; 
Address[@] = "oltke Moes vei 39"; 
Address[1] = "0852"; 
Address[2] = "OSLO"; 
break; 

case 2: 
Address = new String[3]; 
Address[@] = "Parliament Street"; 
Address[1] = "Cape Town"; 
Address[2] = "S. Africa"; 
break; 

default: 
throw new IllegalArgumentException(); 


return Address; 


This method supplies the appropriate customer service location based on a ficitious corporate code. A case statement 
manages the content to return. 


9. On the Build menu, click Build Solution. 


The library compiles. However, at this point, since no client calls the component, you can only compile the component. 


To create the Web project 


1. Click File, point to Add, and click New Web Site. 
The Add New Web Site dialog appears. 
2. In the Location, type C:\Inetpub\wwwroot\BrowserComponent. 
3. Click OK. 
The project creates a stub Web site, and since there is no web.config file, the project will not build at this point. 
4. Right-click Default.aspx, and then click Set as Start Page. 


5. Open Default.aspx, and replace the contents with the following code: 


<%@ Import Namespace="BrowserComponent" %> 
<html> 
<script language="VJ#" runat="server"> 
public void Page Load(Object sender, EventArgs E) 


//Request the address in South Africa. 
BrowserComponent comp = new BrowserComponent(); 


String[] arrAddress = comp.GetCompanyAddress(2); 
StringBuilder sbAddress = new StringBuilder(); 
sbAddress.Append("<b>XYZ Customer Branch</b><br> "); 
for (int idx = @; idx < arrAddress.length; idx++) 


{ 


sbAddress.Append(arrAddress[idx] + <br> "); 
} 
Message.set_InnerHtml(sbAddress.ToString()); 
i 
</script> 
<head><title>Locate Closest Customer Office</title></head> 
<body style="font: 1@pt verdana"> 
<h3>A Simple Managed Component</h3> 
<br><br><hr><br> 
<h5>Thank you for your inquiry. Our mailing address is:</h5> 
<table><tr><td> 
<div id="Message" runat="Server" /> 
</td></tr></table> 
</body> 
</html> 


On the Page_Load method, the BrowserComponent class has a new managed instance. The instance calls 
GetCompanyAddress method and requests the address for corporate office number 291. As an enhancement, your 
own application can prompt the user in some way and derive the office number before calling GetCompanyAddress. 


To deploy and view the Web page 


1. In Solution Explorer, right-click on the Web site name, and click Add Reference. 
2. In the Add Reference window, click the Projects tab. 
3. Highlight the BrowserComponent project and click OK. 
Later, when you build the whole solution, the reference allows your Web page to find the component. 
4. In Solution Explorer, right-click on the Web site name, and click Add New Item. 
5. Click Web Configuration File, and then click OK. 
The web.config file provides compilation and run-time information such as security modes. 
6. In Solution Explorer, double-click on the web.config file. 


7. Under <system.web>, insert the following code: 


<compilation debug="true" > 
<assemblies> 
<add assembly="BrowserComponent"/> 
</assemblies> 


</compilation> 


The compilation debug="true" statement enables you to debug the component from the Web page. When you deploy 
your Web site to production, be sure to set this statement to false for better performance. The add 
assembly="BrowserComponent” attribute identifies the component that the Web page uses. 


8. On the File menu, click Save All to store all references and project settings. 
9. On the Build menu, point to Build Solution. 
Both projects compile and the component deploys to the Web site's \bin directory. 


10. From the Windows Start menu, point to Programs, then point to Administrative Tools, and click Internet 
Information Services. 


11. In the Internet Information Services snap-in, right-click the BrowserComponent folder. 
12. Click New, then click Virtual Directory, and then click Next. 
13. On the Virtual Directory Alias window, type BrowserComponent as the Web name. 
14. Click Next. 
15. Click the Browse button, and highlight the Web directory path. 
16. Click OK, and then click Next. 
17. On the Access Permissions window, select the Executable check box to allow the BrowserControl.dll to run. 
18. Click Next, and then click Finish. 
The Web site is now enabled for access and you can begin running the Web page from the browser. 
19. On the Visual Studio Debug menu, click Start. 
20. In Solution Explorer, right-click Default.aspx, and click View in Browser. 


The Web browser displays the Cape Town address as: XYZ Customer Branch Parliament Street Cape Town S. Africa. 


See Also 
Tasks 


How to: Deploy J# Browser Controls 
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Creating Windows GUI Applications with Visual J# 


This section shows you how to use the Visual J# library to create Windows applications. 


In This Section 
How to: Use AWT Frames 


Describes how to create a GUI with the Abstract Window Toolkit (AWT). 
How to: Create a New Swing Application 


Describes how to how to create a GUI with Swing. 


Related Sections 
How to: Create a Visual J# Windows Application 


Visual J# Tasks 
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How to: Create a New Swing Application 


The Supplemental UI Library for the Visual J# library provides much of the Swing functionality, which supports building 
traditional graphic user interface (GUI) and graphics functionality for client applications. The vjssupuilib library automatically 
ships with Visual J# and contains features for building robust Windows applications that run within the INET Framework. 


The following example demonstrates many of the Swing features and how they can interoperate with the AWT library. This 
example also shows you how to create them programmatically. At run time, the sample allows you to load a JPG graphic and 
shade, shape, or orient the image. 


Create the frame and menu stubs 


1. Obtain a graphic jpg file for editing in this example. 

2. Open a new console project named Swing. 

3. In Solution Explorer, right-click on References, and click to Add Reference. 
4. Select the VJSSupUILib.dll, and click OK. 


A reference to the Microsoft Supplemental UI Library for Visual J# library is now included in your project. This library 
includes Swing components for user applications such as buttons, boxes, and borders. 


5. In Solution Explorer, make sure Programjsl is selected, and then replace the code with the following code: 


import javax.swing.*; 

import javax.swing.event.*; 

import javax.swing.border.*; 

import javax.swing.filechooser.FileFilter; 
import java.awt.*; 

import java.awt.image.*; 

import java.awt.event.*; 

import java.io.File; 


public class ImageViewerApp extends JFrame implements ActionListener, ChangeListener 
{ 
// Component handles: 
private JMenuItem mLoad, mExit, mUndo, mOriginal,mProperties, mFlipX, mFlipyY; 
private JSplitPane splitPane; 
private JLabel origImageLbl, workImageLb1l; 
private JSlider sliderWidth, sliderHeight; 


// Working, original, and previous images: 
private Image workImage, originalImage, previousImage; 


Notice that the class declaration inherits from JFrame to create a simple Swing window. To monitor the frame, this 
example also implements both the ActionListener and ChangeListener interfaces. 


6. Now add the menus and formatting for the viewer as follows: 


public ImageViewerApp(String title) 

{ 
super(title); 
// Exit when window is closed. 
setDefaultCloseOperation(EXIT_ON_CLOSE); 


// Initalize each menu. 
initMenuBar(); 

origImageLbl = new JLabel(); 
workImageLbl = new JLabel(); 


origImageLbl.setHorizontalAlignment (JLabel.CENTER) ; 
workImageLbl.setHorizontalAlignment(JLabel.CENTER) ; 


JScrollPane origImagePane = new JScrollPane(origImageLb1) ; 
origImagePane.setBorder(new TitledBorder("Original Image") ); 


JScrollPane workImagePane = new JScrollPane(workImageLb1) ; 
workImagePane.setBorder(new TitledBorder( "Modified Image") ); 


splitPane = new JSplitPane(); 
splitPane.setLeftComponent (origImagePane) ; 
splitPane.setRightComponent (workImagePane) ; 
splitPane.setDividerSize(1@); 
splitPane.setOneTouchExpandable(true) ; 
splitPane.setContinuousLayout (true) ; 
getContentPane().add(splitPane) ; 
getContentPane().setBackground(Color.lightGray) ; 


setSize((int)(55@ * 1.61), 550); 
setResizable(false) ; 
showWorkBench() ; 


Remember that your code manually controls the shape and size of the screen. For example, you can change the screen 
size by updating the XY coordinates in the setSize method. 


7. Define each item that displays on the menu bar and add it to the ActionListener as follows: 


private void initMenuBar() 

{ 
JMenuBar menuBar = new JMenuBar(); 
JMenu menu; 


// File. 

menu = new JMenu("File"); 

menu.setMnemonic('F'); 

menu.setToolTipText("Load Image to manipulate") ; 


mLoad = new JMenuItem("Load Image"); 
mLoad.setMnemonic('L'); 
mLoad.addActionListener(this) ; 
menu.add(mLoad) ; 
menu.addSeparator() ; 


mExit = new JMenuItem("Exit"); 
mExit.setMnemonic('x'); 
mExit.addActionListener(this) ; 
menu.add(mExit) ; 
menuBar.add(menu) ; 


// Edit. 

menu = new JMenu("Edit"); 
menu.setMnemonic('E'); 
menu.setToolTipText("Edit Image") ; 


mUndo = new JMenuItem("Undo") ; 
mUndo.setMnemonic('U'); 
mUndo.setEnabled(false) ; 
mUndo.addActionListener(this) ; 


menu.add(mUndo) ; 


mOriginal = new JMenuItem("Revert to Original Image"); 
mOriginal.setMnemonic('R'); 
mOriginal.setEnabled(false) ; 
mOriginal.addActionListener(this) ; 
menu.add(mOriginal) ; 


mProperties = new JMenultem("Scale"); 
mProperties.setMnemonic('C'); 
mProperties.addActionListener(this) ; 
mProperties.setEnabled(false) ; 
menu.add(mProperties) ; 
menuBar.add(menu) ; 


// Rotate. 

menu = new JMenu("Rotate") ; 
menu.setMnemonic('R'); 
menu.setToolTipText("Rotate images"); 


mFlipX = new JMenuItem("Flip Vertically"); 
mFlipX.setMnemonic('V'); 
mFlipX.setEnabled(false) ; 
mFlipX.addActionListener(this) ; 
menu.add(mFlipx) ; 


mFlipY = new JMenultem("Flip Horizontally"); 
mFlipY.setMnemonic('H'); 
mFlipY.setEnabled(false) ; 
mFlipY.addActionListener (this) ; 
menu.add(mFlipY) ; 

menuBar.add(menu) ; 

setJMenuBar (menuBar) ; 


Each instance of JMenultem controls the text that is displayed to the user from the drop-down menus. The 
setMnemonic method defines an alternate short cut key. In the final step, setJMenuBar adds each component to the 
menu bar. 


. Create a window called Workbench that generates at run time, manage the slider bars, and implement ActionListener 
as follows: 


// Shows the screen. 
private void showWorkBench() 
{ 
final Window workBench; 
Timer timer = null; 


// Creates a Swing window, casts to AWT: 
JWindow wnd = new JWindow(this); 
wnd.pack(); 

workBench = wnd; 


ActionListener listen = new ActionListener() 


{ 


public void actionPerformed(ActionEvent event) 


{ 


workBench.dispose(); 
workBench. getParent().show(); 


// Set center divider to @.495 after frame displays. 
splitPane.setDividerLocation(@.495); 


}3 
// Center dialog on screen. 
Dimension screenSize = Toolkit.getDefaultToolkit().getScreenSize(); 
workBench. setLocation((screenSize.width - workBench.getWidth()) / 2, 
(screenSize.height - workBench.getHeight()) / 2); 


// Listener is time-driven. 

// One second. 

timer = new Timer(1000, listen); 
timer.setRepeats(false); 
timer.start(); 

workBench. show(); 


// Fires when size changes by slider. 
public void stateChanged(ChangeEvent event) 
{ 
if (sliderWidth.getValueIsAdjusting() || sliderHeight.getValueIsAdjusting()) 
return; 


int width = sliderWidth.getValue(); 
int height = sliderHeight.getValue(); 


Image filteredImage = workImage.getScaledInstance(width, height, Image.SCALE_S 
MOOTH) ; 
setImage(filteredImage) ; 


Notice that workBench = wnd, casts a JWindow to an AWT Window, so that the AWT ActionListener can manage the 
window. Using the Timer, the listener checks the window for updates at one-second intervals. 


9. Insert the following code to implement each menu item: 


public void actionPerformed(ActionEvent event) 
{ 
Object evtSource = event.getSource(); 
if (evtSource.equals(mUndo) ) 
{ 
if (previousImage != null) 
setAndCommitImage(previousImage) ; 
} 
else if (evtSource.equals(mProperties ) ) 
new ScaleDialog(this); 
else if (evtSource.equals(mOriginal) ) 
{ 
setAndCommitImage(originalImage) ; 
// Restoring the original background: 
splitPane. getRightComponent().setBackground( 
splitPane.getLeftComponent().getBackground()); 
} 


else if (evtSource.equals(mLoad) ) 


{ 


JFileChooser fileChooser = new JFileChooser(new File(".")); 
fileChooser.setFileFilter(new JpgFileManager()); 


int returnVal = fileChooser.showOpenDialog (this) ; 
if (returnVal != JFileChooser.APPROVE_OPTION) 
return; 


File file = fileChooser.getSelectedFile(); 
if (file == null) 


return; 
else if (!file.exists()) 
{ 
String msg = "The file '" + file.getName() + "' not found.\n" + 
"Please verify that the correct file name was given."; 
JOptionPane.showMessageDialog(this, msg, "Image Viewer", 
JOptionPane.ERROR_MESSAGE ) ; 
return; 
} 


if (workImage != null) 
workImage.flush(); 


workImage = Toolkit. getDefaultToolkit().getImage(file.getAbsolutePath()); 
if (workImage == null) 
return; 


originalImage = Toolkit.getDefaultToolkit().getImage(file.getAbsolutePath( 
))3 

origImageLbl.setIcon(new ImageIcon(originalImage, "")); 

workImageLbl.setIcon(new ImageIcon(workImage, "")); 

previousImage = null; 

mFlipX.setEnabled(true) ; 

mFlipY.setEnabled(true) ; 

mUndo.setEnabled(false) ; 

mOriginal.setEnabled(true) ; 

mProperties.setEnabled(true) ; 

repaint(); 


else if (evtSource.equals(mExit) ) 


{ 
dispose(); 
System.exit(@); 


i 
(evtSource.equals(mFlipXx) ) 


flip(false); 
else if (evtSource.equals(mFlipY) ) 
flip(true) ; 


Notice that the event.getSource method returns the user's action. If you add more features to the application, you can 
add an additional else if clause to manage these events. 


10. Insert the main method that drives the application as follows: 


public static void main(String[] args) 


{ 


new ImageViewerApp("ImageViewer - A Visual J# .NET Demo"); 


11. From the Build menu, click Build Solution. 


12. If you run the application at this point, an empty window with menu items opens. 


To add code to manage loading 


e Insert the following code to assist the user while working with JPG graphics: 


class JpgFileManager extends FileFilter 


{ 
public String getDescription() 
af 
return "JPG Files (*.jpg)"; 
} 


// Seeks directory or file. 
public boolean accept(File file) 


{ 
if (file.isDirectory()) 
{ 
return true; 
} 
else 
{ 
String filepathname = file.getAbsolutePath().toLowerCase(); 
if (filepathname.endswWith(".jpg")) 
return true; 
} 
return false; 
} 


} 
//Rotates the image and copies it to the right panel. 


private void flip(boolean aboutyY) 

{ 
final int width = workImage.getWidth(null) ; 
final int height = workImage.getHeight (null) ; 
final int total = width * height; 


// Load the workImage pixels into the imagePixels array: 
int imagePixels[] = new int[total]; 


PixelGrabber pg = new PixelGrabber(workImage, @, @, width, height, 
imagePixels, @, width); 

try 

{ 
pg.grabPixels(); 


} 
catch (InterruptedException e) { } ; 


if (aboutyY) 
{ 
// About Y-axis: 
int center = width / 2; 
int temp; 
for (int t = @; t < total; t += width) 
{ 
for (int c = @3 c < center; c++) 
{ 
temp = imagePixels[t + c]; 
imagePixels[t + c] = imagePixels[t + width - 1 - c]; 
imagePixels[t + width - 1 - c] = temp; 


} 
else 
t 
// About X-axis: 
int center = total / 2; 
int temp; 
for (int t = @; t < width; t++) 
af 
for (int c = @3 c < center; c += width) 
{ 
temp = imagePixels[t + c]; 
: imagePixels[t + c] = imagePixels[total + t - width - c]; 
imagePixels[total + t - width - c] = temp; 
} 
} 
} 


Image filteredImage = createImage(new 
MemoryImageSource(width, height, imagePixels, @, width)); 
setAndCommitImage(filteredImage) ; 
} 
// Copies the image to the right panel that stores modified image. 
private void setImage(Image newImage) 


{ 


workImageLb1.setIcon(new ImageIcon(newImage) ) ; 
} 
// Refresh the right panel that stores modified image. 
private void setAndCommitImage(Image newImage) 


{ 
if (workImage != null) 
workImage. flush(); 
previousImage = workImage; 
workImage = newlImage; 
workImageLbl.setIcon(new ImageIcon(workImage) ) ; 
mUndo.setEnabled(true) ; 
} 
private void commitImage() 
af 
Icon icon = workImageLbl.getIcon(); 
setAndCommitImage(((ImageIcon)icon).getImage()); 
} 


Notice that the JpgFileManager class extends FileFilter for assisting the user with loading the images for a particular 
directory. In the method flip, the image rotates and calls ActionListener to copy the graphic to the right panel that 
stores the modified image. 


To add code to scale graphics 


1. Insert the following code to add the following class and manage scaling: 


class ScaleDialog extends JDialog implements ActionListener 


{ 
public ScaleDialog(JFrame parent) 


{ 


super(parent, "Scale", true); 


int width = workImage.getWidth(null); 
int height = workImage.getHeight(null); 
int maxW = Math.max(width, 1200); 

int maxH = Math.max(height, 1000); 


sliderWidth = new JSlider(@, maxW, width); 
sliderWidth.setBorder(new TitledBorder("Width") ); 
sliderWidth.setMajorTickSpacing(1@@) ; 
sliderWidth.setPaintTicks(true) ; 
sliderWidth.setPaintLabels(true) ; 
sliderWidth.setMinorTickSpacing(5@) ; 
sliderWidth.addChangeListener((ChangeListener )parent) ; 


sliderHeight = new JSlider(@, maxH, height); 
sliderHeight.setBorder(new TitledBorder ("Height") ); 
sliderHeight.setMajorTickSpacing(1@@) ; 
sliderHeight.setPaintTicks(true) ; 
sliderHeight.setPaintLabels(true) ; 
sliderHeight.setMinorTickSpacing(5@) ; 
sliderHeight.addChangeListener((ChangeListener) parent) ; 


JPanel sliders = new JPanel(new GridLayout(2, 1, 4, 4)); 
sliders.add(sliderWidth) ; 
sliders.add(sliderHeight) ; 


// ok cancel buttons panel 

JButton ok = new JButton("OK"); 

JButton cancel = new JButton("Cancel"); 
ok.addActionListener(this) ; 
cancel.addActionListener(this) ; 
ok.addActionListener( (ActionListener) parent) ; 
cancel.addActionListener( (ActionListener) parent) ; 


JPanel buttonsPanel = new JPanel(); 
buttonsPanel.add(ok) ; 
buttonsPanel.add(cancel1) ; 


getContentPane().add(sliders, BorderLayout.CENTER) ; 
getContentPane().add(buttonsPanel, BorderLayout.SOUTH) ; 


setResizable(false); 
setSize((int)(300 * 1.61), 300); 
setLocationRelativeTo(parent) ; 


// Add a Window closing listener to simulate cancel. 
addWindowListener(new WindowAdapter() 


{ 


public void windowClosing(WindowEvent e) 


{ 


setImage(workImage) ; 


})3 


show(); 


public void actionPerformed(ActionEvent event) 


{ 


String eventName = (String)event.getActionCommand() ; 


if (eventName.compareTo("OK") == @) 


{ 
commitImage(); 
dispose(); 
} 
else if (eventName.compareTo("Cancel") == @) 
if 
setImage(workImage) ; 
dispose(); 
} 


The ScaleDialog constructor accepts the parent window and creates a slider box for scaling images. Instead of manually 
entering the values on the new slider bar, the setMajorTickSpacing(100) method inserts the value every 100 ticks. 
Notice that another actionPerformed method handles the OK and Cancel buttons on the slider. 


2. Press F5 to compile and run the application. 


A window opens for image editing. When you open a graphic, the image displays in both label box panels. As you edit, or 
reorient the graphic, the update displays in the right panel. 


See Also 
Tasks 
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How to: Use AWT Frames 


The java.awt package contains classes and subpackages that make up the Visual J# Abstract Windowing Toolkit (AWT). The 
AWT provides legacy user interface objects that allow a GUI application written in Java to run on any platform. Examples of 
classes included within the java.awt package include Button, List, Menu, Checkbox, and Color. 


Since AWT applications do not use Windows Forms, you can use the Console Application template to create a project. The 


following example shows you how to create your own Microsoft® Notepad-style editor application using AWT. Instead of 
dragging onto a designer to create windows and components, this example shows you how to create them programmatically. 


To create a simple text editor 


1. On the File menu, point to New, and then click Project. 
2. Select the Console Application template from the list of J# Project types, and type AWT in the Name box. 


3. In Solution Explorer, make sure Programjsl is selected, and then in the Code Editor, replace the code with the following: 


import java.awt.*; 
import java.awt.event.*; 
import java.io.*; 


class Editor extends Frame implements ActionListener 


{ 


TextArea textArea = new TextArea(); 


//Set up the menu on the default CTOR. 

Editor() 

{ 

super("Text AWT Editor"); 
setLayout(new BorderLayout()); 
add("Center", textArea) ; 
Menu menu = new Menu("File"); 
menu.add(makeMenuItem("Open") ); 
menu.add(makeMenultem("Save") ); 
menu.add(makeMenultem("Quit") ); 
MenuBar menuBar = new MenuBar()3; 
menuBar.add(menu) ; 
setMenuBar (menuBar) ; 


pack(); 
} 
private MenuItem makeMenultem(String name) 
{ 
MenuItem m = new MenuItem(name) ; 
m.addActionListener(this) ; 
return m; 
} 
public static void main(String[] s) 
{ 
new Editor().show(); 
} 


The super keyword sets the title bar for the frame in the line, super ("Text AWT Editor"); The frame layout is set to 
BorderLayout, which constructs a Window without gaps between components. Other frame formats include 
CardLayout and GridBagLayout. 


The new Menu ("File") and menu.add methods create a drop-down menu with items for the user to select. 


4. Implement the event handler for each drop-down menu item by inserting the following code: 


public void actionPerformed(ActionEvent e) 


{ 
String command = e.getActionCommand(); 
if (command.equals("Quit") ) 
dispose(); 
else if (command.equals("Open") ) 
openFile(); 
else if (command.equals("Save") ) 
saveFile(); 
} 


5. Implement methods to manage opening and saving files by inserting the following code: 


private void openFile() 
{ 
//Show the Open File dialog box to the user. 
FileDialog fd = new FileDialog(this, "Open File", FileDialog.LOAD) ; 
fd.show(); 


//Get the file path. 

StringBuffer sbPath = new StringBuffer(fd.getDirectory()); 
sbPath.append("\\"); 

String fileName = fd.getFile(); 


//Cancel if null: 
if (fileName == null) 
{ 


return; 


} 
else sbPath.append(fileName) ; 


// Open and fill the input stream; paint the TextArea. 
try 
{ 
FileInputStream fs = new FileInputStream(sbPath.ToString()); 
byte[] data = new byte [ sbPath.length() ]; 
fs.read(data) ; 
textArea.setText(new String(data)); 
} 
catch (IOException e) 


{ 
textArea.setText(e.toString()); 


private void saveFile() 
try 


// Show the dialog box to the user. 
FileDialog fd = new FileDialog(this, "Save File", FileDialog.SAVE); 
fd.show(); 


//Get the path and file name. 

StringBuffer sbPath = new StringBuffer(fd.getDirectory()); 
sbPath.append("\\"); 

// Get the file name to create: 


sbPath. append(fd.getFile()); 
FileOutputStream fo = new FileOutputStream(sbPath.ToString()); 


// Parse the data: 

String strdata = textArea.getText(); 

byte[] data = new byte [strdata.length() ]; 

for (int idx = @; idx < strdata.length(); idx++) 


! 
data[idx] = (byte)strdata.charAt(idx) ; 


} 
// Write the array to the file. 
fo.write(data) ; 


} 
catch (IOException ex) 
1 
textArea.setText(ex.toString()); 
} 


| 
6. Press F5 to compile and run the application. 
Your text editor opens and enables you to begin typing. When you finish, you can either save your work or open another 


text file for editing. 


See Also 
Tasks 
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How to: Access Resources from a .properties File 


The data in .properties and txt files is automatically upgraded to the .resx file type when you convert a project to Visual J#. 
However, in the case where legacy applications and newer J# applications must share the same properties file, you can still 
access a .properties file 


Example 
The following example demonstrates how to read and write to the traditional .properties file. The code creates and stores a 
properties file, and then fetches and prints the contents. 


package Properties; 
import java.util.*; 
import java.io.*; 
/** 
* Summary description for Program 
*/ 
public class Program 
{ 
public static void main(String[] args) 
af 


try { 
// Build a properties file for student. 


File file = new File("c:\\MyResources.properties"); 
file.createNewFile(); 

Properties properties = new Properties(); 
properties.load(new FileInputStream(file) ); 
properties.setProperty("CountryName", "South Africa"); 
properties.setProperty("CountryCode", "27"); 
properties.setProperty("Localization", "afr"); 
properties.setProperty("AccessLevel", "Student"); 
properties.setProperty("CityName", "Johannesburg" ) ; 
properties.setProperty("CityCode", "11"); 
Enumeration e = properties.keys(); 


while (e.hasMoreElements()) 


Object obj = e.nextElement(); 
System.out.println(obj.toString()); 
System.out.println(properties.getProperty(obj.toString())); 


} 
} catch (IOException ex) { 


System.out.printin(ex.toString()); 


} 
} 


Compiling the Code 


e Press F5 to compile and run the application. 
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How to: Call a Method in a DLL from Visual J# 


While developing your applications, it is helpful to use as much existing library code as possible. Reusable library code saves 
you the work of having to write the functionality yourself. 


There are two ways to call a function (method) from a DLL. You can either access a static method, or create an instance and call 
the method dynamically. The following example shows you how to call both static and dynamic methods from the vjslib.dll 
library. 


To call methods from a DLL 
1. Create a console application, and call it CallDII. 


2. In the Programjsl, replace the contents with the following code: 


import java.io.*; 
public class MyClass 


{ 
public String CreateFile() 
{ 
// This is a call to a static method. 
System.out.println("Because there is not instance, this is a call to a static 
method") ; 
// This is a call to a dynamic method because 
//there is a File instance. 
File myFile = new File("c:\\temp.txt"); 
return myFile.getPath(); 
} 
public static void main(String[] args) 
uf 
MyClass myClass = new MyClass(); 
String OutputFile = myClass.CreateFile(); 
System.out.printlin("The following file was created: " + OutputFile); 
} 
} 


The CreateFile method first calls System.Console.WriteLine.as a static method. Notice that you do not need to 
instantiate System.Console to use the WriteLine method. However, to create a file, the new keyword is required to 
allocate managed memory for the File class. For example: File myFile = new File("c:\\temp.txt"). 


For external, non-native libraries, you may need to add a reference to a DLL from within your project. If the compiler 
cannot find a library, a green wavy underline is displayed under the method name that you are using in your code. 


3. From Solution Explorer, right-click Add Reference, and then click Browse to find the library DLL that contains the 
class and method that you want to use. 


4. Press F5 to compile and run the application. 


For external non-native libraries, you may need to add a reference to a DLL from within your project. If the compiler 
cannot find a library, a green wavy underline is displayed under the method name that you are using in your code. 


5. Click the library name, and click OK. 
6. Press F5 to compile and run the application. 
When CallDIl runs, and the CreateFile method executes, it prints This is a call to a static method to the console, 


and creates a file called c\\temp.txt. 


Compiling the Code 


e To call a library method, you may either use the fully qualified name or specify the library package name in the import 
statement at the beginning of your code. Use the import (Visual J#) statement at the top of your jsl file. 


e The library method must be public unless you are inheriting from the class. If you inherit, you can access public and 
protected members of a class. 


e Unless the method is static (Visual J#), it must be referenced through an instance of the class. To get an instance of the 
class, use the new (Visual J#) keyword. 


e When assigning an expression to your property or variable, use or cast the return value to a compatible data type. For 
example, if you want to use the return value from a library method called count People () that returns an int, your data 
type must also be an int. For example: int Total = CountPeople(); 


Security 


When working with libraries that belong to an unknown source, you should verify that data input or output is valid. 


See Also 
Other Resources 


Class Library Support 


Visual J# Concepts 


How to: Create a Visual J# Project from Existing J++ Code 


The Visual J# Upgrade Wizard enables you to upgrade J++ applications to the .NET Framework. It only takes a minute to 
upgrade an entire project to Visual J#. The following example shows you how to upgrade a Visual J++ project to Visual J#. 


To upgrade Visual J++ 6.0 projects to Visual J# 


1. On the File menu, click Open, and then click Project/Solution. 
The Open Project dialog displays a list of projects. 
2. Point to your VJ++ project and click OK. 


The Visual J# Upgrade Wizard automatically converts the Visual J++ project. It also converts resource files (with 
.resources and .properties file extensions) associated with the upgraded project into the .NET Framework XML resource 
format (.resx) files. However, Pre-build and post-build steps are not supported. 


3. On the Build menu, click Build Solution. 


You do not need to set a CLASSPATH, Visual J# manages this automatically. The jsc compiler compiles your old code and 
places the binaries in your project's bin\debug directory. In addition, all version information now resides as attributes in 
the assembly. 


See Also 

Tasks 
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How to: Deploy J# Browser Controls 


Microsoft J# web browser controls are libraries containing one or more graphical user controls. Once the control is in an 
assembly DLL, a Web developer can reference the assembly and then drag the control from the ToolBox onto a Web page. 


When you compile both the project with the control and the Web project, the browser control DLL automatically deploys to the 
Web site. If you only have the browser control DLL, you may have to manually copy it to the Web site bin directory like this: 
c:\inetpub\wwwroot\mywebsite\bin. 


The following example shows you how to create a simple control, deploy the control to a Web site, and display it on a Web 
page. 


Create the browser control 


1. From the File menu, point to New, and then click Project to open the New Project dialog box. 


2. Select the Web Control Library project template from the list of J# Projects, and type BrowserControl in the Name 
box. 


3. In the WebCustomControl1 jsl, replace the code with the following: 


package MyTextBox; 


import System.Web.UI.*; 
import System.Web.UI.WebControls.*; 
import System.ComponentModel.*; 


/** 
* Summary description for WebCustomControl1. 

=f 

/** 

* @attribute DefaultProperty("Text") 

* @attribute ToolboxData("<{@}:WebCustomControl1 runat=server></{@}:WebCustomControl1 
>") 

e/ 

public class MyTextBox extends System.Web.UI.WebControls.WebControl 

{ 


private String text = 
private boolean Visible = false; 

/** 

* @attribute Bindable(true) 

* @attribute Category("Appearance" ) 
* @attribute DefaultValue("") 

4 A 


public String get_Text() 


sf 
return text; 
} 
public void set_Text(String strInput) 
{ 
text = strInput; 
} 
/** 


* Render this control to the output parameter specified. 


*/ 


4. 


5. 


protected void Render(HtmlTextwriter output) 


{ 
output .Write(text) ; 
} 
public void SetVisible(boolean bShow) 
{ 
Visible = bShow; 
} 
public boolean GetVisible() 
{ 
return Visible; 
} 


// 3a: Postback -> LoadViewState 


protected void LoadViewState(Object viewState) { 
//Page.Trace.Write (" -> LoadViewState") ; 

if (viewState == null) { 
LoadViewState(viewState) ; 


} 
} 


Notice that the SetVisible and GetVisible methods manage the control's visibility at run time. 

The @attribute flags control default properties that will display to the Web developer at design time. 
From the File menu, click Save All to store all references and project settings. 

From the Build menu, click Build Solution. 


The library compiles. However, at this point, nothing runs because no client actually calls the component you can only 
compile the component. 


Place the control on a Web page 


. Click File, and then point to Add and New Web Site. 
. Inthe New Web Site dialog, click on the Location box, enter C:\Inetpub\wwwroot\BrowserControl. 


. Click OK. 


The project creates a stub Web site, and since there is no web.config file, the project will not build at this point. 


. In Solution Explorer, right-click on Default.aspx, and click Set as Start Page. 


From the View menu, click ToolBox. 


The Toolbox opens with your new set of controls called BrowserControls. 


. From the Toolbox, drag a Button onto the form. 
. From the Properties window, change the Text property to Get Balance. 
. From the Toolbox, point to BrowserControls, and click to open the control list. 


. Drag the MyTextBox browser control onto the Default.aspx page. 


The control displays on the browser with a message stating that there is an error creating the control. This error just 
reminds you that the control requires configuration. 


. Double-click on your new control. 


The code window displays the default.aspx Web page. 


. Next to the cc1 custom control tag, type the control's class name on both the start and end tags. For example: 


<cc1:MyTextBox id="WebCustomControl1_1" runat="server" ForeColor="Black" Width="258px" 
Height="15px" Text="333"></cc1:MyTextBox> 


11. Click the Design tab to view the designer. 
12. Right-click the control, and display the Properties. 
13. In the Text property, type the word Balance. 


You can also set other properties such as background color and foreground colors. 
Deploy and run the browser control 


1. In Solution Explorer, right-click the Web site name, and click Add Reference. 
2. On the Add Reference window, click the Projects tab. 
3. Select the BrowserControl project, and click OK. 
Later, when you build the solution, the reference enables your Web page to find the component. 
4. In Solution Explorer, right-click the Web site name, and click Add New Item. 
5. Click Web Configuration File, and then click OK. 
The web.config file provides compilation and run time information such as security modes. 
6. In Solution Explorer, double-click the web.config file. 


7. Under <system.web>, add the following code: 


<compilation debug="true" > 
<assemblies> 
<add assembly="BrowserControl"/> 
</assemblies> 


</compilation> 


The compilation debug="true" statement enables you to debug the component from the Web page. When you deploy 
your Web site to production, be sure to set this statement to false for better performance. The add 
assembly="BrowserControl" attribute identifies the component that the Web page uses. 


8. From the File menu, click Save All to store all references and project settings. 
9. From the Build menu, click Build Solution. 
Both projects compile, and the component deploys to the Web site's \bin directory. 


10. From the Windows Start menu, point to Programs, then Administrative Tools, and click Internet Information 
Services. 


11. In the Internet Information Services snap-in, right-click the BrowserControl folder 

12. Click New, then click Virtual Directory, and then click Next. 

13. In the Virtual Directory Alias window, type BrowserControl in the Web name box. 

14. Click Next. 

15. Click the Browse button, and select the Web directory path to specify the location of the web site. 

16. Click OK, and then click Next. 

17. In the Access Permissions window, select the Executable check box to allow the BrowserControl.dll to run. 
18. Click Next, and then click Finish. 


The Web site is now enabled for access, and you can begin running the Web page from the browser. 


19. On the Visual Studio Debug menu, click Start. 
20. In Solution Explorer, right-click on the Default.aspx, and click View in Browser. 
21. Click the Balance button. 


The Web browser updates the textbox browser control with Balance = $497.22. In your own applications, you can add 
logic behind the control to display different outputs depending on what a user types. 


See Also 
Tasks 
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How to: Implement an Interface in J# 


Interfaces describe the characteristics of properties, methods, and events while enabling your class to customize how those 
objects should operate. The implements keyword enables your class to declare methods with the same signature as the 
interface and then implement them. 


For example, the interface Car may have a property called Color and a method called Drive(). Your class may implement the 
Car interface, use the Color property to describe the vehicle, and then implement the Drive() method to describe how to move 
the vehicle. 


When implementing an interface, consider the following: 


e Your class's methods must have the same signature as the parent interface. For example, methods must have the same 
number and type of parameters as well as return type as the interface. 


e You can override the implementation of a class in vjslib.dll, but there are certain restrictions. For example, you cannot 
override the implementation of java.lang.Object or java.lang.String. Nor can you override any of the exception 
classes. 


The following example shows you how to implement the java.lang.Comparable interface to compare bank transactions. 
To implement an interface 


1. Open a new Console Application, and name it Verify Transaction. 


2. Copy the following class into your jsl file: 


public class SecurityAudit implements java.lang.Comparable 


{ 


String AccountNumber ; 
Double AccountBalance; 
String ReferenceNumber ; 


public int compareTo(Object Verify) 


{ 
final int SameTransaction = @; 
final int SuspiciousTransaction = 1; 
if (this == Verify) 
return SameTransaction; 
else return SuspiciousTransaction; 
} 


The compareTo method implements the interface with your own code that compares two objects. Notice that we cannot 
modify the method signature or return type. 


3. Replace the main method with the following code: 


public static void main(String[] args) 

{ 
SecurityAudit Original = new SecurityAudit(); 
Original.AccountNumber "987-654"; 
Original.AccountBalance = new Double(777.77); 
Original.ReferenceNumber = "1234"; 


SecurityAudit CustomerClaim = new SecurityAudit(); 
CustomerClaim.AccountNumber "987-654"; 
CustomerClaim.AccountBalance = new Double(977.@@); 
CustomerClaim.ReferenceNumber = "1234"; 


CustomerClaim. compareTo(Original) ; 
if (Verify == 0) 
System.out.println("Reference Number" + CustomerClaim.ReferenceNumber + " 
appears valid"); 
else 
System.out.println("Reference Number" + CustomerClaim.ReferenceNumber + " 
does not match the original reference. Contact your supervisor") ; 


} 


The main method simulates that there are two bank transactions. Upon instantiation, this code instantiates a 
SecurityAudit object for each transaction and calls the compareTo method. 


4. Press F5 to compile and run the application. 


The compareTo method compares both objects and reports that the balances do not match. The application reports 
Reference Number1234 does not match the original reference. Contact your supervisor. Because compareTo 
returns an int, this method could track various problems with transactions. 


See Also 
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How to: Validate User Input in a Console Application 


You can create console applications that accept input parameter flags. During startup, when the user enters input to your 
console application, the common language runtime (CLR) presents an array of space-delimited input parameters to the main 
method. 


You can use these parameters to control how your program operates. The following example is a console application that 
verifies that the user entered a first and last name at run time. The Maxlength field ensures that if the user entered a fictitious 
first name that is longer than 20 characters, the program throws an IllegalArgumentException. Your own application could also 
supply additional checks, such as verifying the length of the last name. 


To validate user inputs 


1. On the File menu, point to New, and click Project. 
2. Click Console Application, and in the Name box, type ValidateUserInput. 


3. In the Program,jsl, replace the code with the following: 


package ValidateUserInput ; 


public class Program 


{ 
public static void main(String[] args) 
1 
int MaxLength = 20; 
if (args.length != 2) 
{ 
System.out.println("Usage: ValidateUserInput FirstName LastName "); 
System.out.println("For example:"); 
System.out.println("ValidateUserInput John Doe"); 
} 
String input = new String(args[1]); 
if (input.get_Length() > MaxLength) 
throw new IllegalArgumentException(); 
} 
} 


4. In Solution Explorer, right-click the ValidateUserInput project name, and click Properties. 
5. Click Debug. 


6. In the Command line arguments text box, type in the command line arguments that you would normally use from the 
command prompt. For example: John Doe. 


7. Press F5 to compile and run your program. 


While your program is running in debug mode, Visual Studio automatically starts the application called 
ValidateUserInput, and supplies the two input parameters, such as John Doe. If you decide to run the application from a 
console window, you will need to type: ValidateUserInput John Doe. 


Security 


To prevent buffer overruns and malicious attacks, your code should always verify user input content and length. 


See Also 
Reference 


Security Semantics for Applications Written in Visual J# 


Visual J# Concepts 


How to: Write a Package Scoped Class 


You can group related classes within an application using the package statement. Classes with the same package name are 
called package-scoped. Once scoped, the class members in the same package are available to each other. Additionally, callers 
of the class access the entire scope with a simple import statement. 


When working with packages, consider the following: 


e Consider naming a package with several words. By convention, the first word indicates the name of your organization. 
For example: package mycompany; 


@ To nest a package, add a dot separator and the child name. For example: mycompany.platform.security. 


e By design, package scoping occurs across assemblies (.exe and dll files). If you want to block access to your assembly, 
use the /securescopingcompiler switch. 


The following examples show you how to package scope classes. When you create a new Visual J# project, the project name 
automatically becomes the package name for every class within the project. For existing classes, you will manually have to add 
or change the package statement. 


To automatically group new applications to a package 


1. Create a console application and name the project MyPackage. 
2. Review the Program jsl. 
Notice that the package statement matches the project name. For example package MyPackage; 
3. From the Solution Explorer, right click on the project name and Add New Item. 
4. Click Class and type AnotherClass as the Name. 
5. Click Add. 
6. Review the AnotherClassjsl. 
Notice that Visual J# automatically adds the package statement in the jsl. File. Each class that you add contains the same 


package name. For example package MyPackage; 


To group existing classes into a package 


1. Open each jsl file and add the same package statement followed by a semicolon. 


The package statement must be the first line in the source file that is neither commented nor blank. For example: package 


mycompany.platform; 
2. Press F5 to compile and run the application. 


When it compiles successfully, the compiler groups the classes into a namespace and sets up a corresponding directory 
structure. 


See Also 
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/securescoping (Make Package-Scoped Members Inaccessible Outside Assembly) 
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Visual J# Walkthroughs 


The following walkthroughs are intended to familiarize you with using Visual Studio features to write Visual J# applications. 


Creating and Accessing XML Web Services Walkthroughs 
Creating an XML Web Service with Visual J# 


Describes the process for writing a simple XML Web service using the ASP.NET Web Service project template. 
Accessing an XML Web Service with a Visual J# Web Forms Client 

Describes the process for writing a Web Forms client for an XML Web service. 
Accessing an XML Web Service with a Visual J# Windows Client 


Describes the process for writing a Windows Form client for an XML Web service. 


Components and Controls Authoring Walkthroughs 
Authoring a Component with Visual J# 


Shows the development of a simple component, illustrating the interaction between client and component, object lifetime 
and circular references, debugging clients and components, and the use of shared methods and instance methods. 


Authoring a Simple Multithreaded Component with Visual J# 


Demonstrates creating a multithreaded component, explaining how threads work and how to coordinate multiple threads in 
your component. 


Authoring a User Control with Visual J# 


Shows how to develop a simple user control that inherits from the UserControl class and how to inherit from an established 
user control. 


Inheriting from a Windows Forms Control with Visual J# 


Demonstrates how to create a simple inherited button control. This button inherits functionality from the standard Windows 
Forms button and exposes a custom member. 


Related Sections 
Visual J# NET 


Provides links to various areas of the Visual J# documentation set. 
Visual J# Samples 
Sample source code showing how to write applications for the .NET Framework using Visual J#. 
Visual Studio Walkthroughs 
Step-by-step guides for creating different types of applications and components using the various Visual Studio 


programming languages. 


See Also 
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XML Web Services Walkthroughs (Visual J#) 


These walkthroughs cover two separate development paths: creating XML Web services and accessing XML Web services. The 
accessing XML Web services walkthroughs demonstrate a Web Forms client and a Windows client. 


In This Section 
Walkthrough: Creating an XML Web Service with Visual J# 


Describes the process for writing a simple XML Web service using the ASP.NET Web service project template. 
Walkthrough: Accessing an XML Web Service with a Visual J# Web Forms Client 

Describes the process for writing a Web Forms client for an XML Web service. 
Walkthrough: Accessing an XML Web Service with a Visual J# Windows Client 


Describes the process for writing a Windows Form client for an XML Web service. 


Related Sections 
Visual J# Walkthroughs 


Describes how to create distributed Web applications, work with Windows Forms and Web Forms, and create and access 
XML Web services. 


Creating and Accessing XML Web Services Walkthroughs 


Demonstrates the development of an XML Web service using Visual C#, Visual Basic, ATL Server, and C++. There are also 
corresponding walkthroughs for accessing the XML Web service. 


XML Web Services in Managed Code 
Covers the technologies for creating, distributing, and consuming XML Web services using Visual Basic or Visual C#. 
Visual J# Reference 


Provides links to reference documentation on J# keywords, J# operators, J# classes, and so on. 
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Walkthrough: Creating an XML Web Service with Visual J# 


The following walkthrough describes the process for writing a simple XML Web service using Visual J#. 


An XML Web service is a way to access server functionality remotely. Using XML Web services, businesses can expose 
programmatic interfaces to their data or business logic, which in turn can be obtained and manipulated by client and server 
applications. XML Web services enable the exchange of data in client-server or server-server scenarios, using standards like 
HTTP and XML messaging to move data across firewalls. 


For more information about XML Web services, see Acronym-WebService Sample (Create and Consume an XML Web Service). 





Note 





The dialog boxes and menu commands you see might differ from those described in Help depending on your active settings 
or edition. To change your settings, choose Import and Export Settings on the Tools menu. For more information, see 
Visual Studio Settings. 








To create an XML Web service using Visual J# 


1. On the File menu, click New, and then click Web Site. 
The New Web Site dialog box appears. 
2. Click the ASP.NET Web Service icon. 
3. In the Language box, select Visual J#. 
4. In the Location box, select HTTP if it is not already displayed in the box. 


5. In the Location box, type the name and the location of the Web service. Specify VJSharpWebService as the application 
name. 


By default, the project uses your local machine, "http://localhost" as the address of the Web service. 
6. Click OK. 


The Visual Studio template creates a solution for you. The Web service file, Service.asmx, and the corresponding code- 
behind file, Servicejsl, are created. 


7. In Solution Explorer, right-click Service.asmx, and click View Code. 
The Code Editor opens the code-behind file Servicejsl. 
Notice the following code of the HellowWorld method in the Code Editor: 
The resulting method looks like this: 


/** @attribute WebMethod() */ 
public String HelloWorld() 


{ 


return "Hello World"; 


Notice the WebMethod attribute, which indicates that the HelloWorld method is to be exposed as a Web service method. 
8. Click Start Without Debugging on the Debug menu to run the project. 


The project builds and executes. Internet Explorer opens the URI http://localhost/VJSharpWebService/Service.asmx. This 
is the test page for all Web services methods of the Web service. 


9. Click the HelloWorld hyperlink. 


Internet Explorer opens http://localhost/VJSharpWebService/Service.asmx?0p=HelloWorld. This is the test page for the 
HelloWorld Web service method. 


10. Click the Invoke button. 


Internet Explorer opens a new page that displays the XML code generated by the HelloWorld Web service method, as 
follows: 


<?xml version="1.0" encoding="utf-8" ?> 


<string xmlns="http://tempuri.org/">Hello World</string> 








To create a client that accesses this XML Web service, see one of the following: 


e Walkthrough: Accessing an XML Web Service with a Visual J# Web Forms Client 


e Walkthrough: Accessing an XML Web Service with a Visual J# Windows Client 


See Also 
Other Resources 
XML Web Services Walkthroughs (Visual J#) 


Visual J# Concepts 


Walkthrough: Accessing an XML Web Service with a Visual J# 
Web Forms Client 


The following walkthrough describes the process for writing a simple Web Forms application using Visual J#. The application is 
a client for the XML Web service created in Walkthrough: Creating an XML Web Service with Visual J#. This walkthrough 
assumes you have completed the XML Web service walkthrough. 


Web Forms are ASP.NET components that let you create forms on Web pages that can present information on any browser, 
using any markup language, and use code on the server to implement application logic. For more information, see 
ASP.NET Web Pages (Visual Studio). 


In the first part of this walkthrough, you will create the Web Forms client. 


Create the Web Forms Client 


To create a Web Forms client using Visual J# 


1. 


From the File menu, point to New, and then click Web Site. 


The New Web Site dialog box appears. 


. Click the ASP.NET Web Application icon. 
. Select Visual J# from the Language box. 
. Select HTTP in the Location box, if it is not already displayed in the box. 


. In the Location box, type the name and the location of the Web application. Specify VJSharpWebForms as the 


application name. By default, the project uses your local machine, "http://localhost" as the address of the Web application. 


. Click OK. 


The Visual Studio template creates a solution for you. The project template adds a template file, default.aspx, to the 
project and opens this file in Design view. The default template contains a Form control. The project template also creates 
the code-behind file, Web.Config. 


. Open the Toolbox, and drag a Label and a Button control to the design surface. 


The Label1 and Button1 controls are created. 


. Change the text property of the button to read Click Here. 


. Double-click the button. 


The Buttonl_Click event handler is created, and the Code Editor opens. 


. Insert the following code in the body of the event handler: 


Label1.set_Text ("Hello World"); 


. Click Start Without Debugging on the Debug menu to run the project. 


The project builds and Internet Explorer opens the resulting Web page with this URL: 


http: //localhost/VIJSharpWebForms/default.aspx 


. Click the Click Here button on the form. 


The label's text changes to "Hello World." 


Consume the XML Web Service 


In this part of the walkthrough, you will consume the XML Web service created in 
Walkthrough: Creating an XML Web Service with Visual J#. 


To consume the XML Web service 


1. In Solution Explorer, right-click the References node of the VJSharpWebForms project, and then click Add Web 
Reference. 


The Add Web Reference dialog box opens. 


2. Type the following Web service address in the URL box, and then click Go: 


http: //localhost/VIJSharpWebService/Service.asmx 


This is the URI of the Web service you created in Walkthrough: Creating an XML Web Service with Visual J#. The 
HelloWorld Web services method appears in the left pane of the Add Web Reference dialog box. 








Note 





: As an alternative to writing the Web service address in the URL box, you can choose to browse to the specific Web se 
rvice by selecting the option Web Services on the local machine from the Add Web Dereference dialog box. 











3. Click Add Reference. 


A proxy class is generated for the VJSharpWebService Web service and is added to the project. Web services methods 
can now be invoked as if they were locally defined methods. The proxy class routes the Web services method calls to the 
Web services server, using SOAP over HTTP transport. 


4. Click the file default.aspx, and select View Designer to return to the design surface. 

5. Open the Toolbox, click the Standard tab, and drag another label to the design surface. 
The Label2 control is created. 

6. Double-click the Click Here button. 
The Code Editor opens. 


7. Add these lines to the body of the event handler Button1_Click: 


// Nisual J# 


localhost.Service service = new localhost.Service(); 
Label2.set_Text(service.HelloWorld()); 








8. Press F5 to run the project. 

The project builds and Internet Explorer opens the resulting Web page. 
9. Click the Click Here button on the form. 

Both labels display the text "Hello World." 


See Also 

Tasks 

Walkthrough: Accessing an XML Web Service with a Visual J# Windows Client 
Other Resources 
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Walkthrough: Accessing an XML Web Service with a Visual J# 
Windows Client 


The following walkthrough describes the process for writing a simple Windows Form application using Visual J#. The 
application is a client for the XML Web service created in Walkthrough: Creating an XML Web Service with Visual J#. This 
walkthrough assumes you have completed the XML Web service walkthrough. 


First, you will create the client and add a Web reference to the XML Web service. Then, you modify the client's user interface so 
that the client can invoke the XML Web service. You can then build and test the client 


Create a Windows Application 


To create a Windows application accessing an XML Web service client 


1. 


On the File menu, click Open Project/Solution. 


The Open Solution dialog box appears. 


. Select the VJSharpWebService solution, and click Open. 


. In Solution Explorer, right-click the solution root VJSharpWebService, point to Add, and then click New Project. 


The Add New Project dialog box appears. 


. Select the Visual J# from Project Types, and select the Windows Application icon. 
. Inthe Name box, type VJSharpWinClient. 
. Click OK. 


The project template creates the VJSharpWinClient project, and opens the Windows Forms Designer. 


. In Solution Explorer, right-click the project node VJSharpWinClient, and then click Set as Startup Project. 


. In Solution Explorer, right-click the References node of the VJSharpWinClient project, and then click Add Web 


Reference. 


The Add Web Reference dialog box opens. 


. Type the following Web service address in the URL box, and then click Go: 


http: //localhost/VIJSharpWebService/Service.asmx 


This is the URI of the Web service you created in Walkthrough: Creating an XML Web Service with Visual J#. The 
HelloWorld Web service method appears in the left pane of the Add Web Reference dialog box. 





: As an alternative to writing the Web service address in the URL box, you can choose to browse to the specific Web se 
rvice by selecting the option Web Services on the local machine from the Add Web Dereference dialog box. 





. Click Add Reference. 


A proxy class is generated for the VJSharpWebService Web service and is added to the project. Web services methods 
can now be invoked as if they were locally defined methods. The proxy class routes the Web services method calls to the 
Web services server, using SOAP over HTTP transport. 


Modify the Client to Invoke the XML Web Service 


The next task is to modify the client's user interface so that the client can invoke the XML Web service. You can then build and 
test the client. 


To modify the client's user interface 


1. Open the Toolbox, and drag a label and a button control to Form. 
The label1 and button1 controls are created. 
2. Change the text property of button1 to read Click Here. 
3. Double-click the Click Here button. 
The button1_Click event handler is created in the Form1,jsl source file. The Code Editor opens. 


4. Replace the body of the event handler with the following code: 


// Nisual J# 


VISharpWinClient.localhost.Service service = new VJSharpWinClient.localhost.Service(); 
label1.set_Text(service.HelloWorld()); 








5. Press F5 to run the project. 
The project builds and executes. 
6. Click button1 on the form. 


The label1 text changes to "Hello World". 


See Also 

Tasks 

Walkthrough: Accessing an XML Web Service with a Visual J# Web Forms Client 
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Components and Controls Authoring Walkthroughs 


The following walkthroughs demonstrate how to use components, controls, and threading. 


In This Section 
Walkthrough: Authoring a Component with Visual J# 


Shows the development of a simple component, illustrating the interaction between client and component, object lifetime 
and circular references, debugging clients and components, and using shared methods and instance methods. 


Walkthrough: Authoring a Simple Multithreaded Component with Visual J# 


Demonstrates how to create a multithreaded component, explaining how threads work and how to coordinate multiple 
threads in your component. 


Walkthrough: Authoring a User Control with Visual J# 


Shows the development of a simple user control that inherits from the UserControl class, and how to inherit from an 
established user control. 


Walkthrough: Inheriting from a Windows Forms Control with Visual J# 


Demonstrates how to create a simple inherited button control. This button inherits functionality from the standard Windows 
Forms button and exposes a custom member. 


Related Sections 
Visual J# Walkthroughs 


Describes how to create distributed Web applications, work with Windows Forms and Web Forms, and create and access 
XML Web services. 


Programming with Components 


Visual Basic/Visual C# section that describes components of all kinds, including those you use on servers. 


Visual J# Reference 


Provides links to reference documentation on J# keywords, J# operators, J# classes, and so on. 


Visual J# Concepts 


Walkthrough: Authoring a Component with Visual J# 


Components provide reusable code in the form of objects. An application that uses a component's code, by creating objects 
and calling their properties and methods, is referred to as a client. A client may or may not be in the same assembly as a 
component it uses. 


The procedures build on each other, so the order in which you perform them is important. 


Creating the Project 


To create the CDemoLib class library and the CDemo component 


1. 


8. 


From the File menu, select New and then Project to open the New Project dialog box. Select the Class Library project 
template from the list of Visual J# projects, and enter CDemoLib in the Name box. 





Note 





Always specify the name of a new project when you create it. Doing so sets the root package, assembly name, and proj 
ect name, and also ensures that the default component will be in the correct package. 











Click OK. 


On the Project menu, click Add Component. 


. In the Add New Item dialog box, select Component Class, and in the Name box, type CDemojsl. Click Add. 


A component named CDemojsl is added to your class library. 
In Solution Explorer, right-click CDemo.jsl, and click View Code. The Code Editor opens. 


Notice the code extends System.ComponentModel .Component immediately after public class CDemo. This designates 
the class from which your class inherits. By default, a component inherits from the Component class provided by the 
system. The Component class provides many features for your component, including the ability to use designers. 


In Solution Explorer, right-click Class1.jsl and click Delete. 
This deletes the default class that is provided with the class library, as it will not be used in this walkthrough. 


On the File menu, click Save All to save the project. The Save Project dialog box opens. The dialog box shows the 
Name, Location, and New Solution Name. You can change any of these items when you save the project. 


Click Save. 


Adding Constructors and a Finalize Method 


Constructors control the way your component is initialized; the Finalize method controls the way it tears down. Code in the 
constructor and the Finalize method of the CDemo class maintains a running count of the number of CDemo objects in 
existence. 


To add code for the constructor and Finalize method of the CDemo class 


1. 


In the Code Editor, add member variables to the CDemo class to keep a running total of instances of the CDemo class, 
and an ID number for each instance. 


// Visual J# 

private long InstanceID; 

private static long NextInstanceID = @; 
private static long ClassInstanceCount = Q; 


Because the ClassInstanceCount and Next InstanceID member variables are declared static, they exist only at the class 
level. All instances of cDemo that access these members will use the same memory locations. Shared members will be 
initialized the first time the CDemo class is referred to in code. This could be the first time a CDemo object is created, or the 
first time one of the class's shared members is accessed. 


2. Locate the constructors public CDemo() and public CDemo (System.ComponentModel.IContainer container). 


These are the default constructors for the cDemo class. Your component can have several constructors, with different 
parameters, but they must all have the same name as the class 





Note 





The access level of a class's constructors determines what clients will be able to create instances of the class. 











3. Add the following code to public CDemo (), to increment the instance count when a new CDemo is created, and to set the 
instance ID number. 





Note 





Always add your code after the call to InitializeComponent. At that point, any constituent components have been initi 
alized. 








// Nisual J# 
InstanceID = NextInstanceID ++; 
ClassInstanceCount ++; 








Note 





Users familiar with multithreading will see that assigning InstanceID and incrementing Next InstanceID should be an 
atomic operation. 








4. Add the following method after the end of the constructor: 





// Visual J# 
protected void Finalize() 


{ 


ClassInstanceCount --; 





The memory manager calls Finalize just before it finally reclaims memory occupied by the CDemo object. The Finalize 
method originates with Object, the root of all reference types in the INET Framework. By overriding Finalize, you can 
perform cleanup just before your component is removed from memory. However, as you will see, there are good 
reasons to release resources earlier. 


Adding a Method to the Class 


The CDemo class has a member that allows the client to find out how many CDemo objects there are in memory at any given 
time. 


To create a method to retrieve the number of instances of CDemo 


e Add the following method declaration to the CDemo class, to allow clients to retrieve the number of instances of CDemo. 


// Visual J# 
public static long getInstanceCount() 
{ 


return ClassInstanceCount; 





To build the component 


@ On the Build menu, click Build Solution. 


The build should succeed with no compiler errors or warnings. 








Testing the Component 


To test the component, you need a project that uses it. This project must be the first project that starts when you press the Run 
button. 


To add the CDemoTest client project as the startup project for the solution 


1. From the File menu, point to Add Project, and click New Project. The Add New Project dialog box opens. 


2. Click the Windows Application project template from the list of Visual J# projects, and in the Name box, type 
CDemotTest, and then click OK. 


This adds the new project to the solution, and opens Form1 jsl in the Designer view. 


3. In Solution Explorer, right-click CDemoTest, and on the shortcut menu, click Set as Startup Project. 


To use the CDemo component, the client test project must have a reference to the class library project. After adding the 
reference, it is a good idea to add an import statement to the test application to simplify the use of the component. 


To add a reference to the class library project 


1. In Solution Explorer, right-click the References node immediately beneath CDemoTest, and on the shortcut menu, 
click Add Reference. 


2. In the Add Reference dialog box, click the Projects tab. 


3. Double-click the CDemoLib class library project, to add it to the Selected Components list. CDemoLib will appear 
under the References node for the CDemoTest project. 


4. In Solution Explorer, right-click Form1.jsl, and on the shortcut menu, click View Code. 


Adding the reference to CDemoLib allows you to use the fully qualified name of the CDemo component in your code; that is, 
CDemoLib.CDemo. 


To add an import statement 
e Add the following import statement to the list of import statements at the top of the Code Editor for Form1. 
// Nisual J# 
import CDemoLib.*; 
Adding the import statement allows you to omit the library name, and refer to the component type as CDemo. 
You will now create and use a test program to test your component. 


Understanding Object Lifetime 


The CDemoTest program will illustrate object lifetime in the NET Framework by creating and releasing large numbers of 
CDemo objects. 


To add code to create and release CDemo objects 
1. Right-Click Form1 jsl, and click View Designer to open the Design view. 
2. Drag a button and a timer from the All Windows Forms tab of the Toolbox onto the Form1 design surface. 
The timer1 component icon appears on a separate design surface below the form. 
3. Double-click the icon for timer1 to create an event-handling method for the timer1 component's Tick event. Place the 


following code in the event-handling method. 


// Visual J# 
this.set_Text("CDemo instances: " + CDemo.getInstanceCount()); 


On every tick of the timer, the form's caption will display the current instance count for the CDemo class. The class name 
is used as a qualifier for the shared InstanceCount property—there is no need to create an instance of CDemo to access a 


shared member. 


4. Locate the constructor for Form1 (public Form ()), and add the following code after the call to InitializeComponent (). 


// Visual J# 
timer1.set_Enabled(true); 


This will start the timer as soon as the form is created. 
5. Click the Form1.jsl [Design] tab to return to the designer. 


6. Double-click the Button on Form1, to create an event-handling method for the button's Click event. Place the following 
code in the event-handling method. 


// Nisual J# 

CDemo cd; 

int ct; 

for (ct = 0; ct < 1000; ct++) 
{ 


cd = new CDemo(); 





This code might look strange to you. As each instance of CDemo is created, the previous instance is released. When the 
for loop is done, there will be only one instance of CDemo left. When the event-handling method exits, even that instance 
will be released, because the variable ca will go out of scope. 


To run and debug the CDemoTest and CDemo projects 


1. Press F5 to start the solution. 


The client project will start, and Form1 will be displayed. Notice that the caption of the form displays "CDemo instances: 
0% 

2. Click the button. The caption of the form should display "CDemo instances: 1000". 
The instances of CDemo were all released by the time the button's Click event-handling procedure finished. In brief, the 


memory manager finalizes objects in the background, at low priority. The priority is only increased if the system gets low 
on memory. This type of garbage collection scheme allows for very fast object allocation. 


3. Click the button several more times, watching the caption. At some point, the number of instances will suddenly drop. 
This means that the memory manager has reclaimed the memory of some of the objects. 





Note 





If you have clicked more than 10 times, and the number of CDemo instances has not decreased, you may need to adjus 
t the code so that it uses more memory. Close the form to return to the development environment, and increase the nu 
mber of iterations in the for loop to 10000. Then run the project again. 











4. Repeat step 3. You will get farther this time before the memory manager finalizes more objects. 


In fact, each time you repeat step 3, you will probably be able to allocate more CDemo objects before the memory 
manager steps in. This is because more and more of Visual Studio is swapped out, leaving more space for instances of 
CDemo. 


5. Close the form to return to the development environment. 


See Also 
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Visual J# Concepts 


Walkthrough: Authoring a Simple Multithreaded Component 
with Visual J# 


You can write applications that are able to perform multiple tasks simultaneously. This ability, called multithreading, or free 
threading, is a powerful way to design components that are processor-intensive and require user input. An example of a 
component that might make use of multithreading would be a component that calculates payroll information. The component 
could process data entered into a database by a user on one thread while processor-intensive payroll calculations were 
performed on another. By running these processes on separate threads, users do not need to wait for the computer to 
complete calculations before entering additional data. In this walkthrough, you will create a simple multithreaded component 
that performs several complex calculations simultaneously. 


Creating the Project 


Your application will consist of a single form and a component. The user will input values and signal to the component to begin 
calculations. The form will then receive values from your component and display them in label controls. The component will 
perform the processor-intensive calculations and signal the form when complete. 


You will create public variables in your component to hold values received from your user interface. You will also implement 
methods in your component to perform the calculations based on the values of these variables. 


Note 


Although a function is usually preferable for a method that calculates a value, arguments cannot be passed between threads, 
nor can values be returned. There are many simple ways to supply values to threads and to receive values from them. In this 
demonstration, you will return values to your user interface by updating public variables, and events will be used to notify th 
@ main method when a thread has completed execution. 








Note 





The dialog boxes and menu commands you see might differ from those described in Help depending on your active settings 
or edition. To change your settings, choose Import and Export Settings on the Tools menu. For more information, see 
Visual Studio Settings. 











To create the form 


1. Create a new Windows Application project. 
2. Name the application Calculations, and rename Form1jsl as frmCalculations,jsl. 
This form will serve as the primary user interface for your application. 
3. In Solution Explorer, right-click frmCalculations.jsl, and click View Code. The Code Editor opens. 


4. On the Edit menu, click Find and Replace, then click Replace in Files to replace Form1 with frmCalculations.jsl in the 
entire solution. Click Replace All. 


5. In Solution Explorer, right-click frmCalculations.jsl, and click View Designer. The designer opens. 
6. Add five Label controls, four Button controls, and one TextBox control to your form. 


7. Set properties for these controls as follows: 

















Control Name Text 

Label1 IblFactorial1 (blank) 
Label2 IblFactorial2 (blank) 
Label3 IblAddTwo (blank) 
Label4 IbIRunLoops (blank) 





























Label5 IbITotalCalculations (blank) 
Button1 btnFactorial1 Factorial 
Button2 btnFactorial2 Factorial - 1 
Button3 btnAddTwo Add Two 
Button4 btnRunLoops Run a Loop 
Textbox! txtValue (blank) 











To create the Calculator component 


1. On the Project menu, click Add Component. 


2. Name the component Calculatorjsl. 


To add public variables to the Calculator component 


1. Open the Code Editor for Calculator. 
2. Add statements to create public variables that you will use to pass values from frmCalculations to each thread. 


The variable varTotalCalculations will keep a running total of the number of calculations performed by the component, 
and the other variables will receive values from the form. 


// Visual J# 

public int varAddTwo; 

public int varFact1; 

public int varFact2; 

public int varLoopValue; 

public double varTotalCalculations = @; 











To add methods and events to the Calculator component 


1. Declare the delegates for the events that your component will use to communicate values to your form. 





Although you will be declaring four events, you only need to create three delegates, because two events will have the s 
ame signature. 





Immediately beneath the variable declarations entered in the previous step, add the following code: 


// Visual J# 

// This delegate will be invoked with two of your events. 

/**@delegate */ 

public delegate void FactorialCompleteHandler(double Factorial, double TotalCalculatio 
ns); 

/**@delegate */ 

public delegate void AddTwoCompleteHandler(int Result, double TotalCalculations) ; 
/**@delegate */ 

public delegate void LoopCompleteHandler(double TotalCalculations, int Counter); 








2. Add the following code immediately beneath the code from the previous step to declare the events that your component 
will use to communicate with your application. 


// Visual J# 

public FactorialCompleteHandler FactorialComplete1; 

public FactorialCompleteHandler FactorialMinusOneComplete1; 
public AddTwoCompleteHandler AddTwoComplete1; 

public LoopCompleteHandler LoopComplete1; 


/** @event */ 
public void add FactorialComplete(FactorialCompleteHandler e) 
{ 
FactorialComplete1 = (FactorialCompleteHandler) System.Delegate.Combine(this.Facto 
rialComplete1, e); 
i 
/** @event */ 
public void remove_FactorialComplete(FactorialCompleteHandler e) 
{ 
FactorialCompletel = (FactorialCompleteHandler) System.Delegate.Remove(this.Factori 
alComplete1, e); 


} 


/** @event */ 
public void add FactorialMinusOneComplete(FactorialCompleteHandler e) 
{ 
FactorialMinusOneComplete1 = (FactorialCompleteHandler) System.Delegate.Combine(thi 
s.FactorialMinusOneCompletel1, e); 
} 
/** @event */ 
public void remove_FactorialMinusOneComplete(FactorialCompleteHandler e) 
{ 
FactorialMinusOneCompletel = (FactorialCompleteHandler) System.Delegate.Remove(this 
.FactorialMinusOneComplete1, e); 


} 


/** @event */ 
public void add _AddTwoComplete(AddTwoCompleteHandler e) 


{ 

AddTwoComplete1 = (AddTwoCompleteHandler) System.Delegate.Combine(this.AddTwoComple 
tel, e); 
} 


/** @event */ 
public void remove_AddTwoComplete(AddTwoCompleteHandler e) 


{ 

AddTwoComplete1 = (AddTwoCompleteHandler) System.Delegate.Remove(this.AddTwoComplet 
el, e); 
} 


/** @event */ 
public void add_LoopComplete(LoopCompleteHandler e) 
{ 
LoopComplete1 = (LoopCompleteHandler) System.Delegate.Combine(this.LoopComplete1, e 
)3 
} 
/** @event */ 
public void remove_LoopComplete(LoopCompleteHandler e) 


{ 
LoopComplete1 = (LoopCompleteHandler) System.Delegate.Remove(this.LoopComplete1, e) 


wee 


3. Immediately beneath the code you added in the previous step, add the following code: 


// Visual J# 

// This method will calculate the value of a number minus 1 factorial 
// (varFact2-1!). 

public void FactorialMinusOne() 


{ 
double varTotalAsOfNow = @; 
double varResult = 1; 
// Performs a factorial calculation on varFact2 - 1. 
for (int varX = 13 varX <= varFact2 - 13; varX++) 
{ 
varResult *= varx; 
// Increments varTotalCalculations and keeps track of the 
// current total as of this instant. 
varTotalCalculations += 1; 
varTotalAsOfNow = varTotalCalculations; 
} 
// Signals that the method has completed and communicates the 
// result and a value of total calculations performed up to this 
// point. 
FactorialMinusOneComplete1.Invoke(varResult, varTotalAsOFfNow) ; 
} 


// This method will calculate the value of a number factorial. 
// (varFact1! ) 
public void Factorial() 


{ 


double varResult = 1; 
double varTotalAsOfNow = @; 
for (int varX = 13 varX <= varFact1; varX++) 


{ 


varResult =varResult * varx; 


varTotalCalculations =varTotalCalculations + 1; 
varTotalAsOfNow = varTotalCalculations; 


} 
FactorialComplete1.Invoke(varResult, varTotalAsOFfNow) ; 


// This method will add 2 to a number (varAddTwo+2). 
public void AddTwo() 


{ 
double varTotalAsOfNow = @; 
int varResult = varAddTwo + 2; 
varTotalCalculations = varTotalCalculations + 1; 
varTotalAsOfNow = varTotalCalculations; 
AddTwoComplete1.Invoke(varResult, varTotalAsOFfNow) ; 
} 


// This method will run a loop with a nested loop varLoopValue times. 
public void RunALoop() 


i 


int varx; 


double varTotalAsOfNow = @; 
for (varX = 13 varX <= varLoopValue; varX++) 


{ 
// This nested loop is added to slow down the program 
// and create a processor-intensive application. 
for (int varY = 1; varY <= 500; varY++) 
{ 
varTotalCalculations += 1; 
varTotalAsOfNow = varTotalCalculations; 
} 
} 


LoopComplete1.Invoke(varTotalAsOfNow, varLoopValue) ; 


Transferring User Input to the Component 


The next step is to add code to frmCalculations to receive input from the user and to transfer and receive values to and from 
the Calculator component. 


To implement front-end functionality to frmCalculations 


1. Open frmCalculations.jsl in the Code Editor. 


2. Locate the public class frmCalculations statement. Immediately beneath the {, add: 


// Nisual J# 
Calculator Calculator1; 


3. Locate the constructor. Immediately after InitializeComponent (), add the following lines: 


// Nisual J# 
// Creates a new instance of Calculator. 
Calculator1 = new Calculator(); 


4. In the designer, click each button to generate the code outline for each control's click event handlers, and add code to 
create the handlers. 


When complete, your click event handlers should resemble the following: 


// Visual J# 
private void btnFactorial1 Click (Object sender, System.EventArgs e) 


+ 
Calculator1.varFact1 = Integer.parseInt(txtValue.get_Text()); 
// Disables the btnFactorial1 until this calculation is complete. 
btnFactorial1.set_Enabled(false) ; 
Calculator1.Factorial(); 
} 
private void btnFactorial2 Click (Object sender, System.EventArgs e) 
{ 
Calculator1i.varFact2 = Integer.parseInt(txtValue.get_Text()); 
btnFactorial2.set_Enabled(false) ; 
Calculator1.FactorialMinusOne() ; 
} 


private void btnAddTwo_Click (Object sender, System.EventArgs e) 


{ 
Calculator1.varAddTwo = Integer.parseInt(txtValue.get_Text()); 


btnAddTwo.set_Enabled(false) ; 


Calculator1.AddTwo(); 


} 

private void btnRunLoops_ Click (Object sender, System.EventArgs e) 

{ 
Calculator1.varLoopValue = Integer.parseInt(txtValue.get_Text()); 
btnRunLoops.set_Enabled(false) ; 
// Let the user know that a loop is running. 
lb1RunLoops.set_Text( "“Looping"); 
Calculator1.RunALoop(); 

} 


5. Beneath the code you added in the previous step, add the following code to handle the events your form will receive 
from Calculator1: 


// Visual J# 
protected void FactorialHandler(double Value, double Calculations) 
// Displays the returned value in the appropriate label. 


{ 
lblFactorial1.set_Text(""+ Value); 
// Re-enables the button so it can be used again. 
btnFactorial1.set_Enabled( true); 
// Updates the label that displays the total calculations 
// performed. 
lblTotalCalculations.set_Text("TotalCalculations are " + 
Calculations) ; 
} 
protected void FactorialMinusHandler(double Value, double Calculations) 
{ 
lblFactorial2.set_Text(""+Value) ; 
btnFactorial2.set_Enabled(true) ; 
lblTotalCalculations.set_Text("TotalCalculations are " + Calculations); 
} 
protected void AddTwoHandler(int Value, double Calculations) 
{ 
lblAddTwo.set_Text(""+Value) ; 
btnAddTwo.set_Enabled(true) ; 
lblTotalCalculations.set_Text("TotalCalculations are " + Calculations); 
} 
protected void LoopDoneHandler(double Calculations, int Count) 
{ 
btnRunLoops.set_Enabled(true) ; 
lb1RunLoops.set_Text(""+Count) ; 
lblTotalCalculations.set_Text("TotalCalculations are " + Calculations); 
} 


6. In the constructor of frmCalculations, add the following code immediately after the line calculatorl = new 
Calculator (); to handle the custom events your form will receive from Calculator1. 


// Visual J# 

Calculator1.add_FactorialComplete(new Calculator.FactorialCompleteHandler(FactorialHan 
dler)); 

Calculator1.add_FactorialMinusOneComplete(new Calculator.FactorialCompleteHandler(this 
.FactorialMinusHandler) ); 

Calculator1.add_AddTwoComplete(new Calculator .AddTwoCompleteHandler (this .AddTwoHandler 


))3 
Calculator1.add_LoopComplete(new Calculator. LoopCompleteHandler(this.LoopDoneHandler) ) 


I 


Testing Your Application 


You have now created a project that incorporates a form and a component capable of performing several complex calculations. 
Although you have not implemented multithreading capability yet, you will test your project to verify its functionality before 
proceeding. 


To test your project 


‘lt 


Press F5 to start the solution. 


The application begins, and frmCalculations is displayed. 


. In the text box, type 4, and then click the Add Two button. 


The numeral "6" should be displayed in the label beneath it, and "Total Calculations are 1.0" should be displayed in 
IbITotalCalculations. 


. Now click the Factorial - 1 button. 


The numeral "6.0" should be displayed beneath the button, and IbITotalCalculations now reads "Total Calculations are 
4.0". 


. Change the value in the text box to 20, and then click the Factorial button. 


The number "2.43290200817664E18" is displayed beneath it, and IbITotalCalculations now reads "Total Calculations 
are 24.0". 


. Change the value in the text box to 50000, and then click the Run a Loop button. 


Note that there is a small but noticeable interval before this button is re-enabled. The label under this button should read 
"50000" and the total calculations displayed are "2.5000024E7." 


. Change the value in the text box to 500000 and click the Run a Loop button, then immediately click the Add Two button 


twice. 


The button does not respond, nor will any control on the form respond until the loops have been completed. Close the 
program. 


If your program runs only a single thread of execution, processor-intensive calculations such as the above example have 
the tendency to tie up the program until the calculations have been completed. In the next section, you will add 
multithreading capability to your application so that multiple threads can be run at once. 


Adding Multithreading Capability 


The previous example demonstrated the limitations of applications that run only a single thread of execution. In the next 
section you will use the Thread class object to add multiple threads of execution to your component. 


To add the Threads method 


1. 


2. 


3. 


Open Calculator.jsl in the Code Editor. 
Add the following member variables to the Calculator class: 
// Visual J# 
public System. Threading.Thread FactorialThread; 
public System.Threading.Thread FactorialMinusOneThread; 


public System.Threading.Thread AddTwoThread; 
public System. Threading.Thread LoopThread; 


Immediately before the end of the class declaration at the bottom of the file, add the following method: 


// Nisual J# 


public void ChooseThreads(int threadNumber) 
{ 
// Determines which thread to start based on the value 
// it receives. 
switch(threadNumber ) 
{ 
case 1: 
// Sets the thread using the AddressOf the method where 
// the thread will start. 
FactorialThread = new System. Threading. Thread(new System. Threading. Threads 
tart(this.Factorial)); 
// Starts the thread. 
FactorialThread.Start(); 
break; 
case 2: 
FactorialMinusOneThread = new System. Threading. Thread(new System. Threading 
. ThreadStart(this.FactorialMinusOne) ); 
FactorialMinusOneThread.Start(); 
break; 
case 3: 
AddTwoThread = new System. Threading. Thread(new 
System. Threading. ThreadStart(this.AddTwo) ) ; 
AddTwoThread.Start(); 
break; 
case 4: 
LoopThread = new System. Threading. Thread(new 
System. Threading. ThreadStart(this.RunALoop) ) ; 
LoopThread.Start(); 
break; 








When a Thread object is instantiated, it requires an argument in the form of a ThreadStart object. The ThreadStart 
object is a delegate that points to the address of the method where the thread is to begin. A ThreadStart object cannot 
take parameters or pass values, and therefore can only indicate a void (Visual J#) method. The chooseThreads method 
you just implemented will receive a value from the program calling it and use that value to determine the appropriate 
thread to start. 


To add the appropriate code to frmCalculations 


1. In the Code Editor, open the frmCalculations,sl file, then locate private void btnFactoriall Click. 


a. Comment out the line that calls the calculatorl.Factoriall method directly as shown: 


// Nisual J# 


// Calculator1.Factorial() 








b. Add the following line to call the calculator1.ChooseThreads method: 





// Visual J# 
// Passes the value 1 to Calculatori, thus directing it to 


// start the Correct thread. 
Calculator1.ChooseThreads (1) ; 





2. Make similar modifications to the other button_click methods. 





Be certain to include the appropriate value for the Threads argument. 











When you have finished, your code should look similar to the following: 


// Visual J# 
private void btnFactorial1 Click (Object sender, System.EventArgs e) 


{ 
Calculator1.varFact1 = Integer.parseInt(txtValue.get_Text()); 
// Disables the btnFactorial1 until this calculation 
// is complete. 
btnFactorial1.set_Enabled(false) ; 
// Calculator1.Factorial(); 
Calculator1.ChooseThreads(1) ; 
} 
private void btnFactorial2 Click (Object sender, System.EventArgs e) 
{ 
Calculator1.varFact2 = Integer.parseInt(txtValue.get_Text()); 
btnFactorial2.set_Enabled(false) ; 
// Calculator1.FactorialMinusOne(); 
Calculator1.ChooseThreads(2) ; 
} 
private void btnAddTwo_Click (Object sender, System.EventArgs e) 
{ 
Calculator1.varAddTwo = Integer.parseInt(txtValue.get_Text()); 
btnAddTwo.set_Enabled(false) ; 
// Calculator1.AddTwo() ; 
Calculator1.ChooseThreads (3) ; 
} 
private void btnRunLoops Click (Object sender, System.EventArgs e) 
{ 
Calculator1.varLoopValue = Integer.parseInt(txtValue.get_Text()); 
btnRunLoops.set_Enabled(false) ; 
// Let the user know that a loop is running. 
lb1RunLoops.set_Text( "“Looping"); 
// Calculator1.RunALoop(); 
Calculator1.ChooseThreads (4) ; 
} 


Marshaling Calls to Controls 


You will now facilitate updating the display on the form. Because the main thread of execution always owns controls, any call to 
a control from a subordinate thread requires a marshaling call. Marshaling is the act of moving a call across thread boundaries, 
and is very expensive in terms of resources. To minimize the amount of marshaling that needs to occur, and to be sure that 
your calls are handled in a thread-safe manner, you will use the Control .BeginInvoke method to invoke methods on the main 
thread of execution. This kind of call is necessary when calling methods that manipulate controls. For more information, see 
How to: Manipulate Controls from Threads. 


To create the control-invoking procedures 


1. Open the Code Editor for frmCalculations. In the declarations section, add the following code: 


// Visual J# 

/**@delegate */ 

public delegate void FHandler(double Value, double Calculations) ; 
/**@delegate */ 


public delegate void A2Handler(int Value, double Calculations) ; 
/**@delegate */ 
public delegate void LDHandler(double Calculations, int Count); 


Invoke and BeginInvoke require a delegate to the appropriate method as an argument. These lines declare the delegate 
signatures that will be used by BeginInvoke to invoke the appropriate methods. 


2. Add the following empty methods to your code: 


// Visual J# 
public void FactHandler(double Value, double Calculations) 
{ 


} 
public void FactiHandler(double Value, double Calculations) 


{ 


} 
public void Add2Handler(int Value, double Calculations) 


x 
} 


public void LDoneHandler(double Calculations, int Count) 
{ 
} 


3. From the Edit menu, use Cut and Paste to cut all the code from the method FactorialHandler and paste it into 


FactHandler. 


4. Repeat the previous step from FactorialMinusHandler to Fact1Handler, from AddTwoHandler to Add2Handler, and from 


LoopDoneHandler tO LDoneHandler. 


When finished, there should be no code remaining in FactorialHandler, FactoriallHandler, AddTwoHandler, and 





LoopDoneHandler, and all the code these used to contain should have been moved to the appropriate new methods. 


5. Call the BeginInvoke method to invoke the methods asynchronously. You can call BeginInvoke from either your form 
(this) or any of the controls on the form. 


When complete, your code should look similar to the following: 


// Visual J# 
protected void FactorialHandler(double Value, double Calculations) 
// Displays the returned value in the appropriate label. 


{ 
this.BeginInvoke(new FHandler(FactHandler), new Object[] {(System.Double)Value, (S 
ystem.Double)Calculations}); 


} 


protected void FactorialMinusHandler(double Value, double Calculations) 


{ 
this.BeginInvoke(new FHandler(FactiHandler), new Object [] {(System.Double)Value, 
(System.Double)Calculations}) ; 


} 


protected void AddTwoHandler(int Value, double Calculations) 


{ 
this.BeginInvoke(new A2Handler(Add2Handler), new Object[] {(System.Int32)Value, (S 
ystem.Double) Calculations}); 


} 


protected void LoopDoneHandler(double Calculations, int Count) 


{ 


this.BeginInvoke(new LDHandler(LDoneHandler), new Object[]{(System.Double)Calculat 
ions, (System. Int32)Count}); 
} 


It may seem as though the event handler is simply making a call to the next method. The event handler is actually 
causing a method to be invoked on the main thread of operation. This approach saves on calls across thread boundaries 
and allows your multithreaded applications to run efficiently and without fear of causing lockup. For more information, 
see How to: Manipulate Controls from Threads. 


6. Save your work. 
7. On the Debug menu, click Start to test your solution. 
a. Type 1000000 in the text box, and click Run a Loop. 


"Looping" is displayed in the label beneath this button. This loop should take a significant amount of time to run. If 
it completes too early, adjust the size of the number accordingly. 


b. In rapid succession, click all three buttons that are still enabled. You will find that all buttons respond to your input. 
The label beneath Add Two should be the first to display a result. Results will be displayed in the labels beneath 
the factorial buttons eventually. These results evaluate to infinity, as the number returned by a 1,000,000 factorial is 
too large for a double-precision variable to contain. Finally, after an additional delay, results are returned beneath 
the Run a Loop button. 


As you just observed, four separate sets of calculations were performed simultaneously upon four separate 
threads. The user interface remained responsive to input, and results were returned after each thread completed. 


Coordinating Your Threads 


An experienced user of multithreaded applications might perceive a subtle flaw with the code as typed. Recall the lines of code 
from each calculation-performing methods in Calculator.jsl: 


// Nisual J# 
varTotalCalculations = varTotalCalculations + 1; 
varTotalAsOfNow = varTotalCalculations; 


These two lines of code increment the public variable varTotalCalculations and set the local variable varTotalAsOfNow to this 
value. This value is then returned to frmCalculations, and displayed in a label control. If only a single thread of execution is 
running, the correct value is being returned. But if multiple threads are running, the answer becomes more uncertain. Each 
thread has the ability to increment the variable varTotalCalculations. It is possible that after one thread increments this 
variable, but before it copies the value to varTotalAsOfNow, another thread could alter the value of this variable by 
incrementing it. This leads to the possibility that each thread is, in fact, reporting inaccurate results. 


Use the synchronized keyword to allow synchronization of threads to ensure that each thread always returns an accurate 


result. The syntax is as follows: 


// Visual J# 
synchronized(AnObject) 


{ 
// Insert code that affects the object. 
// Insert more code that affects the object. 
// Insert more code that affects the object. 
// Release the lock. 

} 


When the synchronized block is entered, execution on the specified expression is blocked until the specified thread has an 
exclusive lock on the object in question. In the previous example, execution is blocked on Anobject. The execution may then 
proceed as a block without interference from other threads. A set of statements that execute as a unit are said to be atomic. 
When the } is encountered, the expression is freed and the threads are allowed to proceed normally. 


To add the synchronized block to your application 


1. Open Calculator.jsl in the Code Editor. 


2. Locate each instance of the following code: 





// Nisual J# 
varTotalCalculations = varTotalCalculations + 1; 
varTotalAsOfNow = varTotalCalculations; 








There should be four instances of this code, one in each calculation method. 


3. Modify this code for each instance so that it reads as follows: 


// Visual J# 
synchronized(this) 


{ 


varTotalCalculations = varTotalCalculations + 1; 
varTotalAsOfNow = varTotalCalculations; 











4. Save your work and test it as in the previous example. 


You may notice a slight impact on the performance of your program. This is because execution of threads stops when an 
exclusive lock is obtained on your component. Although it ensures accuracy, this approach impedes some of the 
performance benefits of multiple threads. You should carefully consider the need for locking threads, and implement 


them only when absolutely necessary. 


See Also 

Tasks 

How to: Coordinate Multiple Threads of Execution 
Other Resources 

Programming with Components 

Multithreading in Components 

Components and Controls Authoring Walkthroughs 


Visual J# Concepts 


Walkthrough: Authoring a User Control with Visual J# 


User controls provide a means by which custom graphical interfaces can be created and reused. A user control is essentially a 
component with a visual representation. As such, it might consist of one or more Windows Forms controls, components, or 
blocks of code. These elements can extend functionality by validating user input, modifying display properties, or performing 
other tasks required by the author. User controls can be placed on Windows Forms in the same manner as other controls. In 
the first part of this walkthrough, you create a simple user control called ctlClock. In the second part of the walkthrough, you 
extend the functionality of ctlClock through inheritance. 


Creating the Project 


When you create a new project, you specify its name to set the root package, assembly name, and project name, and ensure 
that the default component will be in the correct package. 


To create the ctlClockLib control library and the ctlClock control 


1. On the File menu, point to New, and then click Project to open the New Project dialog box. 


2. Click the Windows Control Library project template in the list of Visual J# Projects, and in the Name box, type 
ctlClockLib. 


The project name, ctlClockLib, is also assigned to the root package by default. The root package is used to qualify the 
names of components in the assembly. For example, if two assemblies provide components named ct1Clock, you can 
specify your ct1Clock component using ct1ClockLib.ct1Clock. 


3. In Solution Explorer, right-click UserControl1.jsl, and on the shortcut menu, select View Code. 


4. In Solution Explorer, right-click UserControl1.jsl and click Rename. Change the name from UserControl1,jsl to 
ctiClockjsl. 


5. Examine the class definition and the class constructor and notice that their names have changed from public class 
UserControll to public class ctlClock and from public UserControl1() to public ctlClock() respectively. 


6. On the File menu, click Save All to save the project. 


Adding Windows Controls and Components to Your User Control 


A visual interface is an essential part of your user control. This visual interface is implemented by the addition of one or more 
controls to the User Control Designer. In the following demonstration, you will incorporate controls into your user control and 
write code to implement functionality. 


To add a label and a timer to your user control 


1. In Solution Explorer, right-click ctlClock.jsl, and then select View Designer. 
2. In the Toolbox, click the All Windows Forms tab, and then double-click label. 
A label control named label1 is added to your control on the User Control Designer. 


3. In the designer, click label1. In the Properties window, set the following properties. 











Property Change to 
Name IbIDisplay 
Text (blank space) 
TextAlign MiddleCenter 
Font.Size 14 














4. In the Toolbox, click All Windows Forms, and then double-click Timer. 


Because a timer is a component, it has no visual representation at run time. It therefore does not appear with the controls 


on the User Control Designer, but rather in the component tray. 
5. In the component tray, click timer1 and set the Interval property to 1000, and the Enabled property to True. 


The Interval property controls the frequency with which the timer component ticks. Each time timer ticks, it runs the 
code in the timer1_Tick event. The interval represents the number of milliseconds between ticks. 


6. In the component tray, double-click timer1 to go to the timer1_Tick event for ctlClock. 


7. Modify the code so that it resembles the following: 


// Visual J# 
protected void timer1_Tick (Object sender, System.EventArgs e) 


{ 
lb1Display.set_Text(System.DateTime.get_Now().ToLongTimeString()); 


This code will cause the current time to be shown in IbIDisplay. Because the interval of timer1 was set to 1000, this 
event will fire every thousand milliseconds, thus updating the current time every second. 


By default, the timer1_Tick method added by double-clicking timer1 will have private scope. Notice in the previous 
code segment that you modified the scope to protected. 


8. From the File menu, choose Save All to save the project. 


Adding Custom Properties to Your User Control 


Your clock control now encapsulates a Label control and a Timer component, each with its own set of inherent properties. 
While the individual properties of these controls will not be accessible to subsequent users of your control, you can create and 
expose custom properties by writing the appropriate blocks of code. In the following section, you will add custom properties to 
your control that enable the user to change the color of the background and text. 


To add custom member to your user control 


1. In Solution Explorer, right-click ctlClock.jsl, and then click View Code from the shortcut menu. 
The Code Editor opens. 


2. Locate the public class ct1Clock statement. Beneath the opening {, type: 


// Visual J# 
private Color colFColor; 
private Color colBColor; 


These statements create the private variables that you will use to store the values for the custom properties you are 
about to create. 


3. Add the following code beneath the variable declarations from the previous step: 


// Visual J# 
/** @property */ 
public Color get_ClockBackColor() 
{ 
return colBColor; 
} 
/** @property */ 
public void set_ClockBackColor(Color value) 
{ 
colBColor = value; 
lb1Display.set_BackColor(colBColor) ; 
} 
/** @property */ 
public Color get_ClockForeColor() 


return colFColor; 
} 
/** @property */ 
public void set_ClockForeColor(Color value) 
{ 
colFColor = value; 
lb1Display.set_ForeColor(colFColor) ; 


The preceding code makes two custom properties, ClockForeColor and ClockBackColor, available to subsequent users 
of this control. The get_ and set_ statements provide for storage and retrieval of the custom properties’ values, as well as 
code to implement appropriate functionality. 


4. From the File menu, choose Save All to save the project. 


Testing Your Control 


Controls are not stand-alone applications; they must be hosted in a container. To test your control, you must provide a test 
project within which it runs. In this section, you will build your control and test it in a Windows Form. 


To build your control 


e On the Build menu, click Build Solution. 


To create a test project 


1 


2. 


On the File menu, point to Add and then click New Project to open the Add New Project window. 


Click Windows Application, and in the Name box, type Test. 


. In Solution Explorer, right-click the References node for the Test project. Click Add Reference to display the Add 


Reference dialog box. 


. Click the tab labeled Projects. Your user control project will be listed under Project Name. 


Double-click your project. This will add a new tab to the Toolbox called ctlClockLib Components. 


After you have added your reference, you can place your control in your form. 


To test your control 


1. 


With Form1 displayed in the Design view, click ctlClockLib Components, in the Toolbox, and then scroll down until the 
control icon representing ctlClock is displayed. 


. Double-click the ctlClock icon. 


A copy of your control is now added to your form. Note that it displays the current time and is updated each second. 


. Select the icon and move your mouse over your form. 


. Hold down the left mouse button while moving the mouse across the form. 


Another copy of your control is drawn onto the form. You can add as many copies of your timer to your form as you 
want. 


. In the designer, click one of the instances of ctlClock. 


The properties for this instance are displayed in the Properties window. 


. In the Properties window, locate the ClockBackColor property, and then select the property to display the color palette. 


. Select a color by clicking it. 


The background color of your control changes to the color you selected. 


. Use a similar sequence of events to verify that the ClockForeColor property is functioning as expected. 


. Press F5 to run your control in the UserControl TestContainer window. For more information on UserControl 


TestContainer, see How to: Test the Run-Time Behavior of a UserControl. 


10. To close the UserControl TestContainer, click Close. 


In this section, you have seen how components and Windows controls can be combined with code and packaging to provide 
custom functionality in the form of a user control. You have learned to expose properties in your user control, and how to test 
your control after it is complete. In the next section, you will learn how to construct an inherited user control using ctlClock as 
a base. 


Inheriting from a User Control 


In the previous section, you learned how to combine Windows controls, components, and code into reusable user controls. 
Your user control can now be used as a base upon which other controls can be built. The process of deriving a class from a 
base class is called inheritance. In this section, you will create a user control called ctlAlarmClock. This control will be derived 
from its parent control, ctlClock. You will learn to extend the functionality of ctlClock by overriding parent methods and 
adding new methods and properties. 


Creating the Inherited Control 


The first step in creating an inherited control is to derive it from its parent. This action creates a new control that has all of the 
properties, methods, and graphical characteristics of the parent control, but can also act as a base for the addition of new or 
modified functionality. 


To create the inherited control 


1. In Solution Explorer, click ctlClockLib. 
2. From the Project menu, select Add User Control. 
The Add New Item window opens with User Control selected. 
3. In the Name box, type ctlAlarmClock,jsl, and click Add. 
The Inheritance Picker window appears. 
4. Under Component Name, double-click ctlClock. 
5. In Solution Explorer, browse the current projects. Notice the file ctlAlarmClock.jsl that has been added to the project. 


Adding the Alarm Properties 


Properties are added to an inherited control in the same way they are added to a user control. You will now use the property 
declaration syntax to add two properties to your control: 


e AlarmTime, which will store the value of the date and time the alarm, is to go off. 


e AlarmSet, which will indicate whether or not the alarm is set. 


To add properties to your user control 


1. In Solution Explorer, right-click ctlAlarmClock and select View Code. 


2. Locate the public class statement. Note that your control inherits from ctlClockLib.ctlClock. Beneath the public 
class ctlAlarmClock extends ctlClockLib.ctlClock { statement, add the following code: 


// Visual J# 
private System.DateTime dteAlarmTime; 
private boolean blnAlarmSet; 
// These properties will be declared as public to allow future 
// developers to access them. 
/** @property*/ 
public System.DateTime get_AlarmTime() 
{ 
return dteAlarmTime; 
; 
/** @property*/ 
public void set_AlarmTime(System.DateTime value) 


{ 


dteAlarmTime = value; 
} 
/** @property*/ 
public boolean get _AlarmSet() 
{ 


return blnAlarmSet; 
} 
/** @property*/ 
public void set_AlarmSet(boolean value) 


{ 


blnAlarmSet = value; 








Adding to the Graphical Interface of Your Control 


Your inherited control has a visual interface that is identical to the control it inherits from. It possesses the same constituent 
controls as its parent control, but the properties of the constituent controls will not be available unless they were specifically 
exposed. You may add to the graphical interface of an inherited user control in the same manner as you would add to any user 
control. To continue adding to your alarm clock's visual interface, you will add a label control that will flash when the alarm is 
sounding. 


To add the label control 


1. In Solution Explorer, right-click ctlAlarmClock and select View Designer from the shortcut menu. 
The designer for ctlAlarmClock opens in the main window. 
2. Click the display portion of the control, and observe the Properties window. 


Notice that while all the properties are displayed, they are dimmed. This indicates that these properties are native to 
IbIDisplay, and cannot be modified or accessed in the Properties window. By default, controls contained in a user 
control are private, and their properties are not accessible by any means. 





4Tip 





If you want subsequent users of your control to have access to its internal controls, declare them as public or protecte 
d. This will allow you to set and modify properties of controls contained within your user control by using the appropri 
ate code. 











3. Add a Label control to your user control. 


4. Using the mouse, move the label control immediately beneath the display box. In the Properties window, set the 
following properties: 

















Property Setting 

Name IblIAlarm 

Text Alarm! 
TextAlign Middle Center 
Visible False 








Adding the Alarm Functionality 


In the previous sections, you added custom members and a control that will enable alarm functionality in your user control. In 
this section, you will add code to compare the current time to the alarm time and, if they are the same, to flash an alarm. By 
overriding the timer1_Tick method of ctlClock, you will extend the capability of ctlAlarmClock while retaining all of the 
inherent functionality of ctlClock. 


To override the timer1_Tick method of ctlClock 





1. In the Code Editor, locate the private boolean blnAlarmSet; statement. Immediately beneath it, add the following 
statement: 


// Visual J# 
private boolean blnColorTicker; 


2. Add following code just before the end of class declaration: 


// Visual J# 
protected void timer1_Tick(Object sender, System.EventArgs e) 


{ 
// Calls the timer1_Tick method of ctlClock. 
super.timer1_Tick(sender, e); 
// Checks to see if the alarm is set. 
if (blnAlarmSet == false) 
return; 
else 
// If the date, hour, and minute of the alarm time are the same as 
// now, cause the display to flash. 
{ 
if (dteAlarmTime.get_Date() == System.DateTime.get_Now().get_Date() && 
dteAlarmTime.get_Hour() == System.DateTime.get_Now().get_Hour() && 
dteAlarmTime.get_Minute() == System.DateTime.get_Now().get_Minute()) 
{ 
// Makes 1blAlarm visible, and changes the backcolor based 
// on the value of blnColorTicker. The backcolor of the 
// label will flash once per tick of the clock. 
lblAlarm.set_Visible(true) ; 
if (blnColorTicker == false) 
if 
lblAlarm.set_BackColor( Color.get_Red()); 
blnColorTicker = true; 
} 
else 
{ 
lblAlarm.set_BackColor(Color.get_Blue()); 
blnColorTicker = false; 
} 
} 
else 
{ 
// Once the alarm has sounded for a minute, the label is 
// made invisible again. 
lblAlarm.set_Visible(false); 
} 
} 
hi 


The addition of this code accomplishes several tasks. It directs the control to use this method in place of the method that was 
inherited from the base control. When this method is called, it invokes the super.timerl_Tick statement, ensuring that all of 
the functionality incorporated in the original control is reproduced in this control. It then runs additional code to incorporate 
the alarm functionality. A flashing label control will appear when the alarm is triggered. 


Your alarm clock control is almost complete. The only thing that remains is to implement a way to turn it off. To do this, we will 
add a button and add code to the btnAlarmOff_Click method. 


To implement the shutoff method 


1. In Solution Explorer, right-click ctlAlarmClockjsl and click View Designer. 


The designer opens. 


2. Add a button to the control. Set the properties of the button as follows: 











Property Value 
Name btnAlarmOff 
Text Disable Alarm 











3. In the designer, double-click Disable Alarm. 
The Code Editor opens to the private void btnAlarmOff_Click line. 
4. Modify this method so that it resembles the following: 


// Visual J# 
private void btnAlarmOff_Click (Object sender, System.EventArgs e) 


{ 
// Turns off the alarm. 
blnAlarmSet = false; 
// Hides the flashing label 
lblAlarm.set_Visible(false) ; 
} 


5. From the File menu, choose Save All to save the project. 
Testing Your Inherited Control 


As with a standard user control, an inherited user control cannot stand alone and must be hosted in a form or other container. 
Because ctlAlarmClock has a greater depth of functionality, additional code is required to test it. In this section, you will write 
a simple program to test the functionality of ctlAlarmClock. You will write code to set and display the AlarmTime property of 
ctlAlarmClock, and will test its inherent functions. 


To build and add your control to a test form 


1. In Solution Explorer, click ctlClockLib. On the Build menu, select Build ctlClockLib. 
2. Add a new Windows Application project to the solution, and name it Test2. 


3. In Solution Explorer, right-click the References node for your test project. Click Add Reference to display the Add 
Reference window. Click the tab labeled Projects. The ctlClockLib name will be listed under Project Name. Double- 
click it, and note that it now appears in the ctlClockLib Components window. This will add a reference to ctlClockLib. 


4. In the Toolbox, click ctlClockLib Components. 
5. Scroll down until the icon for ctlAlarmClock comes into view. 
6. Double-click ctlAlarmClock to add a copy of ctlAlarmClock to your form. 


7. In the Toolbox, locate and double-click DateTimePicker to add a DateTimePicker control to your form, and add a 
Label control by double-clicking Label. 


8. Use the mouse to position the controls in a convenient place on the form. 


9. Set the properties of these controls as follows: 











Control Property Value 
label1 Text (leave blank) 
Name IbITest 





dateTimePicker1 Name dtpTest 























Format Time 

















10. In the designer, double-click DateTimePicker. 
The Code Editor opens to private void dtpTest_ValueChanged. 


11. Modify the code so that it resembles the following: 


// Visual J# 
private void dtpTest_ValueChanged (Object sender, System.EventArgs e) 


{ 
ctlAlarmClock1.set_AlarmTime(dtpTest.get_Value()); 
ctlAlarmClock1.set_AlarmSet(true) ; 
lblTest.set_Text("Alarm Time is " + ctlAlarmClock1.get_AlarmTime().ToShortTimeStri 
ng())3 
} 





12. In Solution Explorer, right-click Test2 and choose Set as Startup Project from the shortcut menu. 
13. From the Debug menu, choose Start. 


The test program starts. Note that the current time is updated in the ctlAlarmClock control, and that the starting time is 
shown in the DateTimePicker control. 


14. Click the DateTimePicker where the minutes of the hour are displayed. 

15. Using the keyboard, set a value for minutes that is one minute greater than the current time shown by ctlAlarmClock. 
The time for the alarm setting is shown in IbITest. 

16. Wait for the displayed time to reach the alarm setting time. 


When the displayed time reaches the time to which the alarm is set, the IbIAlarm will flash. Turn off the alarm by clicking 
the Disable Alarm button. You can now reset the alarm. 


This walkthrough has covered a number of key concepts. You have learned to create a user control by combining controls and 
components into a user control container. You have learned to add properties to your control, and to write code to implement 
custom functionality. In the second section, you learned to extend the functionality of a given user control through inheritance, 
and to alter the functionality of host methods by overriding those methods. 


See Also 
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Visual J# Concepts 


Walkthrough: Inheriting from a Windows Forms Control with 
Visual J# 


Visual J# provides you with the ability to create powerful custom controls through inheritance. Through inheritance, you are 
able to create controls that retain all of the inherent functionality of standard Windows Forms controls but also incorporate 
custom functionality. In this walkthrough, you create a simple inherited control called ValueButton. This button inherits 
functionality from the standard Windows Forms button, and will expose a custom member called ButtonValue. 


The dialog boxes and menu commands you see might differ from those described in Help depending on your active settings 


or edition. To change your settings, choose Import and Export Settings on the Tools menu. For more information, see 
Visual Studio Settings. 





Creating the Project 


When you create a new project, you specify its name in order to set the root package, assembly name, and project name, and 
to ensure that the default component will be in the correct package. 


To create the ValueButtonLib control library and the ValueButton control 


1. On the File menu, point to New, and then click Project to open the New Project dialog box. 


2. Select the Windows Control Library project template from the list of Visual J# Projects, and in the Name box, type 
ValueButtonLib. 


3. Click OK. 


The project name, ValueButtonLib, is also assigned to the root package by default. The root package is used to qualify 
the names of components in the assembly. For example, if two assemblies provide components named ValueButton, you 
can specify your ValueButton component using ValueButtonLib.ValueButton. 


4. In Solution Explorer, right-click UserControl1,jsl, then on the shortcut menu, click Rename. Change the file name to 
ValueButton jsl. 


5. In Solution Explorer, right-click ValueButton.jsl, and select View Code. 


6. Locate the class statement, public class ValueButton, and change the type from which this control inherits from 
System.Windows.Forms.UserControl to System.Windows.Forms.Button. This allows your inherited control to inherit all 
the functionality of the Button control. 


7. Expand Component Designer generated code, locate the InitializeComponent method, and remove the line that 
assigns the AutoScaleMode property: 


this.set_AutoScaleMode(System.Windows.Forms.AutoScaleMode. Font) ; 


This property does not exist in the Button control. 


8. On the File menu, click Save All to save the project. 


A visual designer is no longer available. Because the Button control does its own painting, you cannot modify its 
appearance in the designer. Its visual representation will be exactly the same as that of the class it inherits from, Button, 
unless modified in the code. 





Adding a Member to Your Inherited Control 


One possible use of inherited Windows Forms controls is the creation of controls that are identical to standard Windows 
Forms controls, but expose custom properties. In this section, you add a member called ButtonValue to your control. 


To add the ButtonValue member 


1. 


2. 


3. 


In Solution Explorer, right-click ValueButton.jsl, and then on the shortcut menu, click View Code. 


Locate the class statement. Immediately after the brace ({), add the following code: 


// Visual J# 

// Creates the private variable that will store the value of your 
// member. 

private int varValue; 

// Declares the methods to access or modify the member. 

/** @property */ 

public int get_ButtonValue() 

{ 


return varValue; 


} 
/** @property */ 
public void set_ButtonValue(int value) 


{ 


varValue = value; 


This code sets the methods by which the ButtonValue member is stored and retrieved. The get_ statement sets the value 
returned to the value that is stored in the private variable varValue, and the set_ statement sets the value of the private 
variable by use of the value keyword. 


On the File menu, click Save All to save the project. 


Testing Your Control 


Controls are not stand-alone projects; they must be hosted in a container. To test your control, you must provide a test project 
for it to run in. You must also make your control accessible to the test project by building it. In this section, you will build your 
control and test it in a Windows Form. 


To build your control 


e On the Build menu, click Build Solution. 


To create a test project 


1 


2. 


5. 
6. 


On the File menu, point to Add Project, and then click New Project to open the Add New Project dialog box. 


Select the Visual J# Projects node, and click Windows Application. 


. In the Name box, type Test, and click OK. 


. In Solution Explorer, right-click the References node for your test project, and then on the shortcut menu, click Add 


Reference to display the Add Reference dialog box. 
Click the Projects tab. 


Double-click the ValueButtonLib project to add the reference to the test project. 


To add your control to the form 


1. 


2. 


3. 


In Solution Explorer, right-click Form1.jsl, and on the shortcut menu, click View Designer. 
In the Toolbox, double-click the ValueButton icon. 

An instance of ValueButton is displayed on the form. 

Right-click ValueButton, and on the shortcut menu, click Properties. 


You can examine the properties of this control in the Properties window. Note that they are identical to the properties 
exposed by a standard button. 


4. Set the ButtonValue property to 5. 
5. On the Common Controls tab of the Toolbox, double-click Label to add a Label control to your form. 
6. Move the label to the center of the form. 
7. Double-click valueButton1. 
The Code Editor opens to the valueButton1_Click event. 


8. Add the following line of code: 





// Visual J# 
label1.set_Text("" + valueButton1.get_ButtonValue()); 


9. In Solution Explorer, right-click Test, and on the shortcut menu, click Set as Startup Project. 
10. On the Debug menu, click Start Debugging. 
Form1 is displayed. 
11. Click valueButton1. 


The number '5' is displayed in Label1, demonstrating that the ButtonValue member of your inherited control has been 
passed to Label1 by means of the valueButton1_Click method. Thus, your ValueButton control inherits all the 
functionality of the standard Windows Forms button but exposes an additional, custom member. 
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Visual J# Reference 


This section links you to reference information on various aspects of Visual J# programming. 


In This Section 
Language Support 


Provides reference information on Visual J++® 6.0 and .NET Framework features that are and are not supported in Visual J#. 
Class Library Support 
Lists the packages supported and not supported, as well as implementation-specific details for the class library support. 
Security Semantics for Applications Written in Visual J# 
Discusses the security considerations for Visual J# applications. 
Visual J# Upgrading Reference 
Provides reference information on issues in upgrading projects from Visual J++ 6.0 to Visual J#. 
J# Keywords 
Provides links to topics on the language keywords you can use in your Visual J# programs. 
J# Operators 
Provides links to topics on the operators you can use in your Visual J# programs. 
Visual J# Compiler 
References the Visual J# compiler options. Includes information on building from the command line. 
Visual J# Class Library 


Provides an introduction to the J# Class Library, which is Microsoft's implementation of a subset of the JDK 1.1.4 
specification. 


Related Sections 
Visual J# 


Provides links to various areas of the Visual J# documentation set. 


Visual J# Reference 


Language Support 


The Visual J# compiler provides support for Microsoft® Visual J++® 6.0 extensions, including delegates, J/Direct®, the @com 
attribute support for Java-language/COM interop functionality, conditional compilation, and most of the other attributes, such 
as @security and @hidden. Visual J# also provides support for using the .NET Framework class libraries and user-defined 
class libraries written in other INET Framework-compliant languages such as Visual C# and Visual Basic. 


In This Section 
Support for Visual J++ 6.0 


Lists Microsoft extensions in Visual J++ 6.0 that are fully supported in Visual J#. 
Support for Consuming .NET Framework Classes 


Provides a short sample to demonstrate how Visual J# can use .NET Framework classes that conform to the common 
language specification (CLS). 


Syntax for Targeting the .NET Framework 

Provides links to topics that show the syntax for using features of the .NET Framework common language runtime. 
Unsupported .NET Framework Features 

Lists features of the .NET Framework common language runtime that are not supported in Visual J#. 
Walkthrough: Generating and Compiling Source Code Dynamically in the Java Language 

Describes the CodeDOM implementation for the Java language that Visual J# provides. 
Documentation Comments in Visual J# 

Describes features in the integrated development environment that provide support for documentation comments. 
Visual J# Exception Hierarchies 


Describes the relationship between Java-language exceptions and .NET Framework exceptions. 


Related Sections 
Visual J# Reference 


Reference topics on the Visual J# compiler, the Binary Converter Tool Jblmp.exe), language and library support, upgrading 
from Visual J++ 6.0 projects, Visual J# syntax for the NET Framework class library, and development-environment features. 


Class Library Support 


Lists the packages supported and not supported, as well as implementation-specific details for the class library support. 
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Support for Visual J++ 6.0 


The Microsoft extensions in Visual J++ 6.0 that are listed in this topic are fully supported in Visual J#. 


To locate reference information for the extensions, see the Visual J++ 6.0 documentation or the Microsoft SDK for Java in the 
MSDN online library 


(http://msdn.microsoft.com/library/default.asp?url=/library/en-us/vjcore98/html/vjovrdocumentationmap.asp). 
e J/Direct (for making calls into native DLLs): 
e @dil.import 
e @dil.struct 
e @dlil.structmap 
e Java-language/COM, for example: 
© @com.class 
e @com.interface 
e @com.method 
e @com.parameter 
e @com.register 
e Conditional compilation: 
e #if, #elif, #endif, #define 
e #warning, #error 
e @conditional 


Used to mark methods whose calls can be conditionally removed from the generated code. 


The @conditional feature works only if the attributed function and the caller are part of the same compilation 


unit. The recommended technique for using conditional compilation with Visual J# is to use the INET Framewor 
k class ConditionalAttribute. 





e Delegate and multicast delegate support: 
e com.ms.lang.Delegate and com.ms.lang.MulticastDelegate classes 
e delegate and multicast keywords 
e Other @ directives: 
e @security 
e @hidden 


e @deprecated 


The Visual J# compiler does not provide the following features that are specific to Java-language bytecodes in the Visual J++ 
6.0 compiler: 


e Ability to import class information from Java-language bytecodes (.class files). 
e Ability to generate .class files from Java-language sources. 


e Support for CLASSPATH for resolving referenced classes at compile time; use the /reference (Import Metadata) compiler 
option instead. 


See Also 


Other Resources 
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Support for Consuming .NET Framework Classes 


The Visual J# compiler supports the use of any .NET Framework library API that conforms to the common language 
specification (CLS). A sample "Hello, World!" program that uses .NET Framework classes is shown below. 


Example 


// vwjc_consume_netfx.jsl 

// Contains the Console class. 
import System.*; 

public class Hello 


{ 
public static void main(String[] args) 
{ 
Console.WriteLine("Hello, World!"); 
} 
} 
Output 


Hello, World! 


See Also 
Other Resources 
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Syntax for Targeting the .NET Framework 


This section describes features in the Visual J# compiler that are used to target the .NET Framework. These features are 
available by default. However, you can use the /x (Disable Language Extensions) compiler option to disable these features. 


This section assumes you are familiar with the .NET Framework, the common type system, value types, reference types, and 
boxing and unboxing. 


This section discusses the following subjects: 
e@ Object Hierarchy Semantics 
e Language Extensions to Support the .NET Framework 
e Rectangular Arrays 
e New Preprocessing Directives 
e Attaching Attributes 
e Authoring Custom Attributes 
e Using Keywords as Identifiers 
® Calling Methods That Take Arguments by Reference 
© Defining Methods That Take Arguments By Reference 
e Defining and Using Properties 
e@ Bean-Style Properties 
e Defining and Using Events 
© Defining and Using .NET Framework Delegates 
e Using Value Types 
e Using Value Types Corresponding to Primitive Types 
e User-Defined Value Types 
e Using Enumerations 
e User-Defined Enumeration Types 
e Property and Event Exposure 
@ Calling Native Methods 
e Type Conversion Operations 
e Support for .NET Serialization 
@ Common Language Specification Compliance Checking 
e Generics in J# 


See Also 
Other Resources 
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Object Hierarchy Semantics 


In Visual J#, java.lang.Object is treated as a language-specific root of the object hierarchy. Access this object from languages 
supported by the common language runtime by means of Object. Thus, such languages do not see Visual J# objects as special 
objects deriving from java.lang.Object. 


For example, this is a class written in Visual J#, and you cannot access the object method toString in other languages: 


| 
class A extends java.lang.Object { 


public String toString() { return "Instance of A";} 
} 


Instead, use the following to get the string representation of the object from Visual C#: 





string str = new A().ToString(); 





Note 





This is true even if A were to override an implementation of the toString method. 











To a Java-language developer, Visual J# treats Object like java.lang.Object and maps the functionality to make any 
differences transparent. This support makes it possible to pass java.lang.Object to Object and vice-versa for assignments, 
parameter passing, and other usages. The same is true for java.lang.String and Object. 


Consuming Visual J# binaries is no different from consuming any other binary generated by such languages as Visual Basic or 
Visual C#. 


See Also 
Other Resources 
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Language Extensions to Support the .NET Framework 


The following new features support use of the .NET Framework: 
e New Preprocessing Directives 
e Attaching Attributes 
e Using Keywords as Identifiers 


@ Calling Methods That Take Arguments by Reference 


See Also 
Reference 
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Rectangular Arrays 


In addition to jagged arrays, Visual J# also supports rectangular arrays. The element type and shape of an array — including 
the number of dimensions it has — are part of its type. However, the size of the array, as represented by the length of each of 
its dimensions, is not part of an array's type. 


This split is made clear in the Visual J# language syntax, as the length of each dimension is specified in the array creation 
expression rather than in the array type. For instance, the declaration int[,,] arr = new int[1, 1, 2]; is an array type of 
int[,,] and an array creation expression of new int[1, 1, 2]. 


It is also possible to mix rectangular and jagged arrays. For example, int [,][] mixedArr = new int[,][] {{{1,2}}, 
{{2,3,4}}}; is a mixed two-dimensional rectangular array of jagged arrays. The array is a rectangular array of dimensions 
[2,1], each element of which is a single dimensional integer array. The length of the array at mixedArr[0, 0] is 2, and the 
length of the array at mixedArr[1, 0] is 3. 


Example 


The following samples show how rectangular arrays can be created in Visual J#. 


// wjc_rect_array.jsl 
public class MyClass 
{ 


public static void main(String [] args) 

{ 
// 2-D rectangular array; explicit creation. 
int[,] arr = new int[2, 2]; 
arr[@, @] ; 
arr[@, 1] = 
arr[1, @] = 
arr[1, 1] 


I 


I 


BWNR 
EO NerOr 


a 


// 2-D rectangular array; 
// Explicit creation with initializer list. 
int[,] arr2 = new int[,] {{1, 2}, {3, 4}}; 


// 2-D rectangular array; 
// Shorthand: creation with initializer list. 


int[,] arr3 = {{1, 2}, {3, 4}}; 


// 3-D rectangular array; explicit creation. 
int[,,] arr4 = new int[1, 1, 2]; 

arr4[@, @, @] = 1; 

arr4[@, @, 1] = 2; 


// 3-D rectangular array; 
// Explicit creation with initializer list. 
int[,,] arrS = new int [,,] 


{{{1,2,3},{1,2,3}},{{1,2,3},{1,2,3}}};3 


// Mix rectangle & jagged arrays; explicit creation using 
// new. Creates the same array as the above example. 


int [,][] mixedArr = new int[,][] {{{1,2}}, {{2,3,4}}}; 


// Mixed array dynamic creation 

int [,][] mixedArr2 = new int[2,1][]; 
mixedArr2[@,@] = new int[]{1,2}; 
mixedArr2[1,0] new int[]{2,3,4}; 


See Also 
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Visual J# Preprocessing Directives 


The following preprocessing directives are available: 
#endregion (Visual J#) 

Marks the end of a #region block. 
#line (Visual J#) 

Lets you modify the line numbers in the compiler output for errors and warnings. 
#pragma checksum (Visual J#) 

Applies a checksum computation to insure that the assembly or ASPX file has not changed. 
#region (Visual J#) 


Lets you specify a block of code that you can expand or collapse when using the outlining feature of the Visual Studio Code 
Editor. 


See Also 
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#endregion (Visual J#) 


#endregion marks the end of a #region block. 





#endregion 


Remarks 
See #region (Visual J#) for a discussion and example of how to use #endregion. 


See Also 
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#line (Visual J#) 


The #line directive lets you modify the line numbers and, optionally, the file name in the compiler output for errors and 
warnings. 


#line [ number ["file_name"] | hidden | default ] 


Parameters 
Number 


The number you want to specify for the following line in a source code file. 
file_name(optional) 


The file name you want to appear in the compiler output. By default, the actual name of the source code file is used. The file 
name must be in double quotation marks ('"). You must use the delimiter character '\' for delimiting an actual '\' character 
when specifying a file path as is done for string literals. 


hidden 
Hides the successive lines from the debugger until another #line directive is encountered. 
default 
Resets the line numbering in a file. 
Remarks 
The #line default directive sets the line number back to the original source line numbering. 


The #line hidden directive hides the successive lines from the debugger. When you step through the code, any lines between 
a #line hidden and the next #line directive, assuming that it is not another #line hidden directive, are stepped over. This 
option can also be used to allow ASP.NET to differentiate between user-defined and machine-generated code. Although 
ASP.NET is the primary consumer of this feature, other source generators can use it. 


A #line hidden directive does not affect file names or line numbers in error reporting. If the compiler encounters an error ina 
hidden block, it reports the current file name and line number of the error. 


A source code file can have any number of #line directives. 


The #line directive might be used by an automated, intermediate step in the build process. For example, if the intermediate 
step removed lines from the original source code file, but if you still wanted the compiler to generate output based on the 
original line numbering in the file, you could remove lines and then simulate the original line numbering with #line. 


A source code file can have any number of #line directives. 
Example 


// preprocessor_line.jsl 
// compile with: /W:3 
public class MyClass2 


{ 
public static void main(String [] args) 
if 
#line 200 
int i; // V'3JS1493 on line 200 
#line 8 "c:\\hashline\\another_file.js1" 
char c; // VIS1493 on line 8 of c:\hashline\another_file.jsl 
#line default 
int r; // VJS1493 on the original source line and file. 
} 
} 
See Also 
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#pragma checksum (Visual J#) 


Applies a checksum computation between generated source files and ASPX files. 


#pragma checksum "filename" "{guid}" "checksum_bytes" 


Parameters 
"filename" 


The name of the file that requires monitoring for changes or updates. 
“{guid}" 

The globally unique identifier (GUID) for the file. 
"checksum_bytes" 


The string of hexadecimal digits representing the bytes of the checksum. Must be an even number of hexadecimal digits. An 
odd number of digits results in a compile-time warning, and the directive is then ignored. 


Exceptions 


If the #pragma checksum directive contains improper syntax, such as missing values, the compiler displays a warning and 
ignores the directive. 


Remarks 


The Visual Studio debugger uses checksum to ensure that it always finds the right source. The compiler computes the 
checksum for a source file, and then emits the output to the PDB. The debugger then uses the PDB to compare against the 
checksum that it computes for the source file. 


This solution does not work for ASP.NET projects because the computed checksum is for the generated source file, rather than 
the ASPX file. To address this problem, #pragma checksum provides checksum support for ASP.NET pages. 


When you create an ASP.NET project in Visual J#, the generated source file contains a checksum for the ASPX file, from which 
the source is generated. The compiler then writes this information into a PDB file. 


If the compiler encounters no #pragma checksum directive in the file, it computes the checksum and writes the value to the 
PDB file. 


Description 


When you generate an ASP.NET project, the general source file contains the following directive at the beginning of the file. 


#pragma checksum "MyFileName" "{XXXXXXXX-XXXX-XXXX-XXXX -XXXXXXXXXXXX}"_ "XXXK.. 


See Also 
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#region (Visual J#) 


Enables you to specify a block of code that you can expand or collapse when using the outlining feature of the Visual Studio 
Code Editor. 


#region name 


Parameters 
name 


The name you want to give to the region, which will appear in the Visual Studio Code Editor. 
Remarks 
A #region block must be terminated with a #endregion (Visual J#) directive. 


A #region block cannot overlap a #if block. However, a #region block can be nested in a #if block, and a #if block can be 
nested in a #region block. 


The Visual J# compiler treats a line starting with #region or #endregion as a comment, so these directives are ignored in 
command-line builds. 


Example 


// preprocessor_region.jsl 

#region MyClass definition 

public class MyClass 

{ 
public static void main(String [] args) 
{ 
} 

} 


#endregion 


See Also 
Reference 
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Attaching Attributes 


Visual J# allows you to attach attributes to classes, fields, methods, parameters, and other programming elements. Both 
custom attributes and pseudo attributes (attributes that you cannot query for via Reflection) can be attached to the metadata. 
Visual J# follows the Visual J++ extension syntax to allow attaching attributes to the metadata. 


To attach an attribute, use the @attribute directive followed by the name of the attribute that is to be attached. If an attribute 
parameter accepts any type object, you must pass the underlying class object as the argument instead of casting it to a type 
Object. 


Attributes are attached to return types using the @attribute.return directive, and can be targeted for the underlying method 
using the @attribute.method directive. 


It is an error to attach these directives for programming elements other than those specified. For all other attributes, the 
compiler determines the target by the member following the directive. 


Example 


The following example shows how to use @attribute: 


// vjc_attributes1.jsl 
// compile with: /target:library 
import System.*; 
import System.Runtime.InteropServices. *; 
public class MyClass 
1 
/** @attribute DllImport("user32", CharSet=CharSet.Ansi) */ 
public static native int MessageBox( 
int hwnd, 
/** @attribute MarshalAs(UnmanagedType.AnsiBStr) */ 
System.String title, 
System.String caption, 
int type); 


The following example shows how to use @attribute.return to specify marshaling attributes on a return type. 


// vjc_attributes2.jsl 

// compile with: /target:library 

import System.Runtime.InteropServices.*; 
public class MyClass 


{ 
/** @attribute.return MarshalAs(UnmanagedType.LPArray, SizeConst=10) */ 
int[] getBytes() 
{ 
int arr[] = {1,2}; 
return arr; 
} 
} 


The following example shows how to use @attribute.method to specify marshaling attributes on a return type. 


// vjc_attributes3.jsl 
// compile with: /target:library 
import System.*; 
public class MyClass 
{ 
/** @property */ 
/** @attribute.method Obsolete("get Bytes is deprecated", false) */ 
// The directive ensures that the attribute is attached to the method. 
int[] get_Bytes() 
{ 
int arr[] = {1,2}; 
return arr; 


The following example shows how to use .class syntax to get a Type when used inside an attribute declaration. 


/** @attribute System.Xml.Serialization.XmlArrayItem(Simple.class)) */ 








You cannot define an attribute in your Visual J# program; you can only consume attributes from the .NET Framework or other 
referenced assemblies. 


Assembly level attributes are attached using the @assembly directive instead of the @attribute directive. The @assembly 
directive must be at the beginning of the file following the package and import statements, if any. 





import System.Reflection.*; 
/** @assembly AssemblyTitle("My Assembly") */ 
/** @assembly AssemblyCompany("My Company") */ 





Attributes Grammar 


The grammar for attributes is as follows: 


Term Definition 
‘Attributes attribute-sections 
attribute-sections attribute-section 


attribute-sections attribute-section 





attribute-section /** attribute-list */ 





attribute-list newlineopt attribute newlineopt 


attribute-list newline attribute 


Attribute attribute-target-specifier attribute-name attribute-arguments 
attribute-target-specifier @attribute 
@assembly 


@attribute.return 


@attribute.method 





attribute-name type-name 





attribute-arguments ( positional-argument-listopt ) 
( positional-argument-list , named-argument-list ) 


( named-argument-list ) 


positional-argument-list positional-argument 


positional-argument-list , positional-argument 





positional-argument attribute-argument-expression 





named-argument-list named-argument 


named-argument-list , named-argument 











named-argument attribute-sections 








attribute-argument-expression attribute-section 





attribute-sections attribute-section 





Rules for Attaching Attributes 


Attributes can be attached to classes, fields, methods, or method parameters. 
Attributes must start at the beginning of a line. 


An asterisk (*) is treated as a white space in the list following the start of the comment. Similarly, a new-line character (\n) 
is also white space between the keywords or arguments. 


Commas separate arguments. 


The type name following the @attribute-target-specifier must resolve to an attribute type in the current context. You can 
either give a fully qualified class name or just a simple class name in which case the import information is used to resolve 
the type. Similarly the identifier in the named argument must correspond to a property or field in the attribute type. 


By convention, attribute classes are named with a suffix of Attribute. An attribute-name of the form type-name may 
either include or omit this suffix. 


/** @attribute STAThreadAttribute() */ // refers to STAThreadAttribute 
public static void main(String [] args) {} 

// The Attribute suffix is optional 

/** @attribute STAThread() */ // Also refers to STAThreadAttribute 
public static void main(String [] args) {} 











If a parameter to an attribute is a Type object then you should pass the underlying class object as an argument. 


See Also 
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Authoring Custom Attributes 


Visual J# provides the ability to author custom .NET Framework Attributes. This is done by extending the .NET Framework 
Attribute class. For more information, see Attaching Attributes. 


The declaration of a custom attribute is similar to the declaration of a class; however, the following rules apply: 
e Custom attributes must explicitly extend Attribute. 
e Custom attributes must use the predefined attribute AttributeUsageAttribute to define the characteristics of the attribute. 
e Named fields and properties in the attribute class must be public. 
e Custom attributes may not be inner classes. 
e Custom attributes may not be anonymous classes. 


e By convention, custom attribute classes should have names ending with "Attribute." When attaching the attribute, users 
of the attribute may omit the "Attribute" suffix. 


Using the AttributeUsageAttribute 


The AttributeUsageAttribute is used as follows: 





/** @attribute System.AttributeUsage( 
AttributeTargets.All, 

Inherited = false, 

AllowMultiple = true 

ae 











The first argument is the AttributeTargets enumeration which specifies which contexts the attribute is valid when used with. 
The following possible values are allowed. The bitwise OR operator may be used to specify a combination of targets. 
































Member Name Where the Attribute Can Be Attached 
All All program elements 
Assembly Assembly 

Class Class 

Constructor Constructor 

Delegate Delegate 

Enum Enum 

Event Event 

Field Field 

Interface Interface 

Method Method 

Module Module 

Parameter Parameter 











Property Property 





Return Return Value 


Struct User Defined Value Type 











The second argument, Inherited, determines whether the attribute, if attached to a class, is inherited by classes extending the 
class to which it is applied. 


The third argument, AllowMultiple, determines whether more than one instance of the attribute may be attached to the same 
entity. For more information, see Attaching Attributes. 


Attribute classes have constructors, the arguments for which are supplied when the attribute is attached to a target. There area 
few restrictions. Arrays that are 2D or greater may not be used in attribute constructor parameters; the parameters must be 
CLS-Compliant types. When attributes are used, the arguments must be constants. 


Named Fields and Properties 


Positional parameters are arguments for the attribute constructor. They are mandatory and must be specified every time an 
attribute is used. Named parameters are not defined on the attribute constructor; rather they are public fields or properties. 
Named parameters give the client the ability to set an attributes fields and properties when the attribute is instantiated. Each 
public CTOR can define a sequence of positional parameters (just as any type of class). However, in the case of attributes, once 
the positional parameters have been stated, the user can reference fields or properties with the following syntax: 


FieldOrPropertyName=value 


Remarks 
Fields and properties that may be set in this manner must be public. 
Disabling Attribute Authoring 


Attribute authoring is disabled when the /x:net option is used. 


Example ——________c_t__t_t________—__ 


// CustomAttribute.jsl 
import System.*; 
import System.Diagnostics.*; 


/** @attribute AttributeUsage(AttributeTargets.All, 
Inherited = false, 
AllowMultiple = false) */ 
public class OwnerAttribute extends System.Attribute 
‘ 
private String m_owner; 
private String m_phone; 


public OwnerAttribute() 


{ 
m_owner = ""; 
m_phone = ""; 
} 
public OwnerAttribute(String owner, String phone) 
sf 
m_owner = owner; 
m_phone = phone; 
} 


/** @property */ 

public String get_Owner() 
1 

} 


/** @property */ 


return m_owner; 








public String get_Phone() 
{ 


} 


return m_phone; 


} 


/** @attribute Owner("JohnS", "555-3890") */ 
public class C1 


Lc 


/** @attribute Owner("EmilyK", "555-2121") */ 
public class C2 extends C1 





i 
class CMain 
{ 
public static void main() 
{ 
C1 c1 = new C1(); 
C2 c2 = new C2(); 
OwnerAttribute oa = new OwnerAttribute(); 
// GetCustomAttribute may be used to get attributes attached to a 
// type. The function takes two arguments of System.Type 
// representing the class type and the attribute type. 
oa = (OwnerAttribute) Attribute.GetCustomAttribute(c1.GetType(), 
oa.GetType()); 
Console.WriteLine("C1 Owner: {0} Phone: {1}", oa.get_Owner(), 
oa.get_Phone()); 
oa = (OwnerAttribute) Attribute.GetCustomAttribute(c2.GetType(), 
oa.GetType()); 
Console.WriteLine("C2 Owner: {@} Phone: {1}", oa.get_Owner(), 
oa.get_Phone()); 
} 
} 
Output 


Cl Owner: JohnS Phone: 555-3890 
C2 Owner: EmilyK Phone: 555-2121 
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Using Keywords as Identifiers 


Visual J# allows @keyword to be treated as an identifier to allow the consumption of identifiers in referenced assemblies that 
are keywords reserved by Visual J#. 


Example 


// vwjc_identifier_1.cs 

// compile with: /target:library 
// C# program 

public class MyClass1 

{ 


} 

// vjc_identifier_2.jsl 

// compile with: /reference:vjc_identifier_1.d1l 
public class MyClass2 


public static int synchronized = @; // valid in C# 


{ 
public static void main(String [] args) 
{ 
MyClass1 x = new MyClass1(); 
// System.Console.WriteLine(x.synchronized) ; // error 
System.Console.WriteLine(x.@synchronized) ; // OK 
} 
} 
Output 
0 
See Also 
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Calling Methods That Take Arguments By Reference 


The .NET Framework has support for passing parameters by reference. In this case, the parameter can be modified inside the 
function and these changes are visible to the caller. Visual J# follows the C++ style where you can directly call the method and 
pass the parameter, and the Visual J# compiler does the conversion implicitly. 


Example 


// vjc_args_by_ref_1.cs 

// compile with: /target:library 
// A C# program used as a DLL 
public class MyClass1 


public void Test(ref string str) 
{ 


} 


str += " World!"; 


You can call this method in the Java language as follows: 


// vjc_args_by_ref_2.jsl 
// compile with: /reference:vjc_args_ by_ref_1.dl1l 
public class MyClass2 


public static void main(String [] args) 


{ 
MyClass1 x = new MyClass1(); 
System.String mystr = "Hello"; 
System.Console.WriteLine(mystr) ; 
x.Test(mystr) ; 
System.Console.WriteLine(mystr) ; 
} 
i 
Output 
Hello 


Hello World! 


See Also 
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Definition of Methods That Take Arguments By Reference 


Arguments to functions are normally passed by value. For value types, a function creates and operates on copy of the object 
passed in, so the value of the original object is unchanged by the function. For reference types, the function operates directly 
on the referenced object, so the referenced object can be modified. However, when passed by value, the reference itself cannot 
be changed. 


Passing value types by reference means that functions operate directly on the object passed in, so any changes within the 
function affect the original object. Passing reference types by reference means that the reference can be changed by the 
function to refer to another object or null. 


In a function declaration, it is possible to declare that parameters are to be passed by reference by using the /** @ref */ tag 

applied to the parameter. The tag must be ahead of any other modifiers applied to the parameter, as in the following example: 
void f(/** @ref */ int i ); 

The /** @ref */ tag can be applied to primitive types, arrays, user-defined value types, enum types, and other reference types. 

It is an error to tag the arguments when calling the method. 


It is an error to declare to overloaded methods that differ only in whether a parameter is passed by reference or not. At the 
point of the call, there would be no way to distinguish the two. 


The /** @ref */ tag cannot be used with the /x:net option. 
Example 


// ByRef.jsl 
import System.*; 


public class C 








{ 
public static final int MAX = 10; 
public static void Increment(/** @ref */ int i) 
{ 
i++; 
} 
public static void main() 
{ 
for (int i = @; i <= MAX; C.Increment(i) ) 
{ 
Console.WriteLine("Value: " + i); 
} 
} 
} 
Output 
Value: 0 
Value: 1 
Value: 2 
Value: 3 
Value: 4 
Value: 5 
Value: 6 
Value: 7 
Value: 8 
Value: 9 
Value: 10 
See Also 
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Defining and Using Properties 


Visual J# allows you to access properties defined in NET Framework classes. Visual J# translates properties in .NET Framework 
classes to the accessor methods: get_ and set_. Visual J# developers simply call the accessor methods directly. Visual J# does 
not attach any special importance to property accessors. They are treated as methods of the class. 


Example 


// “jc_properties.jsl 

// compile with: /reference:System.Windows.Forms.d11 
import System.Windows.Forms.*; 

public class MyClass 


{ 
public static void main(String [] args) 
af 
Button b = new Button(); 
String str = b.get_Text(); 
System.Console.WriteLine("Button Text = " + str); 
b.set_Text("Sample Button"); 
str = b.get_Text(); 
System.Console.WriteLine("Button Text = " + str); 
} 
} 


public class MyProp 
{ 


private int i = -1; 

/** @property */ 

public int get_SomeNum() 

{ 

} 

/** @property */ 

public void set_SomeNum(int input) 


{ 
i 


return i; 


i = input; 


public static void main() 

{ 
MyProp aprop = new MyProp(); 
System.Console.WriteLine(aprop.get_SomeNum()); 
aprop.set_SomeNum(8) ; 
System.Console.WriteLine(aprop.get_SomeNum()); 


The following sample creates two properties with the same name: 


public class PropTest 
{ 


private int i = -1; 
private int j -2; 


/** @property */ 
public int get_SomeNum() 
{ 


} 


/** @property */ 
public void set_SomeNum(int input) 


return i; 


{ 

} 

/** @property */ 

public int get _SomeNum(int i) 
{ 

} 


/** @property */ 
public void set_SomeNum(int i, int input) 


i = input; 


return j; 


{ 
j = input; 

} 

public static void main(String [] args) 

{ 
int i = Q; 
PropTest aprop = new PropTest(); 
System.Console.WriteLine(aprop.get_SomeNum()); 
System.Console.WriteLine(aprop.get_SomeNum(i) ) ; 
aprop.set_SomeNum(8) ; 
aprop.set_SomeNum(i,9); 
System.Console.WriteLine(aprop.get_SomeNum()); 
System.Console.WriteLine(aprop.get_SomeNum(i) ) ; 

} 


The following sample shows a Visual J# component with a property and shows how the property is consumed first by a Visual 
J# client and then by a C# client. 


// “jc_prop_use.jsl 

// compile with: /target:library 
public class PropTest 

{ 


private int i = -1; 

/** @property */ 

public int get_SomeNum() 

{ 

} 

/** @property */ 

public void set_SomeNum(int input) 


{ 
} 


return i; 


i = input; 


The following sample shows a Visual J# client that consumes the properties. To compile this sample, reference vjs_prop_use.dll. 


// Consumer_1.jsl 
// compile with: /reference: vjs_prop_use.dll 
public class Test 


{ 

public static void main(String [] args) 

{ 
int i = Q; 
PropTest aprop = new PropTest(); 
System.Console.WriteLine(aprop.get_SomeNum()); 
aprop.set_SomeNum(8) ; 
System.Console.WriteLine(aprop.get_SomeNum()); 

} 


The following sample shows a Visual C# client that consumes the properties. To compile this sample, reference 
vjs_prop_use.dll. 


// Consume2.cs 
// compile with: /reference: vjs_prop_use.dll 
public class Test 


{ 
public static void Main() 
{ 
PropTest aprop = new PropTest(); 
System.Console.WriteLine(aprop.SomeNum) ; 
aprop.SomeNum = 8; 
System.Console.WriteLine(aprop.SomeNum) ; 
i: 
} 


The following is an example of a Visual J# component that defines an indexed property. The following Visual C# sample shows 
how to consume the property. 


// \wjc_indexed_properties.jsl 
// compile with: /target:library 
import System.*; 
import System.Reflection.*; 
class Employee 
ii 
public Employee(System.String s, int d) 
{ 
_name = Ss; 
_dept = d; 
} 


/** @property */ 
System.String get_name() 
{ 

} 


/** @property */ 
int get_dept() 


return _name; 


return _dept; 


} 


private System.String _name; 
private int _dept; 


} 


/** @attribute DefaultMember("Report") */ 
// Sets the Report property as the indexer for the class. 
class Manager 
{ 
/** @property */ 
public Employee get_Report(System.String s) 


{ 
for (pEmp = Reports ; (pEmp!=null) && (pEmp.emp.get_name() != s) 
pEmp = pEmp.next); 
if (pEmp!=null) 
return pEmp.emp; 
else 
return null; 
} 


/** @property */ 
public void set_Report(System.String s, Employee e) 
{ 


for (pEmp = Reports ; (pEmp!=null) && (pEmp.emp.get_name() != s) 


pEmp = pEmp.next); 
if (pEmp==null) 


{ 
EmpList emp1 = new EmpList(); 
emp1.emp = e; 
emp1.next = Reports; 
Reports = emp1; 
} 
} 
private static class EmpList { 
public Employee emp; 
public EmpList next; 
} 


EmpList pEmp; 
static EmpList Reports = null; 


The following Visual C# sample consumes the property defined in the previous sample. To compile this example, reference 
vjc_indexed_properties.dll. 


// Consumei11.cs 
// compile with: /reference vjc_indexed_properties.dll 
using System; 


public class Class1 


{ 
public static void Main() 
af 
Manager Ed = new Manager(); 
Employee Bob = new Employee("Bob Smith", 12); 
// track Ed's reports 
Ed[Bob.name] = Bob; // indexed by string type 
Console.WriteLine(Ed[Bob.name].dept) ; 
} 
} 


Attributes added to the accessor methods are applied to the property by default. However, you can use the 
@attribute.method directive to attach the attributes to the individual methods, as follows: 


// vjc_properties_and_attributes.jsl 
// compile with: /target:library 
import System.ComponentModel.*; 


/* 
* Different attributes to getter and setter methods 
*/ 

public class Scalar 


{ 


private int magnitude = 101; 


/**@attribute Description("Attribute on the property") */ 
/**@attribute.method Description("Attribute on get accessor")*/ 
/**@property*/ 

public int get_Magnitude() 

{ 


} 


return magnitude; 


/**@attribute.method Description("Attrib on set accessor") */ 
/** @property */ 
public void set_Magnitude(int value) 


magnitude = value; 


Output 


Button Text = 
Button Text = Sample Button 





There is also support for defining properties in Visual J#. Two syntaxes are supported: the .NET syntax, and the Bean syntax. For 
information on the Bean-style property syntax, see Bean-Style Properties. When defining the accessor methods of a property 
using the .NET syntax, the accessor method name must begin with either get_ or set_. The property must be identified as such 
using the @property tag as shown in the examples below. 


The accessor methods of a property must use the same access modifiers. For example, both may be public, or both private. 
The type of the property must be the return type of the get_ accessor method and the type of the last argument of the set_ 
accessor method. 


It is possible to override property accessor methods in a derived class. 
In Visual J# a simple .NET-style property is defined as follows: 
Output 


=1 


A property can be defined as read only, or write only, when just the appropriate accessor (get_ or set_) function is defined. 
Properties can be overloaded if the method accessors do not conflict with the language rules. 


Output 
-1 
-2 


8 
9 


Output 


=: 


Output 


an 


Output 


12 
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Bean-Style Properties 


Bean-style properties use the naming pattern used by Java Beans. 
Remarks 


There are two distinct naming patterns that may be used interchangeably in J# code to declare properties: the NET naming 
pattern uses the get_ and set_ prefixes, and the bean naming pattern using get, set, and is as prefixes. To declare a bean-style 
property, use the /** @beanproperty */ tag instead of the /** @property */ tag to indicate the accessor uses the bean 
naming pattern. The compiler will look for the accessor to start with get, set, or is. The compiler will deduce the property name 
from the remainder of the identifier following the get, set, or is prefix. The case of the first letter in the property name is 
converted to lower case unless the property is in all caps, as per the camel casing convention applicable to methods in Java. 


Example 1 


The following example shows the definition of the /** @beanproperty */ tag to declare a property called value and the 
consumption of the property in C#. 


// beanprop1.jsl 
// compile with: /target:module 
public class SimpleProperty 
{ 
/** @beanproperty */ 
public int getvalue() { return _value; } 


/** @beanproperty */ 
public void setvalue (int v) { _value = v; } 


private int _value; 


// bpconsume.cs 
// compile with: /addmodule:beanprop1.netmodule /platform: x86 
class CMain 


{ 
public static void Main() 
{ 
SimpleProperty simple = new SimpleProperty(); 
simple.value = 15; 
System.Console.WriteLine( simple.value ); 
} 
} 
Output 
15 
Example 2 


The following example shows the use of the /** @beanproperty */ tag to declare a boolean property called initialized. 


// beanprop2.jsl 

// compile with: /target:module 

/* Declare a read-only boolean bean property using 
the isXXXX pattern */ 


class BooleanProperty 


{ 


private boolean _init = false; 


/** @beanproperty */ 
public boolean isinitialized() 


{ 


return _init; 


} 


public void Initialize() 


{ 
_init = true; 


, 





// bpconsume2.cs 
// compile with: /addmodule:beanprop2.netmodule /platform: x86 
using System; 


class CMain 


public static void Main() 





{ 
BooleanProperty bp = new BooleanProperty(); 
Console.WriteLine("Initialized: {@}", bp.initialized) ; 
bp.Initialize(); 
Console.WriteLine("Initialized: {@}", bp.initialized) ; 

} 

} 
Output 


Initialized: False 
Initialized: True 





See Also 
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Definition and Use of Events 


Visual J# enables you to register for events published by .NET Framework classes. You can register event handlers using the 
AddValueChanged and RemoveValueChanged event accessors as shown in the following code example. 


import System.Windows.Forms.*; 


public class MyClass 


if 

public static void main(String [] args) 

1 
System.Windows.Forms.Button button = 

new System.Windows.Forms.Button(); 
MyClass myClass = new MyClass(); 
System.EventHandler eventhandler = 
new System. EventHandler(myClass.OnDoubleClick) ; 

button.add DoubleClick(eventhandler) ; 
// OnDoubleClick is a method defined in the current class 
// that has the same signature as the EventHandler delegate. 
// The code above demonstrates how to use .NET Framework 
// delegates in Visual J#. 
// Similarly, you can unsubscribe to the event as follows: 
button.remove_DoubleClick(eventhandler) ; 

} 

private void OnDoubleClick(System.Object sender, System.EventArgs e) 

{ 

} 

} 


There is support for defining .NET Framework events in Visual J#. 
The format of an event declaration is as follows: 


/** @event */ 
void add_EventName(event_type event) 


/** @event */ 


void remove_EventName(event_type event) 


In this example, event_type is a parameter whose type defines the type of the event and that must be derived from Delegate. 
The add and remove methods for an event must both either be present or absent and have the same access modifiers. 


It is possible to override the event accessor methods in a derived class, as follows: 


import System.*; 
import System.Collections.ArrayList; 


/** @delegate */ 
public delegate void MyDelegate(); // delegate declaration 


public interface I 


x 
/** @event */ 
public void add MyEvent(MyDelegate listener); 
/** @event */ 
public void remove _MyEvent(MyDelegate listener); 
void FireAway(); 

} 


public class MyClass implements I 


private ArrayList list = new ArrayList(10); 
private int no = @; 


/** @event */ 
public void add MyEvent(MyDelegate listener) 


list.Add(listener) ; 
} 


/** @event */ 
public void remove _MyEvent(MyDelegate listener) 


{ 
list.Remove(listener) ; 
} 
public void FireAway() 
{ 
System.Object [] toArray = list.ToArray(); 
int len = toArray.length; 
for (int i = @3i < len ;i++) 
((MyDelegate) (toArray[i])).Invoke(); 
} 
} 
public class MainClass 
{ 
static public void main (String [] args) 
{ 
new MainClass(); 
} 
public void f1() 
{ 
Console.WriteLine("This is called when the event fires."); 
} 
public MainClass() 
{ 
I i = new MyClass(); 
i.add_ MyEvent(new MyDelegate(this.f1)); 
i.FireAway(); 
} 
} 


The previous code example produces the following output: 


This is called when the event fires. 
If the previous program were compiled as a DLL, its event could be accessed from a Visual C# program in the following 
example: 
Example 1 


In this example, Mainclass enables MyDelegate to run the private method ¢£ (). 


// vjc_events3.jsl 
// compile with: /t:library /out:VIJC_Events3.dll 


import System.*; 
import System.Collections.ArrayList; 


/** @delegate */ 


public delegate void MyDelegate(); // delegate declaration 


public interface I 


{ 
/** @event */ 
public void add MyEvent(MyDelegate listener); 


/** @event */ 
public void remove _MyEvent(MyDelegate listener); 


void FireAway(); 


} 


public class MyClass implements I 


{ 
private ArrayList list = new ArrayList(1@); 


private int no = @; 


/** @event */ 
public void add MyEvent(MyDelegate listener) 
{ 


} 


/** @event */ 
public void remove MyEvent(MyDelegate listener) 


4 
} 


list.Add(listener) ; 


list.Remove(listener) ; 


public void FireAway() 


{ 
System.Object[] toArray = list.ToArray(); 


int len = toArray.length; 
for (int i = @; i < len; i++) 


{ 
} 


((MyDelegate) (toArray[i])).Invoke(); 


// vjc_events4.cs 
// compile with: /reference:vjc_events3.d1l 
using System; 


public class MainClass 


{ 
static private void f() 
{ 
Console.WriteLine("This is called when the event fires."); 
} 
static public void Main () 
{ 
I i = new MyClass(); 
i.MyEvent += new MyDelegate(f); 
i.FireAway(); 
} 
} 
Output 


This is called when th vent fires. 
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Bean-Style Properties 


Bean-style properties use the naming pattern used by Java Beans. 
Remarks 


There are two distinct naming patterns that may be used interchangeably in J# code to declare properties: the NET naming 
pattern uses the get_ and set_ prefixes, and the bean naming pattern using get, set, and is as prefixes. To declare a bean-style 
property, use the /** @beanproperty */ tag instead of the /** @property */ tag to indicate the accessor uses the bean 
naming pattern. The compiler will look for the accessor to start with get, set, or is. The compiler will deduce the property name 
from the remainder of the identifier following the get, set, or is prefix. The case of the first letter in the property name is 
converted to lower case unless the property is in all caps, as per the camel casing convention applicable to methods in Java. 


Example 1 


The following example shows the definition of the /** @beanproperty */ tag to declare a property called value and the 
consumption of the property in C#. 


// beanprop1.jsl 
// compile with: /target:module 
public class SimpleProperty 
{ 
/** @beanproperty */ 
public int getvalue() { return _value; } 


/** @beanproperty */ 
public void setvalue (int v) { _value = v; } 


private int _value; 


// bpconsume.cs 
// compile with: /addmodule:beanprop1.netmodule /platform: x86 
class CMain 


{ 
public static void Main() 
{ 
SimpleProperty simple = new SimpleProperty(); 
simple.value = 15; 
System.Console.WriteLine( simple.value ); 
} 
} 
Output 
15 
Example 2 


The following example shows the use of the /** @beanproperty */ tag to declare a boolean property called initialized. 


// beanprop2.jsl 

// compile with: /target:module 

/* Declare a read-only boolean bean property using 
the isXXXX pattern */ 


class BooleanProperty 


{ 


private boolean _init = false; 


/** @beanproperty */ 
public boolean isinitialized() 


{ 


return _init; 


} 


public void Initialize() 


{ 
_init = true; 


, 





// bpconsume2.cs 
// compile with: /addmodule:beanprop2.netmodule /platform: x86 
using System; 


class CMain 


public static void Main() 





{ 
BooleanProperty bp = new BooleanProperty(); 
Console.WriteLine("Initialized: {@}", bp.initialized) ; 
bp.Initialize(); 
Console.WriteLine("Initialized: {@}", bp.initialized) ; 

} 

} 
Output 


Initialized: False 
Initialized: True 





See Also 
Reference 
Defining and Using Properties 
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Definition and Use of .NET Framework Delegates 


The Visual J# compiler allows you to create a .NET Framework delegate, much like the delegates extension in Visual J++. The 
important distinction is that binding is always done at compile time. 


Example 


import System.Windows.Forms.*; 
import System.*; 


public class MyObjClass 


{ 
public void OnDoubleClick(System.Object 0, System.EventArgs e) 
{ 
System.Console.WriteLine("test"); 
} 
} 
public class MyClass 
{ 
public static void main() 
MyObjClass obj = new MyObjClass(); 
// Where OnDoubleClick is a method in obj. 
EventHandler handler = new EventHandler(obj.OnDoubleClick) ; 
handler.Invoke(obj, new EventArgs()); 
// The following is also valid. 
EventHandler handler2 = new EventHandler(obj, "OnDoubleClick"); 
handler2.Invoke(obj, new EventArgs()); 
} 
} 


import System.*; 


/**@delegate*/ 
delegate void MyDelegate(int i); 


class Program 


{ 
public static void main(System.String [] args) 
{ 
TakesADelegate(new MyDelegate(Program.DelegateFunction) ) ; 
} 
public static void TakesADelegate(MyDelegate SomeFunction) 
{ 
SomeFunction. Invoke(21) ; 
} 
public static void DelegateFunction(int i) 
{ 
Console.WriteLine("Called by delegate with number: "+ i+ "."); 
} 
} 
Output 
test 
test 


There is support for defining INET Framework delegates in Visual J#. (You can also define Visual J++ 6.0-style delegates, and 
they are of type com.ms.lang.Delegate.) 


The declaration of a delegate type will consist of the following components: 


The attribute /** @delegate */. 


An access level. 


The keyword delegate, or multicast delegate. 


The return type and signature of the method the delegate type addresses. 


e@ The name of the delegate type, which is placed between the return type and signature of the method. 


The following declares EventHandler to be a public delegate type that addresses methods taking no parameters and with a 
return type of void: 


/** @delegate */ 
public delegate void EventHandler(); 





If a delegate type is used to address only a single method at one time, it may address a member function of any return type 
and signature. If, however, the delegate type addresses two or more methods simultaneously, the return type must be void. 


Binding for .NET Framework delegates is always done at compile time. 
Output 


Called by delegate with number: 21. 


See Also 
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Using Value Types 


In the Java language, primitive types such as byte, int, boolean, char, short, long, float, and double are value types. All 
other types are reference types. In other .NET Framework languages, value types other than these can be defined. Visual J# 
provides extensions to the Java language to allow these value types defined in other .NET Framework languages to be used in 
J# code, and in Visual J# 2005, J# also enables value types to be authored in the language. 


Value types are different from reference types in several ways. The following statements are true about value types: 


e Value types are stored on the stack, not the heap. 

e Value types are passed by value, not by reference. 

e Value types are copied as whole objects when assigned, rather than having only the reference copied. 

e When compared for equality, the entire object of a value type is compared for a match, rather than just the reference. 
e Value types cannot be derived from. 


e Value types do not require constructors. 


For more information, see Value Types in the Common Type System. 


The Visual J# compiler allows you to use value types defined in the .NET Framework or other user-defined assemblies. 
Instances of value types can be directly used in Visual J# as Object. The Visual J# compiler implicitly does the necessary boxing; 
when a value type is assigned to a variable of type Object, a proxy object is created and wrapped—boxed—around the value 
type. Similarly, when an object is cast to a value type, the compiler performs the unboxing, extracting the value type from the 
object wrapping. Boxing takes place automatically for value types defined in J# or other languages, but not for Java-language 
primitive types. For more information, see Using Value Types Corresponding to Primitive Types and User-Defined Value Types 


Example 
// vjc_valuetypes1.jsl 


import System.*; 
public class MyClass 


{ 
public static void main(String [] args) 
if 
// DateTime is a value type; use it like a reference type. 
DateTime dt = new DateTime(); 
dt = DateTime.Parse("01/01/2002 12:00"); 
// Automatically box value type dt to System.Object. 
System.Object obj = dt; 
// Obj unboxed to the value type DateTime. 
DateTime dt2 = (DateTime) obj; 
dt2 = DateTime.Parse("01/01/2003 12:00"); 
} 
} 





In this code, DateTime is a value type defined in the INET Framework library. Although the syntax is the same as for a reference 
type, the code generated is very different since operations on the value type are stack-based, not heap-based. There is a 
performance advantage over using a reference type since the operations of boxing and unboxing are not required, and since 
the value type resides on the stack, not the heap, accessing it does not require an indirection. 


See Also 

Reference 
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Using Value Types Corresponding to Primitive Types 


Visual J# allows you to directly use the primitive class types corresponding to each primitive type that can be found in the .NET 
Framework (System.Int32 for int). The only restriction is that you need to use a cast to assign a primitive type to its 
corresponding class type. Similarly you need a cast to assign a primitive type to System.Object. These restrictions are 
necessary so as not to violate the semantics of the Java language. The casting of the primitive type to the corresponding value 
type is not transitive. 


Example 





// vwjc_valuetypes2.jsl 
import System.*; 
public class MyClass 


public static void main(String [] args) 
{ 
Int32 int32 = (Int32) 10; 
int i = (int) int32; 
Console.WriteLine(i); 
System.Object obj1 = int32; // Ok. int32 is a value type. 
Console.WriteLine(obj1) ; 
System.Object obj2 = (Int32) 10; // Will also work. 
Console.WriteLine(obj2) ; 


// The following statements will not compile, 

// a primitive type cannot be assigned to a reference type: 
// System.Int32 int32 = 10; 

// System.Object obj = 10; 





Output 


The .NET Framework supports some primitive types that are not part of the Java language. You can use these types by using 
the corresponding value type from the .NET Framework as described above, and the Visual J# compiler generates the right 
code for taking care of the conversions. The following table gives a list of such types: 

















unsigned short or uint16 System.UInt16 
unsigned int or uint32 System.UInt32 
unsigned long or uint64 System.UInt64 
native int System.IntPtr 
native unsigned int System.UIntPtr 
See Also 
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User-Defined Value Types 


A value type is similar to a class except that instead of being a reference to an object on the heap, a value type is an aggregate 
that can be created directly on the stack, just like a primitive type. But, like classes, value types can have constructors, constants, 
fields, methods, properties, and nested types as members. However, the following restrictions apply when defining a value 


type: 
e Value types must extend ValueType. 
e Value types must explicitly be declared final. 
e Value types cannot be declared abstract. 
e Members of the class can be declared public and private, but not protected. If unspecified, access is package scoped. 
e A parameterless constructor cannot be declared in value types. 
e Field initializers are not allowed on instance fields in value types. However, static fields can have field initializers. 
e Itis an error for the constructor of a user-defined value type to call super. 
e Value types cannot declare a finalize method. 


e Value types do not support Java reflection and cannot be serialized as Java types. Use .NET Framework reflection and 
.NET Framework serialization for these types 


e Value types are not available with the /x:net option. 


You can instantiate value types in two ways. You can instantiate a value type in an uninitialized form or in an initialized form by 
using the new operator. Although the new operator is invoked, the value type object is allocated on the stack, not the heap. 
The lifetime of the object is the lifetime of the stack frame in which it is created. When the scope in which it is declared goes out 
of scope, the object is destroyed. 


The following example shows the definition and instantiation of a simple value type. 
Example 


// value_type.jsl 
public final class Point extends System.ValueType 


{ 
public int x; 
public int y; 
} 
class CMain 
{ 
public static void main() 
i 
Point p = new Point(); 
p.x = 5; 
p.y = 10; 
System.Console.WriteLine("Point [x,y] =" +p.x +", "+ p.y)3 
} 
} 
Output 


Point [x,y] = 5, 10 
A value type, if not assigned to or initialized with the new operator, is considered uninitialized. 


A value type has a default value that is used in certain contexts, such as when an array of value types is created. The default 
value is the value produced by setting all value type fields to their default values and reference types to null. For example, 
primitive integer types have a default value of 0, so in the following code, members of Point x and y will be set to zero in all 
objects in the array: 


Point[] pa = new Point[100]; 


Because each value type has an implicitly defined parameterless constructor that produces the default value as described, it is 


an error to declare a parameterless constructor in a value type. 
Value types can reference the inherited members of ValueType. 


User-defined value types have value semantics, not reference semantics. With reference types, it is possible to have two 
references to the same object. With value types, each instance contains its own copy of the data. When a value type is assigned, 
the data is copied. When a reference type is assigned, only the reference is copied. Thus, for reference types, it is possible for 
operations to affect an instance shared by two references. This is impossible for value types, which always operate on their 
own unique instance. 


Similarly, when a value type is passed as an argument to a function, the function will create its own copy of the object, unless 
the function uses the Defining Methods That Take Arguments By Reference tag to specify that it takes the parameter by 
reference. 


See Also 
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Using Enumerations 


The Visual J# compiler allows you to use enumerations defined in the .NET Framework or other user-defined assemblies. 
Enumerations are treated as reference types by default. Enumerations can be cast to and from their underlying primitive types. 
They can also be assigned to Object, in which case the compiler implicitly performs the necessary boxing. 


Example 


| import System.*; 
public class MyClass 


{ 


public static void main() 


{ 


} 


DayOfWeek friday = DayOfWeek.Friday; 


// Call a method that has a parameter of type DayOfWeek 
TestClass mySchedule = new TestClass(); 
mySchedule.SetNonWorkingDay (friday) ; 

// convert an enum to its underlying primitive: 

int i = (int) friday; 

Console.WriteLine(i); 


// OK to cast a primitive type to enum: 
DayOfWeek monday = (DayOfWeek) 1; 
Console.WriteLine(monday) ; 


// following line automatically boxes enum friday 
// to System.Object: 

System.Object obj = friday; 
Console.WriteLine(obj) ; 


public class TestClass 


public void SetNonWorkingDay(DayOfWeek dow) 


} 


Output 


5 
Monday 
Friday 


Applying bitwise operators (|, &, “) to enumeration types is allowed. The following code performs a bitwise-OR operation on 
System.Windows.Forms.AnchorStyles in a call to CheckBox.set_Anchor: 


CheckBox.set_Anchor (AnchorStyles.Top | AnchorStyles.Bottom) 


See Also 
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User-Defined Enumeration Types (J#) 


Visual J# provides support for authoring enumeration types. An enumeration type is an int that contains named constants to 
represent different possible values. 


An enumeration is a user-defined value type. The rules for the semantics of value types apply. For more information, see 
User-Defined Value Types. 


A declaration of an enumeration type is similar to a class declaration. However, the following additional rules apply: 
e The keyword enum is used in place of the class keyword. 
e Enumeration types implicitly extend Enum. 
e Enumeration types are implicitly static and final. 
e Enumeration types cannot be declared abstract. 
e Enumeration types can be public or private or package-scoped, but not protected. 
e Enumeration types cannot have methods, properties, or events. 
e Enumeration types cannot implement interfaces. 
e Enumeration types are not available with the /x (Disable Language Extensions) option. 
The named values of an enumeration type are declared as static final members of the enumeration and are initialized with 


constant expressions, as shown in the following example: 


// enum1.jsl 
// compile with: /target:library 
public enum ColorEnum 


. 
Red, 
Green, 
Blue 

} 


An enumeration value can be referenced like a static field, as in the following: 


int i = (int) ColorEnum.Red 


It is an error to attempt to instantiate an enumeration value using the new keyword. 


The integral value of an enum member can be set using the following syntax: 


public enum ColorEnum 


‘ 
Red(1), 
Green(2), 
Blue(3) 

J 


If not set explicitly, the integral values are set implicitly. The first enumeration value in the enumeration declaration is set to 0. 
Any subsequent members, if not set explicitly, are determined from the previous member's value incremented by one. For 
example, in the following declaration: 


public enum ColorEnum 
{ 

Red, 

Green(10), 

Blue 


Red gets the value 0, Green gets the value 10, and Blue gets the value 11. 

Multiple enumeration type members can share the same integral value. 

Dependencies of members of an enum to other members is allowed, as long as the dependency is not circular. 
// enum2.jsl 


// compile with: /target:library 
public enum ColorEnum 


{ 
Red, 
Blue, 
Green(Blue) ; 
} 


Inherited methods and properties of Enum can be used on values of an enumeration type. 


Enumeration types cannot be implicitly converted to their underlying type or any other integral or enumeration type. They 
must be explicitly converted using a cast. The following is illegal: 


int i = Color.Red; // error 
int i = (int) Color.Red; // OK 
The following operators can be used on values of enumeration types: ==, !=, <, >, <=, >=, +, -, *, &, |, ~. 


Enumeration types are value types and participate in boxing conversions as other value types do. 


Enumeration types may be used in a switch statement. The enumeration members may be used as case labels. 


ColorEnum color = Color.Red; 
switch( color ) 


{ 


case ColorEnum.Red: 
// 

break; 

case ColorEnum.Blue: 
// 

break; 

case ColorEnum.Green: 
Td vite 

break; 

default: 

break; 


Each enum type defines a distinct type; an explicit enumeration conversion is required to convert between two enum types. 
The set of values that an enum type can take on is not limited by its enum members. In particular, any value of the underlying 
type of an enum can be cast to the enum type, and is a distinct value of that enum type. 


Like other value types, enumeration types do not support Java reflection and cannot be serialized as Java types. Use NET 
Framework reflection and .NET Framework serialization for these types. 


Example 


// enum_example.jsl 
import System.*; 


public enum RGBColor 


{ 
Red, 
Blue, 
Green 
} 
public final class RGB 
{ 


private int[] m_colors = new int[3]; 


public RGB() 


{ 
for (RGBColor rgb1 = RGBColor.Red; 
(int)rgb1 <= (int)RGBColor.Green; 
rgb1 = (RGBColor)((int)rgb1 + 1)) 
{ 
m_colors[(int)rgb1] = @; 
} 
} 
public RGB(int ri, int r2, int r3) 
{ 


// Enums must be converted to an integral type 

// for use as array indices. 
m_colors[(int)RGBColor.Red] = r1; 
m_colors[(int)RGBColor.Green] = r2; 
m_colors[(int)RGBColor.Blue] = r3; 


} 


int get_Color(RGBColor c) 
{ 


return m_colors[(int)c]; 


} 


public static void printRGBColor(RGBColor c) 
{ 
switch( c ) 
{ 
case RGBColor.Red: 
Console.WriteLine("Red"); 
break; 
case RGBColor.Blue: 
Console.WriteLine("Blue") ; 
break; 
case RGBColor.Green: 
Console.WriteLine("Green") ; 
break; 
default: 
break; 


} 


public class CMain 

{ 
public static void main() 
{ 
RGB black 
RGB white 


new RGB(); 
new RGB(255, 255, 255); 


Console.WriteLine("Black consists of R: + 
black.get_Color(RGBColor.Red) 
+ " G: " + black.get_Color(RGBColor.Green) 
+ " B: " + black.get_Color(RGBColor.Blue) ); 


Console.WriteLine("White consists of R: + 
white. get_Color(RGBColor.Red) 
+ " G: " + white.get_Color(RGBColor.Green) 
+ " B: " + white.get_Color(RGBColor.Blue) ); 


RGB.printRGBColor( RGBColor.Red) ; 


Output 





Black consists of R: 0 G: O B: 0O 
White consists of R: 255 G: 255 B: 255 
Red 
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Property and Event Exposure 


You can create a component in Visual J# that exposes properties and events, and then write a program in another language, 
such as Visual Basic, to consume this component. 


Example 
The following is the J# code to create a component that can be consumed by other languages. 
// vwjc_container.jsl 


// compile with: /target:library 
import System.Collections.ArrayList; 


/** @delegate */ 
public delegate void ValueChanged(); 


public class Container 


{ 
private ArrayList al = new ArrayList(); 
// Read-only property Count 
/** @property */ 
public int get_Count() 
{ 
return al.get_Count(); 
} 
/** @property */ 
public void set_Value(int i, System.String val) 
{ 
al.Insert(i, val); 
if (ev != null) 
{ 
ev.Invoke(); // Raise event. 
} 
} 
/** @property */ 
public System.String get_Value(int i) 
{ 
return (System.String) al.get_Item(i); 
} 
public ValueChanged ev = null; 
/** @event */ 
public void add _Event(ValueChanged p) 
{ 
ev = (ValueChanged) System.Delegate.Combine(ev, p); 
} 
/** @event */ 
public void remove_Event(ValueChanged p) 
{ 
ev = (ValueChanged) System.Delegate.Remove(ev, p); 
} 
} 


The following is a Visual Basic client that consumes the properties and sinks the event fired by the Visual J# component. 


" client.vb 
" compile with: /reference:vjc_container.d1l 
Imports System 
Public Class Form 
WithEvents Dim c As New Container() 


Public Shared Sub Main() 
Dim # As New Form 
End Sub 


Public Sub New() 
c.Value(@) = "String1" 
c.Value(1) = "String2" 
" Fetching read-only property 
System.Console.WriteLine(c.Count) 

End Sub 

" Sink Visual J# event 
Public Sub EvListener() Handles c.Event 

System.Console.WriteLine("Visual J# Event Fired") 
End Sub 
End Class 





Visual J# Event Fired 
Visual J# Event Fired 
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Calling Native Methods 


Visual J# provides complete support for the J/Direct technology available in Visual J++ 6.0. In addition, you can use the 
platform invocation services provided by the common language runtime to call into native code. For more information, see 
Consuming Unmanaged DLL Functions. 


Example 


The following code uses the platform invoke mechanism to output some text using functions in the Microsoft Visual C++ run- 
time library DLL. 


// vjc_pinvoke.jsl 
import System.Runtime. InteropServices. *; 
class MyClass 


/** @attribute DllImport("msvcrt.d11") */ 

public static native int puts(String c); 
/** @attribute DllImport("msvcrt.d11") */ 
private static native int _flushall(); 


public static void main(String [] args) 


{ 
puts("Test"); 
_flushall(); 
} 
} 
Output 
Test 


When using platform invoke to call into native code, marshaling support exists only for the following: 
e Types defined in the .NET Framework 
e java.lang.Object 
e java.lang.String 


e Primitive types 


To marshal other Java-language types to native code, you might be required to use custom marshaling, as these are not 
handled by the default .NET Framework platform invoke marshaler. For more information, see Interop Marshaling. 


When upgrading Visual J++ 6.0 applications, using @dll and @com directives of Visual J++ 6.0 with the .NET Framework 
interop attributes is not supported and is strongly discouraged. Such uses might lead to run-time issues in the compiled 
application. 


See Also 
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Type Conversion Operations 


Visual J# does not support type conversion operators. A common language specification (CLS)-compliant type usually provides 
an alternate mechanism of achieving this conversion using the ToX, where X is the name of the target type, and FromY, where 
Y is the name of the source type, methods. The Visual J# user can perform the type conversions using these methods. 


Direct use of the op_Implicit and op_Explicit methods is not recommended, as these methods can have overridden return 
types and therefore cannot be used for method resolution. 


Example 
// wjc_type_conv_op.jsl 


import System.*; 
class MyClass 


{ 
public static void main(String [] args) 
1 
int i = 10; 
Decimal dec = new Decimal(2@); 
Console.WriteLine("dec = {@}", dec); 
Console.Write("i = "); 
Console.WriteLine(i) ; 
// In Visual J#, you can use the CLS-compliant 
// conversion methods: 
i = Decimal. ToInt32(dec); 
Console.Write("i = "); 
Console.WriteLine(i) ; 
// Converting an int to a System.Decimal. 
// In Visual J#, you can use the constructor that 
// takes int: 
i = 9; 
dec = new System.Decimal(i); 
Console.WriteLine("dec = {@}", dec); 
} 
} 
Output 
dec = 20 
i = 10 
i = 20 
dec = 9 
See Also 
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Conversions Between .NET Framework Types and Java Wrapper 
Types 


In Visual J# 2005, Java-language wrapper types support IConvertible, enabling them to participate in conversions to .NET 
runtime types. 


Remarks 


The IConvertible interface provides methods that allow types to be converted to common language runtime types. For details 
on these methods, see the documentation for the [Convertible interface. The following Java-language types now implement 
IConvertible: 


Types Supporting IConvertible 





jjava.lang.Boolean java.lang.Long 
|java.lang.Byte java.lang.Short 
jjava.lang.Character java.lang.String 
jjava.lang.Double java.math.BigInteger 
jjava.lang.Float java.math.BigDecimal 
jjava.lang.Integer java.util.Date 








Some conversions are not allowed. If a disallowed conversion is attempted using one of the IConvertible methods, an 
InvalidCastException is thrown. An exception is thrown for the following conversions: 


Disallowed Conversions 




















From To 
|java.lang.Character System.Boolean 
jjava.lang.Character System.Single 
|java.lang.Character System.Double 
|java.lang.Character System.Decimal 
|java.lang.Boolean System.Char 
jjava.lang.Float System.Char 
|java.lang.Double System.Char 
|java.math.BigDecimal System.Char 
|java.math.BigInteger System.Char 
java.util.Date Any type except System.String or System.DateTime 
Any type except java.lang.String or java.util.Date System.DateTime 
See Also 
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Support for .NET Serialization 


Visual J# 2005 supports .NET serialization for JDK equivalent classes in the J# class library that are Java serializable. Every J# 
Java-language type that is serializable (using either the Serializable interface or the Externalizable interface) is now 
automatically NET Framework serializable. The J# classes that ship with Visual J# can be involved in serialization using .NET 
Framework APIs. 


All user-defined classes must explicitly follow the .NET Framework serialization model to be serialized with the .NET 
Framework serialization APIs. 


Enabling .NET Framework serialization for these Java-language serializable types enables the following behavior: 


e Enables the use of BinaryFormatter or SoapFormatter when serializing. 
e Enables objects of these types to participate in .NET Framework remoting. 


e Allows limited support for XMLFormatter. Support is limited because private fields will not be serialized as they 
normally are in the NET Framework serialization model. 


e Allows user-defined classes to have members of these types and participate in NET Framework serialization. 


You can also write your own custom serialization. For more information, see Custom Serialization. 
Example 


In the following example, an object is created which implements Serializable and uses J# class library types as fields. The 
Serializable attribute is also explicitly attached, which enables it be serializable using both the Java-language serialization 
model and the .NET Framework serialization model. In previous versions, this type could not be serialized using .NET 
Framework APIs because the J# class library types were not .NET Framework serializable. The object is serialized in both 
formats and then read back in again. 


// Serialize.jsl 
// Serialization Example 


import java.io.*; 

import System.I0.*; 

import System.Runtime.Serialization.Formatters.Binary.*; 
import System.Runtime.Serialization.*; 

import System.SerializableAttribute; 


// This class implements the Java language Serializable interface 

// thus making it a serializable class 

// The user explicitly marks this class to be .NET Framework serializable. 
// using the System.Serializable attribute. 

// The class uses J# class library types as fields. 

/** @attribute Serializable() */ 

public class MyClass implements Serializable 


if 
public Integer i, j, k; 


public MyClass() 


{ 
i= j = k = new Integer(@); 
} 
public MyClass(int _i, int _j, int _k) 
i 
i = new Integer(_i); 
j = new Integer(_j); 
k = new Integer(_k); 
} 


public void write() 
1 


} 


System.Console.WriteLine("i: "+i+4+4" j: "+ j++" k: "+ k)5 


} 


public class CMain 


{ 

{ 
System.out.println("Static ctor for CMain"); 

} 

public static void WriteObjectNET(Object obj) 

{ 
IFormatter formatter = new BinaryFormatter(); 
Stream stream = new FileStream("MyFile.bin", FileMode.Create, 

FileAccess.Write, FileShare.None) ; 

formatter.Serialize(stream, obj); 
stream.Close(); 

} 


public static void WriteObjectJava(Object obj) throws 
java.io. IOException 


{ 
FileOutputStream fos = new FileOutputStream("serialized_Object"); 
ObjectOutputStream os = new ObjectOutputStream(fos) ; 
os.writeObject(obj); 
os.flush(); 
os.close(); 
} 
public static Object ReadObjectNET() 
{ 
IFormatter formatter = new BinaryFormatter(); 
Stream stream = new FileStream("MyFile.bin", FileMode.Open, 
FileAccess.Read, FileShare.None); 
Object o = formatter.Deserialize(stream) ; 
stream.Close(); 
return 0; 
} 


public static Object ReadObjectJava() throws java.io. IOException, 
ClassNotFoundException 
{ 
FileInputStream fis = new FileInputStream("serialized_Object"); 
ObjectInputStream ois = new ObjectInputStream( fis); 
Object o = ois.readObject(); 
ois.close(); 
return 0; 


} 


public static void main() 
ne 
MyClass obj1 = new MyClass(100, 200, 300); 
try 
{ 
WriteObjectNET(obj1); 
WriteObjectJava(obj1) ; 
obj1 = (MyClass) ReadObjectNET(); 
obj1.Write(); 
obj1 = (MyClass) ReadObjectJava(); 
obj1.Write(); 
} 
catch(Exception e) 
if 
System.Console.WriteLine("Exception!"); 
System.Console.WriteLine(e.get_Message()); 


Output 


1: 100 3: 200 k: 300 
1: 100 j: 200 k: 300 


See Also 
Reference 
Syntax for Targeting the .NET Framework 
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Common Language Specification Compliance Checking 


The Common Language Specification (CLS) is a set of rules intended to promote language interoperability. For a framework to 
be usable in multiple languages, it is essential that it conforms to these rules. In order for a given type to be used by other 
languages, it must be compliant with the CLS. Compliance with the CLS means avoiding language constructs that are not 
shared by all languages. Lack of compliance with the CLS means that a type is not guaranteed to be usable from all languages. 


In Visual J# 2005, the compiler provides support for checking types for compliance with the Common Language Specification 
(CLS). For more information on the CLS, see What is the Common Language Specification?. 


A type that is intended to be used by another language should be marked with the CLSCompliant attribute. Also, an assembly 
that contains CLS compliant types should be marked with the assembly-level CLSCompliant attribute. The compiler will check 
the CLS compliance of any public type marked with the CLSCompliant attribute in an assembly that is marked CLS compliant. 


// MyClass.jsl 

// compile with: /target:library 

// Assembly-level CLS Compliant attribute: 

/** @assembly System.CLSCompliant(true) */ 

// Class-level CLS Compliant attribute: 

/** @attribute System.CLSCompliant(true) */ 
public class MyClass 


public void method1() 


{ 


} 
public void method2() 


{ 
} 


The CLSCompliant attribute should not be used on classes without the assembly-level CLSCompliant attribute, since they 
will not be checked for CLS compliance unless the assembly-level attribute is present. 


The CLSCompliant attribute may be used with the false argument. This should be used for a class that is not CLS compliant in 
an assembly that is marked as CLS compliant. Marking a class with CLSComplaint (false) indicates that the class is not 
intended to be used in other languages and should not be checked for CLS compliance. 


If the assembly-level attribute is set to ‘false’, CLS compliance checking will only be done for those types in the assembly that 
have been specifically marked with the CLSCompliant attribute set to ‘true’. 


Only public types should be marked as cLSCompliant (true). Internal types may not be used by other languages, so CLS rules 
do not apply to such types. 


For a listing of CLS Rules enforced by the Visual J# compiler, see What is the Common Language Specification?. 


See Also 
Other Resources 
Language Support 


Generics in J# 


This topic describes the use of generic types and methods in the J# language. 


Some languages on the .NET Framework platform provide support for authoring generic types and methods. Generic types are 
types that have an unspecified type parameter at build time that may be specialized at run time with any type, as long as the 
substituted type satisfies any constraints that may have been placed on it in the generic's definition. 


Generic types provide support for type-safe collection classes. Rather than using a collection class that takes Object as the item 
type, you can create typed collection classes that only accept a single type. With a typed generic collection, there is no need for 
casting to Object and then downcasting to another type when reading the object from the collection. The lack of casting 
improves performance. 


The .NET Framework type library defines useful generic collection classes that may be used in Visual J# programs. For more 
information see System.Collections.Generic. 


J# does not support authoring of generic collection classes, but it does extend the Java-language syntax to provide support for 
using specializations of generic types and methods defined in other .NET Framework languages. In this section, you will find 
out how to use these types in J# programs. 


Consuming Generics in J# 


The basic syntax for specializing a generic type in J# is the same as that used in other languages: include the type argument in 
angle brackets, like this: 


Stack<int> myIntStack = new Stack<int>(); 
Stack<String> myStringStack = new Stack<String>(); 


Dictionary<int, String> myDict = new Dictionary<int, String>(); 


The above types are said to be constructed types. Types constructed from the same generic type but with different type 
arguments are distinct types. That is, Stack<int> and Stack<String> are not the same type. These types are type-safe: you will 
get a compiler error if you try to put a string into a stack whose type is Stack<int>. 


The type argument may be a reference type, primitive type, or value type as appropriate. 


Example 


In this example, a generic is defined in C# and consumed in J#. The C# code defines a type parameter T which is unknown in 
the compiled assembly. The J# code supplies a type argument to the generic, thus generating a constructor where all unknown 
type parameters have been replaced by actual types. 


// stack.cs 

// compile with: /target:library 

// a generic class is just a family of classes defined 

// in terms of some type T. T will be a particular 

// type when the generic is consumed 

public class Stack<T> 

{ 
private T[] items; // field types can use ##: 
private int nitems; 


public Stack() // ctor creates a Stack<T> for any T 
{ 

nitems = @; 

items = new T[5@]; 


} 


// Pop() returns a value of type T by loading 
// it from the array of type T[] 
public T Pop() 
1 
if (nitems == @) 
{ 
System.Console.WriteLine("Stack underflow") ; 
return items[@]; 


return items[--nitems]; 


} 


// Push() writes a T into the array, possibly expanding. 
public void Push(T item) 


{ 
if (items.Length == nitems) 
{ 
T[] temp = items; 
items = new T[nitems*2]; 
System.Array.Copy(temp, items, nitems); 
} 
items[nitems++] = item; 
} 


The J# code below consumes the generic declared in the above C# code. 


// stackapp.jsl 
// compile with: /reference:stack.d1l 
public class app 


public static void main(String [] args) 


{ 
Stack<int> s = new Stack<int>(); 
int i = Q; 
for (i = 03 i < 53 i++) 
s.Push(i); 
for (i = 53 i > @; i--) 
{ 
System.Console.WriteLine(s.Pop()); 
} 
} 
} 
Output 
4 
3 
2 
1 
0 
Example 


Interfaces may also be generic. A generic interface, like a generic class, contains unknown type parameters. 


The following example shows the J# code consuming a generic interface. 


// istack.cs 
// compile with: /target:library 


public interface IStack<T> 


{ 
T Pop(); 
void Push(T item); 
} 
public class Stack<T> : IStack<T> 
{ 


private T[] items; 
private int nitems; 


public Stack() 
{ 


nitems = @; 
items = new T[5@]; 
} 
public T Pop() 
if (nitems == @) 
if 
System.Console.WriteLine("Stack underflow") ; 


return items[Q@]; 


return items[--nitems ]; 


} 
public void Push(T item) 
{ 
if (items.Length == nitems) 
{ 
T[] temp = items; 
items = new T[nitems*2]; 
System.Array.Copy(temp, items, nitems); 
items[nitems++] = item; 
} 


The J# code below consumes the C# generic class and interface declared above. 


// istackapp.jsl 
// compile with: /r:istack.dll 
public class app 


{ 
public static void main(String [] args) 
{ 
IStack<int> s = new Stack<int>(); 
int i = @; 
for (i = 03; i < 53 i++) 
s.Push(i); 
} 
display(s); 
} 
// Note how the contructed type is passed as a param 
public static void display( 
IStack<int> s) 
{ 
for (int i = 53; i > @; i--) 
{ 
System.Console.WriteLine(s.Pop()); 
} 
} 
} 
Output 


Constraints 


Generic types declared in the .NET Framework class library or in other .NET Framework languages may put restrictions on the 
types that may be used as type arguments for a given type parameter. For example, a constraint may limit the possible type 
arguments to types that implement a certain interface, or inherit from a certain base class. Usually this is done because the 
implementation of the generic type requires some methods of the base class or interface. In addition to interface and base 
class constraints, some special constraints are defined such as the parameterless constructor constraint, which requires that 
type arguments have a default constructor (a public parameterless constructor). The constructor constraint ensures that the 
generic type has the ability to create objects of that type. 


Another constraint that may be applied to a generic type is a reference type constraint, which ensures that the type used as a 
type argument is a reference type. Alternatively, one may constrain the type used to be a value type, either a built-in type such 
as int or double, or a user-defined value type. 


Every time a type is supplied for a type parameter, constraints are checked. For example, constraints are checked at a method 
call to a generic method, or when building a constructed type out of a generic type. For constructed types in J# based on 
generic types, constraints are checked at the creation of the constructed type. A constraint c is satisfied for a type argument 7 if 
there is an implicit conversion from T to c. 


Example 


The following example shows a generic defined in C# with an interface constraint on the type parameter. In J#, only types 
implementing the interface specified in the constraint may be used as type arguments. 


// idisplaystack.cs 

// compile with: /target:library 
public interface IDisplay 

{ 


} 


void display(); 


public class Stack<T> where T : IDisplay 
{ 


private T[] items; 
private int nitems; 


public Stack() 


{ 
nitems = @; 
items = new T[5@]; 
} 
public T Pop() 
{ 

if (nitems == @) 

{ 
System.Console.WriteLine("Stack underflow") ; 
return items[Q@]; 

} 

return items[--nitems]; 

} 
public void Push(T item) 
{ 
if (items.Length == nitems) 
{ 
T[] temp = items; 
items = new T[nitems*2]; 
System.Array.Copy(temp, items, nitems); 
} 
items[nitems++] = item; 
} 
public void displayA11() 
{ 


for (int i = @; i < nitems; i++) 


d 
} 


items[i].display(); 


The J# code below consumes the C# generic class with a constraint declared above. 


// bookapp.jsl 
// compile with: /reference:idisplaystack.d1l 
public class Book implements IDisplay 








{ 
String title; 
public Book(String s) 
{ 
title = s; 
} 
public void display() 
{ 
System.out.println(title) ; 
} 
public class app 
{ 
public static void main(String [] args) 
{ 
Stack<Book> s = new Stack<Book>(); 
Book b1 = new Book("Alice in Wonderland"); 
Book b2 = new Book("The Iliad"); 
Book b3 = new Book("Paradise Lost"); 
Book b4 = new Book("Robinson Crusoe"); 
s.Push(b1); 
s.Push(b2); 
s.Push(b3); 
s.Push(b4); 
s.displayAll1(); 
} 
} 
Output 


Alice in Wonderland 
The Iliad 

Paradise Lost 
Robinson Crusoe 


Expressions 


Constructed types may participate in J# expressions where other types may be used. For example, they may be used in an 
array creation expression: 


new Vector<String>[10]; 


The type of a cast may be a parameterized type. 





Assuming the following declarations: 
class Dictionary<A, B> extends object { /* ... */ } 
class Hashtable<A, B> extends Dictionary<A, B> { /* ... */ } 


Dictionary<String, Integer> d; 


The following cast is legal, since it is a cast to the derived class with the correct type arguments: 


(Hashtable<String, Integer>) d; 


But the following is not, since it is a cast to the derived class with the wrong type arguments: 


(Hashtable<float, double>) d; 


The instanceof operator should return true for an instance of a constructed type if the constructed type matches with all its 
type arguments. 


Stack<Integer> b = new Stack<Integer>(); 


return b instanceof Stack<Integer>; // should return true 

On the other hand the following results in a compile-time error since it could never be true: 
return b instanceof Stack<String>; 

Accessibility of Constructed Types 


A constructed type is accessible when all the types that make up the constructed types are accessible. This includes the type 
arguments as well as the generic type itself. If a generic type cis public, and the type arguments T1 and T2 are public, then 
G<T1, T2> is public. If T1 or T2 is private and other is public, then c<T1, 12> is private. A constructed type is only as accessible 
as its least accessible part. 


Generic Methods 


Unlike generic types, one need not always specify the type arguments for a generic method. When a generic method is used 
without explicit type arguments, the compiler will try to deduce the correct type arguments from the arguments that were 
supplied to the method. If there is an ambiguity, the compiler will produce an error. The arguments may always be specified 
explicitly if needed or desired for clarity. Type deduction ignores implicit conversions and coercions. Type deduction may fail if 
the inferred parameters are inconsistent, for example if the first method parameter implies a different type than the second 
method parameter. Overload resolution occurs only after type deduction. 


Example 


The following example creates a printer.dll used to print a generic array. 


// printer.cs 
// compile with: /t:library 


public class Printer 


{ 
public void print<T>(T [] vals) 
af 
int lowerBound = vals.GetLowerBound(@) ; 
int upperBound = vals.GetUpperBound(@) ; 
for (int i = lowerBound; i <= upperBound; i++) 
{ 
System.Console.WriteLine(vals[i]); 
} 
} 
} 


The J# code below consumes the C# generic library declared above. 


// printerapp.jsl 
// compile with: /t:exe /reference:printer.d1l 
public class app 


{ 
public static void main(String [] args) 
{ 
int [] ai = new int [2]; 
ai[@] = 5; 
ai[1] = 6; 


Printer p = new Printer(); 
p.print(ai); 


String [] books = new String [2]; 
books[@] = "Alice in Wonderland"; 


books[1] = "The Iliad"; 
p.print(books) ; 


Output 


is) 

6 

Alice in Wonderland 
The Iliad 


Generic Delegates 


Generic delegate types defined in other .NET languages or in the .NET Framework may be used in J# code. The delegate may be 
assigned any type-compatible function in J# or another .NET language. Like other generic types, generic delegates may not be 
authored in J#. 


Example 


The following example shows the use of a generic delegate type Proc defined in C# in a J# application. 


// theDelegate.cs 
// compile with: /target:library 
public delegate void Proc<T>(T i); 


The J# code below consumes the generic delegate type defined in the C# code above. 


// delegateapp.jsl 
// compile with: /reference:theDelegate.d1l 


import java.util.Date; 


public class MyDateClass 


{ 
public void DisplayDate(int i) 
{ 
Date dt = new Date(); 
System.out.println("The date is: " + dt.getDate()); 
System.out.println("The value is: " + i); 
} 
} 
public class MyTimeClass 
{ 
public void DisplayTime(int i) 
{ 
Date dt = new Date(); 
System.out.println("The time is: " + dt.getHours() + 'h' + ' ' + dt.getMinutes() + 
"m') 5 
System.out.println("The value is: " + i); 
} 
} 


public class app 
{ 
public static void main(String [] args) 
{ 
MyDateClass d = new MyDateClass(); 
Proc<int> p1 = new Proc<int>(d.DisplayDate) ; 
p1.Invoke(5); 


MyTimeClass t = new MyTimeClass(); 
pl = new Proc<int>(t.DisplayTime) ; 
p1.Invoke(5); 





Sample Output 


The date is: 10 
The value is: 5 
The time is: 10h 48m 
The value is: 5 











See Also 

Reference 

Syntax for Targeting the .NET Framework 
Other Resources 
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Unsupported .NET Framework Features 


The following features, which may be supported by other languages targeting the .NET Framework common language runtime, 
are not supported in Visual J#: 


e Operator overloading and the .NET Framework semantics associated with operator overloading. 
e Implicit and explicit conversions between types using the op_Implicit and op_Explicit conversion operators. 
e Seamless coercion between Java-language data types and .NET Framework data types. 


e If asingle type implements two interfaces that each require the definition of a method of the same name and signature, 
Visual J# does not consider these methods distinct and needing different implementations. Visual J# only supports a 
single code body to implement all interface methods of the same name and signature. 


See Also 

Reference 

Unsupported Class Libraries and Features 
Unsupported Scenarios in Visual J# 
Other Resources 
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Walkthrough: Generating and Compiling Source Code 
Dynamically in the Java Language 
Visual J# provides a CodeDOM implementation for the Java language. The class Microsoft.VJSharp.VJSharpCodeProvider in 


the assembly VJSharpCodeProvider.dll provides methods for retrieving instances of the Visual J# implementation of the 
|CodeGenerator and I|CodeCompiler interfaces for the Java language. 





4Note 





The dialog boxes and menu commands you see might differ from those described in Help depending on your active settings 
or edition. To change your settings, choose Import and Export Settings on the Tools menu. For more information, see 
Visual Studio Settings. 











Including the Visual J# Code Provider in a Project 
To include the Visual J# code provider in a project 


e Right-click the project in Solution Explorer, point to Add Reference, and select VJSharpCodeProvider from the list of 
.NET Framework components. 


CodeDOM and the throws Clause 


CodeDOM elements can be used to model source code in a language-independent manner. The language-specific 
implementation of |CodeGenerator and ICodeCompiler can be used to generate and compile code dynamically. 


For more information about CodeDOM, see Generating and Compiling Source Code Dynamically and in Multiple Languages. 


The CodeDOM supports the common types of code elements found in common language runtime programming languages. 
However, it was not designed to provide elements to represent all possible programming language features. 


The following are ways to provide support for Visual J# specific features like the throws clause, distinguishing between 
extends and implements, and specifying a cast involving a value type. 





Note 





Other language implementations of |CodeGenerator, if passed the same CodeDOM object graph, will ignore the UserData i 
nformation that is not relevant to the language. 








The CodeDOM does not provide a way to represent the exceptions declared in the throws clause of a method. 
To represent throws clause 


1. Set a key-value pair in the CodeObject.UserData member of the CodeMemberMethod object that represents the method 
with the throws clause. 


The member is interpreted appropriately by the Visual J# implementation of ICodeGenerator. 


2. Name the key throwsCollection. Its value should be a CodeTypeReferenceCollection object that represents a collection 
of CodeTypeReference objects describing the exceptions thrown by the method. 


3. The Visual J# code generator uses throwsCollection to generate the throws clause for the method. 
For more information, see the CodeDOM Sample. 
Generating a Class Declaration 


The CodeDOM does not provide a way to represent the base class of a class separately from the base interface. By default, the 
Visual J# code generator interprets CodeTypeDeclaration.BaseTypes as follows: 


e The first type in the BaseTypes collection is the base class of the class, and corresponds to the extends clause. 


e The remaining types in the BaseTypes collection are the interfaces implemented by the class, and correspond to the 
implements clause. 


To generate a class declaration that has no explicit extends clause, the Visual J# code generator requires additional 
information. 


To distinguish between the extends and implements clauses 


1. Seta key-pair in the UserData member of the CodeTypeDeclaration object that represents the class you are generating. 
2. Name the key hasExtendsClause. Its value should be a Boolean object. 


3. The code generator interprets the value as follows: 


e If hasExtendsClause is true, the first type in the BaseTypes collection is the base class of the class, and 
corresponds to the extends clause. The remaining types in the BaseTypes collection are the interfaces 
implemented by the class by using the implements clause. 


e If hasExtendsClause is false, then all the types in the BaseTypes collection are interpreted as interfaces 
implemented by the class. 


For more information, see CodeDOM Sample. 


Casts in J# must be more explicit than in other NET languages since J# does not support automatic boxing and unboxing of 
value types. In J#, you must explicitly specify boxing by casting to the appropriate wrapper type, such as System.Int32 for int. 
Casts in J# may have to be done in more than one step, using a a double cast. For example, if you are casting from a floating 
point value to a boxed System.Int32, you first cast to int and then to System.Int32 to box the integer. The 
CodeCastExpression object in J# now allows you to specify the exact type of cast required by using its UserData member. The 
UserData member supplies two Boolean keys which may be used to specify the various types of cast available. 


To specify a cast involving a value type 


1. Set two key-pairs in the UserData member of the CodeCastExpression object that represents the cast expression you 
are generating. 


2. Name one of the keys CastlsBoxing, and the other DoubleCast. 


3. Assign Boolean objects as the value of each of these keys. The values of the Boolean variables will determine the type 
of cast generated according to the following table. 

















CastIlsBoxing DoubleCast Cast Generated 
false true (int) (System.Int32) 
true false (System.Int32) 
true true (System.Int32) (int) 
false false (int) 














The actual types will be as specified in the CodeCastExpression object's TargetType property. The types int and 
System.Int32 are used for illustrative purposes only. 


See Also 
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Documentation Comments in Visual J# 


This section discusses documentation comment support in the Visual J# development environment. 


In This Section 
Support for Documentation Comments in the Visual J# Code Editor 


Describes features in the Code Editor that support documentation comments, in the comment-style traditionally known as 
Javadoc comments for Java-language source code. 


XML Documentation Equivalents for Javadoc Comments 


Describes the Build Comment Web Pages menu item, which can be used to generate documentation from your source 
files. 


How to: Generate XML Documentation from Javadoc Comments 


Describes how to generate the .NET Framework standard documentation comment format from Javadoc comments. 


Related Sections 
Language Support 


Provides reference information about Visual J++® 6.0 and .NET Framework features that are and are not supported in Visual 
J#. 
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Support for Documentation Comments in the Visual J# Code 
Editor 


Visual J# has support for documentation comments in the comment style traditionally known as Javadoc comments for Java- 
language source code. 


Autocompletion of Documentation Comments 


In the Visual J# Code Editor, when you type the opening characters /** of a Javadoc comment, the editor automatically inserts 
the closing characters for the comment, */, on the following line. 


Autocompletion for Tags in Javadoc Comments 


Both Javadoc tags and Microsoft extensions directives in Visual J++ 6.0 begin with the @ character inside Javadoc comments. 
In Visual J#, if you type the @ character inside a Javadoc comment, you get an autocomplete list that includes both supported 
Javadoc tags as well as supported Microsoft extensions directives. 


IntelliSense Inside Javadoc Comments 


Visual J# programs make extensive use of the attribute declaration syntax, which is in the Javadoc comment style. In a Javadoc 
comment, when you type @attribute, the Intellisense drop-down list is displayed, populated with the accessible list of classes. 


See Also 
Other Resources 
Documentation Comments in Visual J# 


How to: Generate XML Documentation from Javadoc 
Comments 


Explains how to convert the comments in a file or project from the Java-language comment style to the .NET standard 
comment style. 





Note 








The dialog boxes and menu commands you see might differ from those described in Help depending on your active settings 
or edition. To change your settings, choose Import and Export Settings on the Tools menu. For more information, see 
Visual Studio Settings. 








To generate XML comments from Javadoc comments 


1. 
2. 
3. 
4. 


Right-click the project node in a Visual J# project that has Javadoc comments. 
On the shortcut menu, click Properties. 
Click Build on the left of the Project Settings window to open the Build pane. 


Select the XML Documentation File check box. 


. Type the name of the XML documentation file in the text box. 
. Close the Project Settings window. 


. On the Build menu, click Build Solution, or Build <projectname>. The XML documentation file is built for this project 


based on Javadoc comments in the file. 


See Also 
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XML Documentation Equivalents for Javadoc Comments 


XML documentation may be generated from Javadoc comments. This topic shows the XML documentation equivalents to 


Javadoc comments. 


Remarks 


The following table shows the XML documentation equivalents to Javadoc: 





Javadoc comment tag 


XML documentation equivalent 





None 


<remarks> or <summary> 





@author name 


<author> name </author> 





@deprecated description 


@exception exception-class text 


@param paramname text 


@return text 


@see typename 


@see typename#member 


@value property-description 


@version text 


Note 





<obsolete> description </obsolete> 

<exception cref="exception-class" > text</exception> 
<param name=paramname> text </param> 
<returns>text</returns> 

<seealso cref="typename"/> 

<seealso cref="typename.member'/> 

<value> property-description </value> 


<version> text </version> 





The @value tag is Visual J#-specific. 








Note 





r constructor. 





See Also 
Tasks 


A comment that contains no tags is converted to a <remarks> tag if it is a type, or a <summary> tag if it is a method, field, o 


How to: Generate XML Documentation from Javadoc Comments 








Visual J# Exception Support 


This section includes information about the J# exception hierarchy, as specified in the JDK specification, and the .NET 
Framework exception hierarchy, and their relationship to each other. 


In This Section 
Visual J# Exception Hierarchies 


Describes Visual J# and .NET Framework exception hierarchies, and their relation to each other. 
Visual J# Exception Handling for the Debugger 

Explains setting exception handling for the debugger and provides background on why exception handling needs to be set. 
Visual J# Exceptions 


Lists the J# exceptions that have .NET Framework equivalents, along with the .NET Framework equivalents. 


See Also 
Other Resources 


Debugging in Visual Studio 
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Visual J# Exception Hierarchies 


Visual J# generates two types of error messages: Java-language and .NET Framework exceptions. 
e Java-language exceptions are derived from java.lang.Throwable. These fall into two categories: 


Excep |Description 
tion 





Check |If a method results in a checked exception being thrown, the compiler issues an error unless the code that calls th 
ed e method has a try-catch block to catch the checked exception. 


Runti |Derived from java.lang.RuntimeException. The compiler does not enforce any such catching by the calling cod 
me ee. 














e .NET Framework exceptions, which are derived from Exception. These exceptions do not have the previously mentioned 
type of categorization. 


Many of the Java-language runtime exceptions have semantic equivalents in the .NET Framework; for example, 
java.lang.NullPointerException is similar to NullReferenceException. See Visual J# Exceptions for a table that maps Java- 
language runtime exceptions to their .NET Framework counterparts. 


When you catch a Java-language runtime exception in your source code, the Visual J# compiler ensures that the resulting 
executable code catches its NET Framework equivalent as well. For example: 


try 

{ 
methodWithNullReference() ; 

} 

catch (java.lang.NullPointerException e) 

uf 
// Catches both java.lang.NullPointerException 
// and System.NullReferenceException. 
e.printStackTrace(); 

} 


There are two possible ways a null reference exception could originate in this example: 
e Itis explicitly thrown in methodWithNullReference as a NullPointerException. 
-or- 
e It actually arises at run time as a NET Framework NullReferenceException. 


The catch (java.lang.NullPointerException e) clause catches both NullPointerException and 
NullReferenceException. 


You can concentrate on Java language-specific exceptions and can generally ignore the .NET Framework exceptions that have 
Java-language equivalents. However, the catch clause should specify.NET Framework exceptions that do not have Java- 
language equivalents, which is the case if the exception does not show in the table in Visual J# Exceptions. 


Changes in Exception Mapping 


Visual J# 2005 introduces a change in the exception mapping behavior. In the past, it was not possible to include catch all 
exceptions ina single catch clause, as is normally possible in the Java language by catching java.lang.Throwable. In 
previous versions, .NET Framework exceptions would not be caught by a catch clause catching java.lang.Throwable. 
Changes have been made in the Visual J# compiler so that it is possible to catch all exceptions using a single catch clause 
catching java.lang.Throwable. It is still possible to catch .NET Framework exceptions in a separate catch clause if that is the 
preferred behavior. 


The following examples show various possible sets of catch clauses and the behavior of each. If, in addition to catching 
java.lang.Throwable, explicit catch clauses are included catching various .NET Framework exceptions, the behavior depends 
on whether the exception is mapped or unmapped, as defined in the previous section. Mapped exceptions will be caught by the 
java.lang.Throwable catch clause; unmapped exceptions will still be caught by the specific catch clause for that unmapped 


exception. 
Example 1 


// Example 1: Throwable catches all exceptions. 
try 


{ 
If ees 


catch (Throwable t) 
{ 


} 


se 


The above catch statement now catches all exceptions. The following code shows the J# equivalent of the intermediate 
language code generated: 


try 


{ 
oe 


catch (System.Exception ex) 
{ 
// The original runtime filter is replaced with this 
// catch clause. 
Throwable t = Throwable.wrapException(ex) ; 
if (t == null) rethrow; 
ore 


catch (Throwable t) 
{ 


} 


Tf aie 


Example 2 


To get the entire stack frame, you need to unwrap the inner exception by calling get_InnerException(), and then 
get_StackTrace() on the unwrapped inner exception. 


// Example 2: Explicitly catching .NET Framework exceptions still works 
// but we get more details with the get _StackTrace() method. 
try 


{ 
IP se; 


catch (Throwable t) 


{ 
System.out.printin(t.get_InnerException().get_StackTrace()); 


catch (System.Exception except) 


[fates 


In the previous case, if a catch clause explicitly catching Exception exists, java.lang.Throwable only catches Java-language 
exceptions. No mapping is done. 


Example 3 


// Example 3: Catching an unmapped .NET exception subclass. 
try 


{ 
If as 


catch (Throwable t) 
{ 


I firsces 


} 
catch (ExceptionUnmapped except) 
{ 
Th eas 
} 


As previously, any exceptions matching ExceptionUnmapped will still be caught by the Except ionUnmapped catch clause, not the 
java.lang.Throwable clause. The following code shows the result of the mapping: 


try 

{ 
Pils isha 

catch (ExceptionUnmapped except) 

{ 
// oes 

} 

catch (System.Exception ex) 

{ 
// Note the change in order of the catch clauses 
// so that binary behavior is maintained. 
Throwable t = Throwable.wrapException(ex) ; 
if (t == null) 
{ 

rethrow; 

} 

catch (Throwable t) 

{ 
ee 

} 

Example 4 


// Example 4: Catching a mapped .NET Framework Exception subclass. 


try 
{ 
// os 
catch (Throwable t) 
{ 
Th sacs 
catch (ExceptionMapped except) 
{ 
ee 
} 


In the previous case, mapped exceptions are caught by the java.lang.Throwable clause and the compiler issues an error 
saying that the catch clause is unreachable. 


As far as the debugger is concerned, java.lang.Throwable and Exception are still two different classes of exceptions. For 
example, you may need to set the default debugger behavior for each of these two groups of exceptions separately. 


See Also 
Other Resources 
Language Support 
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Visual J# Exception Handling for the Debugger 


This topic explains setting exception handling for the debugger and provides background on why exception handling needs to 
be set. 





Note 





See Visual J# Exceptions to examine a list of INET Framework exception equivalents. 











Setting Exception Handling in the Development Environment 


The Exceptions dialog box, under Common Language Runtime Exceptions, includes the category Java Language 
Exceptions. Some exceptions under this category have equivalents in the NET Framework. This means that when you change 
the handling for a Java-language exception, you must also change the handling for the equivalent INET Framework exception 
to get the same behavior as per Java-language exception semantics. This is because an exception thrown at run time can 
originate either from the class libraries included with Visual J#, or it can originate from the underlying NET Framework 
common language runtime layer. 


Why Exception Handling Needs To Be Set 


If any exception-handling code exists, the Visual J# compiler emits the appropriate instructions to map the .NET Framework 
exceptions to the corresponding class library exceptions. The exception handler code is executed for both the Visual J# 
exception, and the corresponding .NET Framework exception is thrown. However, the debugger is not aware of this mapping. 
Hence, if you want to break on an uncaught exception, or when an exception is raised, you must change the handling for both 
the class library and the corresponding .NET Framework exceptions. 


Example 


To illustrate, look at the following code in Visual J#: 


public void caller() 


// Handler for Visual J# exception: 


try { 
stringize(null); // Will result in an exception at runtime: 


} catch (java.lang.NullPointerException nullEx) { 
// Compiler emits code 
// to catch System.NullReferenceException also. 
nullEx.printStackTrace(); 


} 


public String stringize(Object o) { 
// Invokes method without checking for null. 
// Results in a System.NullReferenceException at run time. 
return o.toString(); 


When the stringize method is called at run time with a null parameter, it will result in a NullReferenceException . However, the 
compiler emits the code to handle both java.lang.NullPointerException as well as NullReferenceException . Hence, the 
user code is able to catch the exception in a transparent manner. 


While debugging with Visual Studio, if you want to change the handling for exception on null value passed into the stringize 
method, just changing it for java.lang.NullPointerException is not sufficient. The debugger will encounter 
NullReferenceException at run time; therefore, the handling should be changed for this exception too. 


You need to change the handling for both exceptions, because if the stringize method is in another class, it could also explicitly 
throw java.lang.NullPointerException. To take care of both possibilities, you need to set handling of both exceptions 
together. 


See Also 

Reference 

Visual J# Exception Hierarchies 
Concepts 

Conditional Debugging Support 
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Visual J# Exceptions 


Visual J# application developers must use the following two hierarchies of exceptions: 
e Java-language exceptions, which are derived from java.lang.Throwable. These exceptions fall into two categories: 
e Checked exceptions 


If a method results in a checked exception being thrown, the compiler issues an error, unless the code that calls 
the method has a try-catch block to catch the checked exception. 


e Run-time exceptions 
Derived from java.lang.RuntimeException. The compiler does not enforce any catching by the calling code. 


e@ .NET Framework exceptions, which are derived from Exception. 


Many of the Java-language run-time exceptions have semantic equivalents in the NET Framework. For example, 
java.lang.NullPointerException is similar to NullReferenceException. 


When you catch a Java-language run-time exception in your source code, the Visual J# compiler ensures that the resulting 
executable code catches its INET Framework equivalent as well. 


Handled run-time exceptions display in both the debugger and the error console as J# exceptions (as specified in the JDK 1.1. 


4 specification); unhandled run-time exceptions display in the debugger as .NET exceptions and in the error console as J# exc 
eptions. 





Java-language exceptions and their .NET Framework equivalents are listed in the following table. 





Java-language exception -NET Framework exception 





jjava.lang.ArithmeticException ArithmeticException, DivideByZeroException, OverflowException 
See the following topics for more information: 
e@ Troubleshooting Exceptions: System.DivideByZeroException 


e Troubleshooting Exceptions: System.OverflowException 





java.lang.ArrayIndexOutOfBoundsExceptio |indexOutOfRangeException 








. See Troubleshooting Exceptions: System.IndexOutOfRangeException. 
jjava.lang.ArrayStoreException ArrayTypeMismatchException 

See Troubleshooting Exceptions: System.ArrayTypeMismatchException. 
Java.lang.ClassCastException See Troubleshooting Exceptions: System.|InvalidCastException. 
|java.lang.IIlegalAccessError FieldAccessException, MethodAccessException 


See the following topics for more information: 
e Troubleshooting Exceptions: System.FieldAccessException 


e Troubleshooting Exceptions: System.MethodAccessException 














jjava.lang.IIlegalArgumentException 


|java.lang.IncompatibleClassChangeError 


ArgumentException, ArgumentNullException, 


ArgumentOutOfRangeException, 


RankException 


See the following topics for more information: 


e Troubleshooting Exceptions: System.ArgumentNullException 


e Troubleshooting Exceptions: System.RankException. 


MissingMemberException 


See Troubleshooting Exceptions: 


System.MissingMemberException. 





|java.lang.NoSuchFieldError 


See Troubleshooting Exceptions: 


System.MissingFieldException. 





|java.lang-NoSuchMethodError 


|java.lang.NumberFormatException 


jjava.lang-OutOfMemoryError 


|java.lang.SecurityException 


java.lang.StackOverflowError 


jjava.lang.VerifyError 





See Also 

Reference 

Visual J# Exception Hierarchies 

Visual J# Exception Handling for the Debugger 





See Troubleshooting Exceptions: 


See Troubleshooting Exceptions: 


See Troubleshooting Exceptions: 


See Troubleshooting Exceptions: 


See Troubleshooting Exceptions: 


See Troubleshooting Exceptions: 


System.MissingMethodException 


System.FormatException. 


System.OutOfMemoryException 


System.Security.SecurityException. 


System.StackOverflowException. 


System.Security.VerificationException. 
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Class Library Support 


Visual J# provides an independently developed set of class libraries designed to provide the functionality equivalent to most 
JDK level 1.1.4 class libraries and includes classes specified in the College Board's Advanced Placement curriculum for 
Computer Science. Visual J# also supports Microsoft® extensions shipped with Microsoft Visual J++® 6.0, including Windows 
Foundation Classes (WFC) and many other com.ms.* class libraries. 


This section lists the supported and unsupported packages in Visual J#, as well as implementation-specific details for the class 
library support. 


In This Section 
Supported Class Libraries 


Lists the set of class libraries available in Visual J#. 
Unsupported Class Libraries and Features 

Lists the unsupported class libraries and APIs in Visual J#. 
Additional Class Library Support 

Provides a list of classes and interfaces that implement functionality equivalent to JDK 1.2 level. 
Methods in java.lang.Class Class 

Provides details on the Class.FromType and Class.ToType methods in java.lang.Class. 
Methods in com.ms.wfc.app.Locale Class 

Lists deprecated methods of the com.mswfc.app.Locale class and their replacements. 
Methods in com.ms.vjsharp.text.FormatDefaults Class 

Documents the com.ms.vjsharp.text.FormatDefaults method supported by Visual J#. 
Inner Exceptions 

Describes the behavior of J# Exception classes. 
Compatibility Issues with Visual J++ 6.0 


Provides details on compatibility issues between Visual J# and Visual J++ 6.0 for various Java-language and JDK level 1.1.4 
packages. 


Supplemental UI Library 


Describes how you can use the Supplemental UI Library to develop any kind of application with a Microsoft Windows look 
and feel. 


Thread Death Compatibility Class Warning 


Describes the difference in thread behavior between J++ and J#. 


Related Sections 
Reference 


Reference topics on the Visual J# compiler, the Binary Converter Tool JbIlmp.exe), language and library support, upgrading 
from Visual J++ 6.0 projects, Visual J# syntax for NET Framework class library, and development-environment features. 


Language Support 


Provides reference information on Visual J++ 6.0 and .NET Framework language features that are and are not supported in 
Visual J#. 
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Supported Class Libraries 


Visual J# is designed to provide class library support functionally equivalent to most of the JDK level 1.1.4 packages that were 
included in Visual J++ 6.0. Some classes support functionality equivalent to that of JDK level 1.2. For more information, see 
Additional Class Library Support. 


Visual J# provides support for developing applications with a Microsoft Windows look and feel. The pertinent classes are in the 
com.ms.vjsharp.swing.plaf.windows package. For more information, see Supplemental UI Library. 


Visual J# also provides classes specified in the College Board's Advanced Placement curriculum for Computer Science as well 
as classes that support the Windows Foundation Classes (WFC) libraries and many of the following com.ms.* packages: 


e com.ms.lang 

e com.ms.dll 

e com.ms.com 

@ com.ms.win32 

e com.ms.util 

e com.ms.jdbc.odbc 

e com.ms.vjsharp.swing.plaf.windows 


See Also 

Reference 

Unsupported Class Libraries and Features 
Concepts 

Visual J# Class Library 

Other Resources 

Class Library Support 
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Unsupported Class Libraries and Features 


The following features are not supported in Visual J#: 


e Remote Method Invocation (RMI), Java Native Interface (JNI), and Raw Native Interface (RNI) technologies. 


e Loading classes from bytecode (.class files). However, there is support to load classes from Microsoft intermediate 
language (MSIL) assemblies. 


e The CLASSPATH variable. An alternate mechanism is provided to locate and load classes and resources at run time. For 
more information, see No Support for CLASSPATH Variable. 


The following class libraries and APIs are not available in Visual J#: 


e com.ms.* packages other than the ones listed under Supported Class Libraries. The Visual J# documentation provides 
upgrade prescriptions for many of these unsupported packages. For more information, see 
Upgrading from Visual J++ 6.0. 


e sun.* and netscape.*, and other packages that were not part of the JDK level 1.1.4 class libraries that shipped in Visual 
J++ 6.0. 


e There is no support for the profiler, heap monitoring, and debug APIs that were provided in Visual J++ 6.0. Alternate APIs 
available as part of the .NET Framework libraries should be used instead. For more information, see 
Debugging and Profiling Applications. 


See Also 

Reference 

Unsupported .NET Framework Features 
Unsupported Scenarios in Visual J# 
Supported Class Libraries 

Other Resources 

Class Library Support 
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Additional Class Library Support 


A subset of the vjslib.dll classes and interfaces have been changed to support functionality equivalent to JDK 1.2 level classes. 
All classes in java.util implement functionality equivalent to JDK 1.2 level classes. 


JDK 1.2 Functionality 


The following classes and interfaces also implement functionality equivalent to JDK 1.2 level: 









































Package Class or Interface 
|java.io File 

|java.io FileFilter 
jjava.lang Byte 

jjava.lang Character 
jjava.lang Double 
jjava.lang Float 

jjava.lang Integer 
jjava.lang Long 

jjava.lang Math 

jjava.lang Short 

jjava.lang StringBuffer 
jjava.math BigDecimal 
jjava.math BigInteger 
java.net HttpURLConnection 
jjava.text CollationKey 
java.util everything 











Details of the changes: 
@ compareTo methods have been added to File, BigInteger, BigDecimal, Date and CollationKey classes. 
e java.lang.Character now contains inner classes defining Unicode subsets. 
@ java.io.File has 17 new functions 
e HttpURLConnection has 2 new functions 


e Classes in java.util now fully support functionality equivalent to JDK 1.2 level. 





The listed Java 1.2 classes are enabled for native 64-bit execution by using Visual J#. Install Microsoft Visual J#® 2.0 Re 
distributable Package — Second Edition. 





See Also 
Other Resources 


Class Library Support 
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Methods in java.lang.Class Class 


Visual J# supports the following methods in the java.lang.Class class: 


e To convert an instance of the INET Framework Type class to an equivalent instance of the java.lang.Class class: 


public static java.lang.Class Class.FromType(System. Type) 


e To convert an instance of a java.lang.Class class to an equivalent instance of the .NET Framework Type class: 


public static System.Type Class.ToType(java.lang.Class) 


e To return an instance of the .NET Framework Type class that is being encapsulated by the instance of the 
java.lang.Class class on which the method is being called: 


public System.Type Class.ToType() 


See Also 
Other Resources 
Class Library Support 
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Methods in com.ms.vjsharp.text.FormatDefaults Class 


Visual J# supports the following methods in the com.ms.vjsharp.text.FormatDefaults class: 


e To set the default date/time pattern for a given format style and locale, use the following method. The default pattern will 
then be used when DateFormat.getDateTimelnstance is called. 


public static final com.ms.vjsharp.text.FormatDefaults.set(Locale locale, int formatSt 
yle, String datePattern, String timePattern) 


e To set the default region to be used when the region is unspecified by a call to set the locale, use the following method. 
For example, if java.lang.Locale is created by passing an empty string for the country, as in new 


java.lang.Locale("en", ""). 


public static final com.ms.vjsharp.text.FormatDefaults.setDefaultRegion(String langNam 
e, String defRegion) 


The langName parameter is a two-letter language code. The defRegion parameter is a two-letter country code. 


See Also 
Other Resources 
Class Library Support 
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Methods in com.ms.wfc.app.Locale Class 


The following table shows methods of the com.ms.wfc.app.Locale class that have been deprecated and the new methods 
that should be used instead. Use these methods when upgrading from Visual J++ to Visual J#, or when writing new 


applications using this class. 
Deprecated method 


com.ms.wfc.app.Locale.getCountryCode 


com.ms.wfc.app.Locale.getCountry 


com.ms.wfc.app.Locale.getAbbrevCountry 


com.ms.wfc.app.Locale.getNativeCountry 


Replacement method 


com.ms.wfc.app.Locale.getCountryRegionCode 


com.ms.wfc.app.Locale.getCountryRegion 


com.ms.wfc.app.Locale.getAbbrevCountryRegion 


com.ms.wfc.app.Locale.getNativeCountryRegion 





com.ms.wfc.app.Locale.getDefaultCountry 


com.ms.wfc.app.Locale.getDefaultCountryRegion 





com.ms.wfc.app.Locale.getEnglishCountry 


com.ms.wfc.app.Locale.getEnglishCountryRegion 





com.ms.wfc.app.Locale.getISO3116CountryName 





com.ms.wfc.app.Locale.getISO3116CountryRegionName 





The newly introduced methods have the same signatures as the deprecated methods they replace and offer similar 


functionality. 


See Also 
Other Resources 
Class Library Support 





Inner Exceptions 


J# exception classes provide constructors that allow the original exception to be saved when a new exception is thrown in place 
of another exception. 


java.lang.Throwable(String message, System.Exception innerException) ; 
java.lang.Exception(String message, System.Exception innerException) ; 
java.lang.Error(String message, System.Exception innerException) ; 
java.lang.RuntimeException(String message, System.Exception innerException) ; 


Parameters 
message 


Text describing the nature of the problem for use in error messages. 
innerException 

The original .NET Framework exception preserved when rethrowing a .NET Framework exception as a Java exception. 
Remarks 


In the .NET Framework, System.Exception is the root of the exception hierarchy. This exception type supports the concept of 
inner exceptions. Inner exceptions are useful when there is a need to handle an exception in a catch block and throw a new 
exception. If the callers up the stack that catch the new exception are interested in knowing why the exception was thrown, they 
may get the original exception by querying the InnerException property. Visual J# supplies additional overloads of the 
exception constructors that take an additional parameter, innerException, which is the original exception. The inner exception 
can be obtained by calling get_InnerException(). 


Example 


// innerexcept1.jsl 

// This example shows a class that wraps a FileNotFoundException in its 
// own exception class. The original exception can be recovered using 
// the get_InnerException method on the System.Exception class. 

import System.*; 

import java.io.*; 

import System.Collections.*; 


class ConstructionException extends System.Exception 


{ 


public ConstructionException(String message, System.Exception innerException) 


{ 
} 


super(message, innerException) ; 


‘ 


class DataStructure 


{ 
ArrayList m_List; 
public DataStructure() 
{ 


} 


public void Add(int c) 
{ 


} 


m_List = new ArrayList(); 


m_List.Add( (System.Object) (Int32)c); 


public static DataStructure ConstructFromFile(String filename) throws ConstructionExcep 
tion 
{ 
DataStructure ds = new DataStructure(); 
try 


int c; 
// Could throw FileNotFoundException. 
FileReader reader = new FileReader(filename) ; 


// Could throw IOException. 


while ((c = reader.read()) != -1) 
{ 
ds.Add(c); 

} 
} 
catch (IOException e) 
{ 

Console.WriteLine( e.get_Message() ); 

throw new ConstructionException("Error creating the data structure.", e); 
} 


return ds; 


class CMain 


{ 
public static void main() 
1 
try 
{ 
// Assume myfile.dat doesn't exist. 
DataStructure.ConstructFromFile("myfile.dat") ; 
} 
catch(System.Exception e) 
if 
Console.WriteLine("Exception occurred: " + e.get_Message()); 
System.Exception innerEx = e.get_InnerException(); 
if (innerEx != null) 
Console.WriteLine("Cause: " + innerEx.get_Message() ); 
} 
} 
} 


This example shows how to extract the inner exception in a catch clause that catches java.lang.Throwable. Because 
java.lang.Throwable is wrapped in an extra exception layer in order to support catching all exceptions, it is necessary to 
invoke get_InnerException twice. For more information, see Visual J# Exception Hierarchies. 


// innerexcept2.jsl 
import System.*; 
import java.io.*; 


import System.Collections.*; 


class ConstructionException extends System.Exception 


{ 
public ConstructionException(String message, System.Exception innerException) 
1 
super(message, innerException) ; 
} 
} 


class DataStructure 


{ 
ArrayList m_List; 
public DataStructure() 
if 


m_List = new ArrayList(); 


} 


public void Add(int c) 
{ 


} 


m_List.Add( (System.Object) (Int32)c); 


public static DataStructure ConstructFromFile(String filename) throws ConstructionExcep 


tion 
{ 
DataStructure ds = new DataStructure(); 
try 
{ 
int c; 
// Could throw FileNotFoundException. 
FileReader reader = new FileReader(filename) ; 
// Could throw IOException. 
while ((c = reader.read()) != -1) 
{ 
ds.Add(c); 
} 
} 
catch (IOException e) 
{ 
Console.WriteLine( e.get_Message() ); 
throw new ConstructionException("Error creating the data structure.", e); 
} 
return ds; 
} 
} 


class CMain 


{ 
public static void main() 
{ 
try 
{ 
// Assume myfile.dat does not exist. 
DataStructure.ConstructFromFile("myfile.dat") ; 
} 
catch(java.lang.Throwable t) 
{ 
// Get the exception out of the Throwable wrapper. 
System.Exception e = ((System.Exception) t).get_InnerException() ; 
Console.WriteLine("Exception occurred: " + e.get_Message()); 
// Get the true inner exception. 
System.Exception innerEx = e.get_InnerException(); 
if (innerEx != null) 
Console.WriteLine("Cause: " + innerEx.get_Message() ); 
} 
} 
} 


Sample Output 


Could not find file 'file-name’. 
Exception occurred: Error creating the data structure. 
Cause: Could not find file 'file-name'. 


Sample Output 


Could not find file 'file-name'. 


Exception occurred: Error creating the data structure. 
Cause: Could not find file 'file-name'. 
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Compatibility Issues with Visual J++ 6.0 


This section contains compatibility information for Visual J# and Visual J++ 6.0 related to class library support: 
@ Protocols Supported in java.net Package 
e Unsupported Types in the com.ms.com Package 


See Also 
Other Resources 
Class Library Support 
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Protocols Supported in java.net Package 


Visual J# only supports the FTP, HTTP, and file protocols. There is no support for SMTP, NNTP, and MailTo protocols. 


See Also 
Reference 


Compatibility Issues with Visual J++ 6.0 
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Unsupported Types in the com.ms.com Package 


The following classes and interfaces in com.ms.com package are not supported: 
® com.ms.com.LicenseMgr 
@ com.ms.com.LICINFO 
e com.ms.com.StdCOMClassObject 


See Also 
Reference 


Compatibility Issues with Visual J++ 6.0 
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Supplemental UI Library 


Using the Supplemental UI Library (VJSSupUILib.dll) included with Visual J#, you can develop any kind of application, including 
applets, with a Microsoft Windows look and feel. 


The components supported in the Supplemental UI Library for Visual J# (VJSSupUILib.dll) include: 






































JApplet 

JButton 

JCheckBox 

JCheckBoxMenultem JList JRootPane JToggleButton 
JColorChooser JMenu JScrollBar JToolBar 
JComboBox JMenuBar JScrollPane JToolTip 
JComponent JMenultem JSeparator JTree 
JDesktopPane JOptionPane JSlider JViewport 
JDialog JPanel JSplitPane JWindow 
JFileChooser JPasswordField JTabbedPane 

JFrame JPopupMenu JTable 

Remarks 


The Microsoft Supplemental UI Library for Visual J# provides much of the functionality described in the Java 2 JFC Swing 
specification. This product has been independently developed by Microsoft, and is not endorsed or approved by Sun 
Microsystems, Inc. Applications written to target the Microsoft Supplemental UI Library for Visual J# 2005 will only run on the 
Microsoft Visual J# Redistributable Package version 2.0. 


The classes related to the Windows look and feel are in the com.ms.vjsharp.swing.plaf.windows package. 


See Also 

Reference 

Supported Class Libraries 

Unsupported Class Libraries and Features 
Add Reference Dialog Box 
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Thread Death Compatibility Class Warning 


Exceptions or errors in J+ + code (MSJVM) kill the thread if they go unhandled on child threads, and kill the process if they 
happen on a main thread. Applications developed in J++ may have used this behavior in different ways. The .NET Framework's 
common language runtime (CLR) introduced a breaking change in unhandled exception policy that leads to the termination of 
a process if an exception on any thread goes unhandled. java.lang.ThreadDeath is the most commonly used specialization of 
Throwable that is used by the java.lang.Thread.stop()method to notify applications when a thread is stopped. 


See Also 
Other Resources 
Class Library Support 
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Security Semantics for Applications Written in Visual J# 


In releases before Visual J# 2005, all applications or components written using Visual J# had to be fully trusted to be able to 
run. In Visual J# 2005, this restriction is relaxed for code that uses the Visual J# library (vjslib.dll). The change in behavior is due 
to the fact that in Visual J# 2005, the vjslib.dll assembly is marked with the AllowPartiallyTrustedCallersAttribute attribute. 
Visual J# applications can now execute within the scope of .NET partial trust semantics. Specifically, the following scenarios are 
now possible: 


e Visual J# applications will now execute properly when run off a network share. 
e Windows Forms controls embedded in a web page may use the Visual J# Class Library. 


e Visual J# code may be executed in an environment where a host application supports the execution of partially trusted 
code. 


Code that uses other libraries, such as com.ms.wfc (vjswfc.dll) and com.ms.wfc.html (vjswfchtml.dll), still require full trust in 
order to run. If such an application or component runs in a code group that has not been granted the FullTrust named 
permission set by the security policy, a security exception is thrown. This applies to existing Visual J++ applications using 
com.ms.com, com.ms.dll, com.ms.lang, com.ms.wfc or com.ms.wfc.html upgraded to Visual J#. 


Therefore, consider the following when writing applications using Visual J#: 


e All applications run from the local machine in the MyComputer code group are granted the FullTrust permission set 
under the default security policy of the NET Framework. Thus, applications run from the local machine cause no issues. 


Applications run from remote locations (such as a network share) in the Internet or Intranet code groups. As applications 
run in these code groups are not granted the FullTrust permission set under .NET Framework default security policy, they 
may fail with a security exception if they use the Visual J++ libraries. 


A potential workaround is to make applications or components run from remote locations fully trusted. In order to be 
considered fully trusted by the INET Framework security policy, one of the following must be true: 


@ The component or application has been signed with a key pair, and the INET Framework security policy on the 
computer has been modified to grant the FullTrust named permission set to all components or applications 
signed with this key pair. 


e The component or application has been signed with an Authenticode certificate, and the .NET Framework security 
policy on the computer has been modified to grant the FullTrust named permission set to all components or 
applications signed with this Authenticode certificate. 


e@ The .NET Framework security policy on the computer has been modified to grant the FullTrust named permission 
set to controls downloaded from the Web site (URL) where the component or application is hosted. 
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Visual J# Upgrading Reference 


This section provides help topics for issues detected by the Upgrade Wizard during upgrade of projects from Visual J++ 6.0 to 
Visual J#. 


The topics in this section relate to issues identified while upgrading your project from Visual J++ 6.0 to Visual J#. These topics 
are intended to be accessed from links in the upgrade report, which is generated during the upgrade process. 


See Also 

Reference 

Visual J# Upgrade Wizard 

Visual J# Upgrade Report 

Visual J# Binary Converter Tool (for Java-Language Bytecode to MSIL Conversions) 
Other Resources 


Upgrading from Visual J++ 6.0 


Interface java.io.Externalizable Has a Compatibility Issue 


Objects serialized under Visual J++ 6.0 can be deserialized in Visual J# only if the fields of the objects are primitive types or 
java.lang.String. An object referencing any of the other classes in the JDK level 1.1.4 packages cannot be deserialized. Of 


course, any object serialized using Visual J# can be deserialized in Visual J#, irrespective of the above limitation. 
See Also 
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Interface java.io.Serializable Has a Compatibility Issue 
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Interface java.io.Serializable Has a Compatibility Issue 


Objects serialized under Visual J++ 6.0 can be deserialized in Visual J# only if the fields of the objects are primitive types or 
java.lang.String. An object referencing any of the other classes in the JDK level 1.1.4 packages cannot be deserialized. Of 


course, any object serialized using Visual J# can be deserialized in Visual J#, irrespective of the above limitation. 
See Also 
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Methods in java.lang.Class Have Compatibility Issues 


The following methods in java.lang.Class have compatibility issues between Visual J++ 6.0 and Visual J#: 
java.lang.Class.forName(String className ) 


This method does not use the CLASSPATH environment variable to locate classes. It follows common language runtime 
semantics for locating and loading the assemblies containing the corresponding types. For more information, see 
Upgrading Applications That Dynamically Load Classes. 


java.lang.Class.getDeclaredMethods 


The order of items returned by this method is not the same as in Visual J++ 6.0. Applications that depend on the order of 
items returned by this method may need to be appropriately modified. 


java.lang.Class.getMethods 


The order of items returned by this method is not the same as in Visual J++ 6.0. Applications that depend on the order of 
items returned by this method may need to be appropriately modified. 


java.lang.Class.getFields 


The order of items returned by this method is not the same as in Visual J++ 6.0. Applications that depend on the order of 
items returned by this method may need to be appropriately modified. 


See Also 

Reference 

Compatibility Issue in java.lang.ClassLoader 
Upgrading Applications That Dynamically Load Classes 
Compatibility Issues with Visual J++ 6.0 
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Compatibility Issue in java.lang.ClassLoader 


There is no ClassLoader support for converting bytecodes into a Class object. In Visual J#, the following methods are no 
longer supported: 


e ClassLoader.defineClass 
e ClassLoader.resolveClass 
These methods throw com.ms.vjsharp.MethodNotSupportedException in Visual J#. 


For more information, see Upgrading Applications That Use Custom Classloaders. 
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Class java.lang.Compiler Is Not Supported 


Visual J# does not support the class java.lang.Compiler. 


See Also 
Reference 


Compatibility Issues with Visual J++ 6.0 
Upgrading Applications That Use the Visual J++ 6.0 Security Semantics 
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Class java.text.CollationElementliterator Is Not Supported 


Visual J# does not support the class java.text.CollationElementiterator. 
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Some Methods in java.text.RuleBasedCollator Are Not 
Supported 


The constructor RuleBasedCollator(String) in this class is not supported. 
The following methods in this class are also not supported: 
e RuleBasedCollator.getRules 


e RuleBasedCollator.getCollationElementiterator 
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Some Methods in java.lang.Runtime Have Compatibility Issues 


The following methods have compatibility issues with Visual J++ 6.0: 
e java.lang.Runtime.freeMemory 


Visual J# returns the number of bytes of available free memory, whereas Visual J++ 6.0 returns the number of kilobytes 
of available free memory. Visual J# behavior is in accordance with Java Class Libraries Specifications. 


e java.lang.Runtime.totalMemory 


Visual J# returns the number of bytes of available total memory, where as Visual J++ 6.0 returns the number of kilobytes 
of available total memory. Visual J# behavior is in accordance with Java Class Libraries Specifications. 


e java.lang.Runtime.load 

The following methods are not supported in Visual J#: 
e java.lang.Runtime.tracelnstructions 
e java.lang.Runtime.traceMethodCalls 


These methods throw com.ms.vjsharp.MethodNotSupportedException in Visual J#. 


See Also 
Reference 
Compatibility Issues with Visual J++ 6.0 
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Class java.lang.SecurityManager Has Compatibility Issues 


The methods in this class that deal with the CallStack are not supported in Visual J#. These methods include: 
e classDepth 
e classLoaderDepth 
e currentClassLoader 
e currentLoadedClass 
e getClassContext 
e inClass 
e inClassLoader 
These methods throw com.ms.vjsharp.MethodNotSupportedException in Visual J#. 


See Upgrading Applications that use the Visual J++ 6.0 Security Semantics for more information. 
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Method java.lang.Thread.getName Has a Compatibility Issue 


The java.lang.Thread.getName method has a compatibility issue in Visual J#. See Compatibility Issues with Visual J++ 6.0. 


See Also 
Reference 
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Method java.lang.Thread.dumpStack Is Not Supported 


This method throws the com.ms.vjsharp.MethodNotSupportedException in Visual J#. 


See Also 
Reference 
Compatibility Issues with Visual J++ 6.0 
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Method java.lang.Thread.countStackFrames Is Not Supported 


This method throws the com.ms.vjsharp.MethodNotSupportedException in Visual J#. 


See Also 
Reference 
Compatibility Issues with Visual J++ 6.0 
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Method java.lang.ThreadGroup.allowThreadSuspension Is Not 
Supported 


This method throws the com.ms.vjsharp.MethodNotSupportedException in Visual J#. 


See Also 
Reference 


Compatibility Issues with Visual J++ 6.0 
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Package java.security Has Compatibility Issues 


The default security provider provided with Visual J# has the following compatibility issues with the default provider in Visual 
J++ 6.0: 


Key encoding is not supported in keys generated by the default security provider. Therefore, the following java.security 
methods are not supported by the default provider in Visual J#: 


e java.security.Key.getEncoded 
e@ java.security.Key.getFormat 
These methods throw com.ms.vjsharp.MethodNotSupportedException in Visual J#. 


e The default security provider does not support keys generated by other security providers. This means that it is not 
possible to sign and verify data using third-party private and public keys. 


e The default security provider cannot verify signatures generated by other security providers. 


However, Visual J# allows users to plug in third-party security providers for operations such as generating keys and signatures. 


For more information, see Upgrading Applications That Use Third-Party Security Providers. 
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Package com.ms.ActiveX Is Not Supported 


Visual J# does not support hosting ActiveX controls. For more information, see Hosting ActiveX Controls in the Java Language. 
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Package com.ms.asp Is Not Supported 


For more information, see Upgrading from com.ms.* Packages to Equivalent .NET Framework Class Libraries. 
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Package com.ms.awt Is Not Supported 


For more information, see Unsupported Class Libraries and Features. 
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Class com.ms.com.ComSuccessException Has a Compatibility 
Issue 


In projects upgraded from Visual J++ 6.0, non-failing HRESULTs like S_FALSE are always treated as equivalent to S_OK, and 
exceptions of type com.ms.com.ComSuccessException are not thrown. 


See Also 
Reference 
Java Language Calling COM 
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Interface com.ms.com.NoAutoMarshaling Has a Compatibility 
Issue 


In Visual J#, marker interfaces com.ms.com.NoAutoMarshaling and com.ms.com.NoAutoScripting in the JActivex 
wrappers are not supported. Visual J++ applications that depend on the functionality provided by these interfaces may need to 
be appropriately modified during upgrade. 


For more information, see Issues and Workarounds: Java Language Calling COM. 


See Also 
Reference 
Java Language Calling COM 
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Package com.ms.debug Is Not Supported 


For more information, see Unsupported Class Libraries and Features. 
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Package com.ms.directX Is Not Supported 


For more information, see Unsupported Class Libraries and Features. 


Visual J# Reference 


Package com.ms.ie Is Not Supported 


For more information, see Unsupported Class Libraries and Features. 


Visual J# Reference 


Package com.ms.iis ls Not Supported 


For more information, see Upgrading from com.ms.* Packages to Equivalent .NET Framework Class Libraries. 
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Package com.ms.io.clientstorage Is Not Supported 


For more information, see Unsupported Class Libraries and Features. 
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Package com.ms.io Is Not Supported 


The package com.ms.io is not supported. However, you can use the java.io or System.componentmodel.license packages 
instead. For more information, see Unsupported Class Libraries and Features. 


See Also 
Reference 
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Package com.ms.license Is Not Supported 


The package com.ms.license is not supported. However, you can use the System.ComponentModel.License package 
instead. For more information, see Unsupported Class Libraries and Features. 


See Also 
Reference 
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Package com.ms.mtx Is Not Supported 


For more information, see Upgrading from com.ms.* Packages to Equivalent .NET Framework Class Libraries. 
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Package com.ms.net.wininet Is Not Supported 


For more information, see Unsupported Class Libraries and Features. 
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Package com.ms.object Is Not Supported 


For more information, see Unsupported Class Libraries and Features. 
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Package com.ms.object.dragdrop Is Not Supported 


For more information, see Unsupported Class Libraries and Features. 
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Package com.ms.security Is Not Supported 


For more information, see Upgrading from com.ms.* Packages to Equivalent .NET Framework Class Libraries. 
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Package com.ms.security.permissions Ils Not Supported 


For more information, see Upgrading from com.ms.* Packages to Equivalent .NET Framework Class Libraries. 
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Package com.ms.service Is Not Supported 


For more information, see Unsupported Class Libraries and Features. 
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Package com.ms.util.InputMethod Is Not Supported 


For more information, see Unsupported Class Libraries and Features. 
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Package com.ms.vm Is Not Supported 


For more information, see Upgrading from com.ms.* Packages to Equivalent .NET Framework Class Libraries. 
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Class com.ms.wfc.app.Locale Has Compatibility Issues 


The following methods in the class com.ms.wfc.app.Locale have been deprecated: 
e com.ms.wfc.app.Locale.getCountryCode 
e com.ms.wfc.app.Locale.getCountry 
e com.ms.wfc.app.Locale.getAbbrevCountry 
e com.ms.wfc.app.Locale.getNativeCountry 
e com.ms.wfc.app.Locale.getDefaultCountry 
e com.ms.wfc.app.Locale.getEnglishCountry 


© com.ms.wfc.app.Locale.getISO3116CountryName 


When upgrading Visual J++ applications to Visual J#, developers must use the new methods that replace these deprecated 
methods. For more information, see Methods in com.ms.wfc.app.Locale Class. 


See Also 
Reference 
Methods in com.ms.wfc.app.Locale Class 
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ActiveX Control Projects Are Not Supported 


Exposing WFC controls or Java Beans as ActiveX controls is not supported in Visual J#. If your Visual J++ project is an Activex 
control, the project will not work after upgrading to Visual J#. 


See Also 
Reference 
COM Calling the Java Language 
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Package com.ms.xml Is Not Supported 


The following com.ms.xml.* packages are not supported in Visual J#: 
e com.ms.xml.dso 
e com.ms.xml.om 
e com.ms.xml.parser 
e com.ms.xml.util 


You will have to modify your application to replace the classes from these packages with classes that have equivalent 
functionality from the System.Xml namespace of the. NET Framework libraries. 


For more information, see Upgrading Components that Use com.ms.xml Package. 
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Compatibility Issue in Method 
com.ms.com.ComLib.ownsCleanup 


This method always returns true in Visual J#. 
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Compatibility Issue in Method com.ms.dll.DIILib.copy 


The method com.ms.dll.DIILib.copy has a compatibility issue in Visual J#. See Compatibility Issues with Visual J++ 6.0. 
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IME (Input Method Editor) Methods in com.ms.lang.SystemX 
Are Not Supported 


The following methods in class com.ms.lang.SystemX are not supported: 
e getDefaultinputManager 
e getinputManager 
e setinputManager 
e setKeyBoardLanguage 


These methods throw com.ms.vjsharp.MethodNotSupportedException in Visual J#. 
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Compatibility Issue in Class com.ms.com.Variant 


Visual J# does not support marshaling VARIANTS of type VT_BYREF. 


See Also 
Reference 


Java Language Calling COM 
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Compatibility Issue in Interface com.ms.com.NoAutoScripting 


In Visual J#, marker interfaces in the JActiveX wrappers com.ms.com.NoAutoMarshaling and 
com.ms.com.NoAutoScripting are not supported. Visual J++ applications that depend on the functionality provided by 
these interfaces may need to be appropriately modified. 


For more information, see Issues and Workarounds: Java Language Calling COM. 


See Also 
Reference 
Java Language Calling COM 
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Package com.ms.security.auditing Is Not Supported 


For more information, see Upgrading from com.ms.* Packages to Equivalent .NET Framework Class Libraries. 
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Class com.ms.util.SystemVersionManager Is Not Supported 


Visual J# does not support the class com.ms.util.SystemVersionManager. 
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Class com.ms.util.IncludeExcludeWildcards Is Not Supported 


Visual J# does not support the class com.ms.util.IncludeExcludeWildcards. 
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Class com.ms.util.SetComparer Is Not Supported 


Visual J# does not support the class com.ms.util.SetComparer. 
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Compatibility Issue in Class com.ms.util.IntRanges 


In Visual J#, the following methods of the com.ms.util.IntRanges class are not supported: 
e IntRanges.condense(IintRangeComparator judge ) 
e IntRanges.intersect(IntRanges other, IIntRangeComparator judge) 
e IntRanges.removeRange(int (, IIntRangeComparator hook) 
e IntRanges.removeRange(int s, int e, IIntRangeComparator hook) 
e IntRanges.removeRanges(int s, int count, IIntRangeComparator hook) 
e IntRanges.removeSingleton(int n, IIntRangeComparator hook) 
e IntRanges.sort(IIntRangeComparator judge ) 


e IntRanges.compare (IntRanges intRange7, IIntRangeComparator judge) 
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Compatibility Issues in Class com.ms.util.UnsignedIntRanges 


Visual J# does not support the class com.ms.util.UnsignedIntRanges. 
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Class com.ms.util.WildcardExpression Is Not Supported 


Visual J# does not support the class com.ms.util.WildcardExpression. 
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Compatibility Issues in Class 
com.ms.util.FileVersionInformation 


The class com.ms.util.FileVersionInformation has a compatibility issue in Visual J#. In Visual J#, this class does not support 
the FileType and OperatingSystem properties. See Compatibility Issues with Visual J++ 6.0. 
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Interface com.ms.util.!WildcardExpressionComparator Is Not 
Supported 


Visual J# does not support the interface com.ms.util.|WildcardExpressionComparator. 
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Interface com.ms.util.I!IntRangeComparator Is not Supported 


Visual J# does not support the interface com.ms.util.IIntRangeComparator. 
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Compatibility Issue in Class com.ms.util. Timer 


In Visual J#, the following constructors of the com.ms.util. Timer class are not supported: 


public Timer(TaskManager tm, long p) 

public Timer(TaskManager tm, long p, int id) 

public Timer(TaskManager tm, long p, boolean r) 

public Timer(TaskManager tm, long p, int id, boolean r) 

public Timer(TaskManager tm, TimeListener defaultListener, long p) 

public Timer(TaskManager tm, TimeListener defaultListener, long p, int id) 
public Timer(TaskManager tm, TimeListener defaultListener, long p, boolean r) 


public Timer(TaskManager tm, TimeListener defaultListener, long p, int id, boolean r) 
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Interface com.ms.util.ProvideSetComparisonInfo Is Not 
Supported 


Visual J# does not support the interface com.ms.util.ProvideSetComparisonInfo. 
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Methods com.ms.util. HTMLTokenizer.mark And com.ms.util. 
HTMLTokenizer.reset Are Not Supported 


These methods throw the com.ms.vjsharp.MethodNotSupportedException in Visual J#. 
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Class com.ms.util.Task Is Not Supported 


Visual J# does not support the class com.ms.util.Task. For more information, see Unsupported Class Libraries and Features. 
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Class com.ms.util.TaskManager Is Not Supported 


Visual J# does not support the class com.ms.util. TaskManager. For more information, see 
Unsupported Class Libraries and Features. 
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Package com.ms.wfc.html Has Compatibility Issues 


Projects that were created as code-behind HTML projects in Visual J++ 6.0 have a compatibility issue. For more information, 
see Upgrading Components that Use com.ms.wfc.html Package. 
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Locating Resources Have a Compatibility Issue 


The Upgrade Wizard has determined that your Visual J++ 6.0 project uses resources. In Visual J#, there are some changes in 
the way resources are located at run-time. This affects both WFC resources (used by Application Wizard projects), as well as 
any user-specified resources located using java.lang.Class.getResource method. 


In order for the application to locate the resources correctly under Visual J#, the resources have to be converted to a new 
format used by resource files in applications targeting the .NET Framework. 


The wizard automatically converts resource files in your project with the extensions '.resources' and '.properties' to the new 
format, and saves them with the extension '.resx'. For these resources you do not need to take any action. 


For resource files in your Visual J++ 6.0 project with any other extension, or for resources loaded from a location outside your 
project folder, specified using CLASSPATH, you need to convert the resources to the format used by resource files in Visual 
Studio .NET. 


For more information, see Using Resources in Visual J#. 
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Third-Party Packages Not Supported in This Release 


The following packages were available with Visual J++ 6.0, but are not available in Visual J#. 
e netscape.javascript 
e sun.audio 
e sun.awt.image 
e sun.beans.editors 
e sun.beans.infos 
e sun.io 
e sun.misc 
© sun.net.ftp 
@ sun.net 
e sun.net.nntp 
e sun.net.smtp 
e sun.net.www 
e sun.net.www.protocol.doc 
e sun.net.www.protocol.file 
e sun.net.www.protocol.ftp 
e sun.net.www.protocol.http 
e sun.security.acl 
e sun.security.pkcs 
e sun.security.util 
e sun.security.x509 


e sun.tools.jar 


Applications using classes from these packages, will have to be appropriately modified to use equivalent functionality available 
in the .NET Framework class libraries, or other third-party libraries targeting the common language runtime. 
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Compatibility Issue in Directive @com.register 


Incompatibilities with Visual J++ 6.0 exist in the set of interfaces exposed by COM Callable Wrappers (CCWs) of the Java- 
language components. In Visual J#, the following interfaces are not exposed by the CCWs: 


e |ProvideClassInfo2 and IExternalConnection 


e |Persist, IPersistStreamInit, and IPersistStorage (exposed in the Microsoft Java Virtual Machine when a class 
implements java.io.Serializable or java.io.Externalizable) 


e Marker interfaces com.ms.com.NoAutoMarshaling and com.ms.com.NoAutoScripting on the class are ignored. 
This could lead to run-time compatibility issues with respect to Visual J++ 6.0. 


e There is currently no support to sink events fired by Java-language/COM classes in COM clients. 


See Also 

Reference 

Issues and Workarounds: COM Calling the Java Language 
Java Language Calling COM 

Partial Support for @com Directives 
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Directive @com.transaction Is Not Supported 


The @com.transaction directive is ignored in Visual J#. 


See Also 

Reference 

COM Calling the Java Language 
Partial Support for @com Directives 
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Directive @com.typeinfo Is Not Supported 


The @com.typeinfo directive is ignored in Visual J#. 


See Also 

Reference 

COM Calling the Java Language 
Partial Support for @com Directives 
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Custom Marshaling Is Not Supported in Java-Language/COM 
Interop and J/Direct 


Microsoft Visual J# does not support JActiveX wrappers that use custom marshalers to marshal Java-language types to native 
types. Attempting to compile such wrappers with the Visual J# compiler results in compile-time errors. 


For more information, see Upgrading Java-language/COM Components That Use Custom Marshaling. 


See Also 
Reference 
Partial Support for @com Directives 
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Potential Threading Model Issue When Hosting ActiveX 
Controls in WFC Forms 


When hosting ActiveX controls in WFC Forms, you may be required to set the apartment model of the thread hosting the 
ActiveX control to the single threaded apartment (STA). This requirement is mostly satisfied by attaching the System. STAThread 
attribute to the public static void main(String[] args) method of the class. 


For more information, see Handling the Threading Model of COM Components. 
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RNI Technology Is Not Supported 


The Raw Native Interface (RNI) technology is not supported in Visual J#. 


See Also 
Reference 


Unsupported Class Libraries and Features 
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JNI Technology Is Not Supported 


The Java Native Interface (JNI) technology is not supported in Visual J#. 


See Also 
Reference 
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The Type Library for a Class or Interface Is Not Found 


During upgrade analysis of your project files, the Upgrade Wizard was unable to locate the type library for a COM Class or 
Interface used in the project. The wizard locates the type library by searching in the registry of your computer for the GUID of 
the COM class or interface. See details reported by the wizard for this issue, for more information on the GUIDS for which the 
registration information was not found. 


The GUID search may fail because an interface is not registered. This may not be a problem after upgrade, if the class 
implementing the interface is referenced in the upgraded project. 


However, if the GUID search failed because the CLSID of a class was not found, it will result in a failure while building the 
upgraded project. To rectify this, make sure that the Visual J++ 6.0 project can be built and run successfully on the computer 
where you are doing the upgrade. 


See Also 
Other Resources 
Upgrading from Visual J++ 6.0 
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Unresolved Class or Interface References 


The Upgrade Wizard has identified that your Visual J+ + 6.0 project references some classes or interfaces that are not defined 
within the project, or in the assembly references supplied in the Add Project References page of the Upgrade Wizard. See the 
details of this issue in the report, for more information on the classes or types whose references were not found. 


In addition to probing the Visual J++ 6.0 project references and assembly references specified during the upgrade, the 
upgrade analysis attempts to locate the missing reference by probing the directory and archive locations defined in the 
classpath setting of the Visual J++ 6.0 project. 


This issue may be reported when your Visual J++ 6.0 project depends on classes defined in another project in the solution, or 
on external class libraries referenced using the CLASSPATH environment variable on the system. 


For resolving this issue, you can add the assembly or assemblies containing the unresolved classes or interfaces, to the 
references list of the upgraded project in Visual J#. For more information on how to do this, see 
Adding and Removing Project References. 


Alternatively, during upgrade you can provide a reference to the assembly or assemblies containing the unresolved classes or 
interfaces. For information on how to do this, see Upgrade Wizard: Add Project References. 


If you do not have the source files of the externally references classes or interfaces, but have the binary files or archives, then 
you can convert the class (.class) files or archive (.cab, jar or .zip) files to MSIL assemblies using the Visual J# Binary Converter 
tool (jbimp.exe). 





that since some references were not found, the upgrade analysis may be incomplete for classes or interfaces extending or im 
plementing the missing classes or interfaces. 
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Unresolved Class or Interface References Found in Classpath 


The Upgrade Wizard has identified that your Visual J++ 6.0 project has references to classes or interfaces located in the 
classpath defined in your project. This identification is made by searching for the class (.class) file with a name matching the 
unresolved classes or interfaces. 


See the details of this issue to identify the classpath locations (directories or archive files) where the missing references have 
been located. 


To resolve the missing references, you need to create one or more assemblies that contain definitions of the missing classes or 
interfaces, and add their references to the upgraded project. 


If you have source files 


If you have the source files for the missing class or interface references, you can build a class library from the sources using a 
Visual J# Class Library project. This class library (dll) file can be added to the upgraded project references. Use the classpath 
locations identified in the upgrade report to identify which classes should be a part of this class library. 


If you do not have source files 


If you do not have the source files, but you have the binary files or archives, then you can convert class (.class) files or archive 
(.cab, jar or zip) files to an MSIL assembly using the Visual J# Binary Converter tool (jbimp.exe). This assembly can be added 
to the references list of the upgraded project. Use the classpath locations identified in the upgrade report to identify which 
classes should be a part of this assembly. 


See Also 
Tasks 
How to: Add and Remove References in Visual Studio (C#, J#) 
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Reference to Type Library Could Not Be Added to the Project 


During upgrade analysis, the wizard detected that your project references a COM type library. However, adding a reference to 
this COM type library (.dll or .tlb) file failed. The upgrade report indicates which type library or libraries failed to be added. 


To fix this, try manually adding a reference to this type library using Visual J#. For more information, see 
Adding and Removing Project References. 
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Source Control Settings Not Upgraded to the New Project 


The Upgrade Wizard has identified that your Visual J++ 6.0 project was under source control. The wizard does not upgrade 
source control settings from your Visual J++ 6.0 project file to the upgraded Visual J# project file. 


Use the Change Source Control command on the Source Control menu to rebind the projects to their server locations. For 
more information, see Changing Connections. 
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Visual J# Does Not Support Classpath 


Your Visual J++ 6.0 Project has a project-specific Classpath setting. This property was used to locate classes referenced by the 
project during upgrade analysis. However, Visual J# does not support Classpath and this setting is not upgraded. 


See Also 
Reference 


No Support for CLASSPATH Variable 
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Pre- and Post-Build Settings Are Not Upgraded 


Pre- and Post-Build settings from your Visual J++ 6.0 project are not upgraded to the new project. Visual J# Projects have no 
support for pre- and post-build settings. 

To replace these settings, you can create custom build steps for the upgraded project. If you want a custom build step on a 
Visual J# project, add a C++ Makefile project (see Creating a Makefile Project) to your solution and change the Configuration 


Type property to Utility (see General Property Page (Project) for more information). See 
Understanding Custom Build Steps and Build Events for more information. 
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Type Library Settings in Project Are Not Upgraded 


Settings for Type Library creation in the Visual J++ 6.0 project are not upgraded to Visual J#. Projects in Visual J# do not 
support creating type libraries as part of the project output. 
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Project is Run Using Custom Launch Program 


Your Visual J++ 6.0 Project has a Custom Launch Program setting. An external program specified in this setting is used to 
launch the application when it is run from the Visual J++ 6.0 development environment. 


Under Visual J#, using the same external program to launch the application may not work, since the project outputs are now 
managed assemblies and not class files. 


You will have to manually set the Start Application property of the upgraded project to set an appropriate external program to 
launch your project from the Visual J# development environment. For more information, see 
Debugging, Configuration Properties, <Projectname> Property Pages Dialog Box (Devices) 
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Resource File Upgrade Failed 


Your Visual J++ 6.0 project contains resource files in the Visual J++ 6.0 format (.resources and .properties file extensions). The 
Upgrade Wizard attempted to convert them to the .NET resource (.resx) file format, but format conversion failed unexpectedly. 


To resolve this issue, you can manually convert the resource file and add it to the upgraded project. For more information, see 
Using Resources in Visual J# Applications. 
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Analysis of Project Files Was Not Completed 


The Upgrade Wizard analyzes your Visual J++ 6.0 project to detect upgrade issues. During analysis, an error was encountered 
which resulted in the upgrade analysis being incomplete. Hence, all upgrade issues may not have been detected and added to 
the Upgrade Report. Building and running the upgraded project may not be successful unless all upgrade issues are detected 

and rectified. 


The reason for the error during analysis may be one of the following: 
Build errors in the project in Visual J++ 6.0 


If your Visual J++ 6.0 project contains syntax errors or other errors that will make the build fail in Visual J++ 6.0, then it will 
also fail during upgrade analysis. To upgrade successfully, ensure that the project is building and running under Visual J++ 6.0, 
and then try to upgrade again. 


Missing references during upgrade 


If your project references classes or COM objects external to the project, then there is a likelihood that these missing references 
resulted in the upgrade analysis being incomplete. It is recommended that you upgrade the Visual J++ 6.0 project again, 
adding all external references in the "Add References" page of the Upgrade Wizard. For more information on how to do this, 
see Upgrade Wizard: Add Project References. 


See Also 
Tasks 
How to: Upgrade a Visual J++ 6.0 Project 
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Issues in Upgrading Project File to New Format 


The Upgrade Wizard encountered issues while upgrading the Visual J++ 6.0 project file to Visual J#. These may be due to 
differences in the project properties that are stored in a Visual J++ 6.0 project file, and a Visual J# project file. 


Resolving Issues 


If the Upgrade Wizard is still open, you can click the Additional upgrade information button to display the reasons why a 
project failed to upgrade and possible solutions. Otherwise, from your project directory, you can manually open the 
_UpgradeReport.htm file in a browser. 


See Also 
Reference 
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Upgrade Issues in JDK Level 1.1.4 Class Libraries 


The Upgrade Wizard detected issues in the project sources involving usage of JDK level 1.1.4 Class Libraries. Some of the 
supported classes and methods in Visual J# class libraries may have compatibility issues with Visual J++ 6.0. See the issue 
details in the upgrade report under this category for more specific information. 


For information on class library support in Visual J#, see Class Library Support. 


See Also 

Reference 

Unsupported Class Libraries and Features 
Compatibility Issues with Visual J++ 6.0 
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Upgrade Issues in Microsoft Extensions 


The Upgrade Wizard has detected issues in usage of Microsoft extensions in Visual J++ 6.0, such as Windows Foundation 
Classes, and other packages in the com.ms.* hierarchy. These issues are due to some of these extensions not being supported 


or having compatibility issues, in Visual J#. See the issue details in the upgrade report under this category, for more 
information. 


See Also 
Other Resources 
Class Library Support 
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Missing Third-Party Extensions in Visual J# 


The Upgrade Wizard has identified usage of third party extensions to JDK level 1.1.4 packages. These extensions (like 
netscape.* and sun.* packages) were available in Visual J++ 6.0 but are not supported in Visual J#. For more information, see 
the issue details in the upgrade report under this category. 


See Also 
Reference 
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Unresolved COM References Encountered in Upgrade 


The Upgrade Wizard has detected references to COM components in your project that could not be resolved. For more 
information, see the issue details in the upgrade report, for this category. 


One of the reasons may be that the referenced COM component is not available on the system where the upgrade is being 
done. To rectify this, make sure that the project in Visual J++ 6.0 can be built and run on the same system where you are 
upgrading it to Visual J#. 


See Also 
Other Resources 
Upgrading from Visual J++ 6.0 
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Unresolved References Encountered in Upgrade 


The Upgrade Wizard has identified that there are some references to classes or interfaces in the project sources that are 
unresolved. For more information, see the issue details in the upgrade report, for this category. 


See Also 
Other Resources 


Upgrading from Visual J++ 6.0 
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Miscellaneous Other Issues 


General upgrade issues detected by the Upgrade Wizard. For more information, see the issue details in the 
Visual J# Upgrade Report, for this category. 


See Also 
Other Resources 
Upgrading from Visual J++ 6.0 
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J# Keywords 


The following is a list of the language keywords you can use in your J# programs. 


Keywords are predefined, reserved identifiers that have special meanings to the compiler. To use a keyword as an identifier in 
your program, include @ as a prefix. For example, @if is a legal identifier, but if is not a legal identifier, because it is a keyword. 


For more information, see Using Keywords as Identifiers. 


Reference 


abstract (Visual J#) 


boolean (Visual J#) 


break (Visual J#) 


final (Visual J#) 


try-finally (Visual J#) 


float (Visual J#) 


public (Visual J#) 


return (Visual J#) 


short (Visual J#) 





byte (Visual J#) 


for (Visual J#) 


static (Visual J#) 





try-catch (Visual J#) 


if (Visual J#) 


strictfp (Visual J#) 





char (Visual J#) 


implements (Visual J#) 


super (Visual J#) 





class (Visual J#) 


import (Visual J#) 


switch (Visual J#) 





const (Visual J#) 


instanceof (Visual J#) 


synchronized (Visual J#) 





continue (Visual J#) 


int (Visual J#) 


this (Visual J#) 





default (Visual J#) 


interface (Visual J#) 


throw (Visual J#) 





delegate (Visual J#) 


long (Visual J#) 


throws (Visual J#) 





do (Visual J#) 


multicast (Visual J#) 


transient (Visual J#) 





double (Visual J#) 


native (Visual J#) 


true (Visual J#) 





enum Keyword 


new (Visual J#) 


ubyte (Visual J#) 





extends (Visual J#) 


null (Visual J#) 


void (Visual J#) 





false (Visual J#) 


package (Visual J#) 


volatile (Visual J#) 





protected (Visual J#) 





private (Visual J#) 


while (Visual J#) 





See Also 
Concepts 
Visual J# Class Library 
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Access Modifiers (Visual J#) 


Access modifiers are keywords used to specify the access level of a member or a type. This section introduces the three access 
modifiers: 


@ public (Visual J#) 

Access is not restricted. 
@ protected (Visual J#) 

Access is limited to the containing class or types derived from the containing class. 
@ private (Visual J#) 


Access is limited to the containing type. 


See Also 
Reference 
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private (Visual J#) 


The private keyword is a member access modifier. Private access is the least permissive access level. Private members are 
accessible only within the body of the class in which they are declared. 


It is a compile-time error to reference a private member outside the class in which it is declared. However, private members 
declared within a class can be accessed by inner classes. 


For a comparison of private with the other access modifiers, see Access Modifiers (Visual J#). 
Example 
In this example, the Employee class contains a public member, Name, and a private member, Salary. The public member can 


be accessed directly, while the private member must be accessed through the public method AccessSalary (). 


// private_keyword.jsl 


class Employee 





i 
public String name = "xx"; 
private double salary = 100.00; 
public double AccessSalary() 
{ 
return salary; 
} 
} 
class MainClass 
{ 
public static void main(String[] args) 
{ 
Employee e = new Employee(); 
// Accessing the public field: 
String n = e.name; 
// Accessing the private field: 
double s = e.AccessSalary(); 
} 
, 
Remarks 


In the preceding example, if you attempt to access the private members directly by using a statement like this: 








double s = e.salary; 





you will get the error message: 





Cannot access field ‘'Employee.salary' 











See Also 

Reference 
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Access Modifiers (Visual J#) 
Access Modifiers (Visual J#) 
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protected (Visual J#) 


The protected keyword is a member access modifier. A protected member is accessible from within the class in which it is 
declared, from within any class derived from the class that declared this member, and from within the class package. 


A protected member of a base class is accessible in a derived class only if the access takes place through the derived class 
type. For example, consider the following code example: 


package P1; 
public class A 
{ 


} 


protected int x = 123; 


package P2; 
import P1.*; 
public class B extends A 


{ 
void F() 
{ 
A a = new A(); 
B b = new B()3 
a.x = 10; // Error 
b.x = 10; // OK 
} 
} 


The statement a.x =10 generates an error because although B extends A, it is in a different package. 


If a class is both a subclass of and in the same package as the class with the protected member, then the class has access to the 
protected member. 


For more information, see Access Modifiers (Visual J#). 
Example 
In this example, the class MyDerivedc is derived from MyClass; therefore, you can access the protected members of the base 


class directly from the derived class. 


// protected_keyword.jsl 


class MyClass 


{ 
protected int x; 
protected int y; 
class MyDerivedC extends MyClass 
{ 
public static void main(String[] args) 
{ 
MyDerivedC mC = new MyDerivedC(); 
// Direct access to protected members: 
mC.x = 10; 
mC.y = 15; 
System.out.printin("x = "+ mC.x +", y=" + mC.y); 
} 
} 
Output 


If you change the access levels of x and y to private, the compiler will issue the error messages: 


Cannot access field 'MyClass.x' 
Cannot access field 'MyClass.y' 








See Also 

Reference 

J# Keywords 
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Access Modifiers (Visual J#) 
Access Modifiers (Visual J#) 
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public (Visual J#) 


The public keyword is an access modifier for types and type members. Public access is the most permissive access level. There 
are no restrictions on accessing public members. 


For more information, see Access Modifiers (Visual J#). 
Example 
In the following example, two classes are declared, MyClass1 and MyClass2. The public members x and y of the MyClass1 are 


accessed directly from MyClass2. 


// Access_modifiers_public.jsl 
// Public access 


class MyClass1 








{ 
public int x; 
public int y; 
} 
class MyClass2 
{ 
public static void main(String[] args) 
i 
MyClass1 mC = new MyClass1(); 
// Direct access to public members: 
mC.x = 10; 
mC.y = 15; 
System.out.printin("x = "+ mC.x +", y=" + mC.y); 
} 
} 
Output 


If you change the public access level to private, you will get the error messages: 


Cannot access field 'MyClass1l.x' 
Cannot access field 'MyClassl.y' 








See Also 

Reference 

J# Keywords 

Other Resources 

Access Modifiers (Visual J#) 
Modifier Keywords (Visual J#) 
Access Modifiers (Visual J#) 





Visual J# Reference 


Exception Handling Keywords (Visual J#) 


J# provides built-in support for handling anomalous situations, known as exceptions, which may occur during the execution of 
your program. These exceptions are handled by code that is outside the normal flow of control. The try, throw, throws, catch, 
and finally keywords implement exception handling. 


The following exception handling topics are explained in this section: 
e throw (Visual J#) 
e throws (Visual J#) 
e try-catch (Visual J#) 
e try-catch-finally (Visual J#) 


© try-finally (Visual J#) 


See Also 
Reference 
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throw (Visual J#) 


The throw statement is used to signal the occurrence of an anomalous situation, an exception, during the program execution. It 
takes the following form: 


throw expression; 
Parameters 
expression 
The exception object. 
Remarks 


The thrown exception is an object whose class is derived from the Exception class, which descends from Throwable, such as 


NullPointerException. 


You can also throw a user-defined exception, as the following example demonstrates: 
class MyException extends Exception {} 
throw new MyException(); 


Usually the throw statement is used with try-catch or try-finally statements. When an exception is thrown, the program 
looks for the catch statement that handles this exception. 


You can also rethrow a caught exception using the throw statement. For more information and examples, see throws and try- 
catch. 


Example 


This example demonstrates how to throw an exception using the throw statement. 


// throw example 1 


public class ThrowTest 


{ 
public static void main(String[] args) 
{ 
String s = null; 
if (s == null) 
{ 
throw new NullPointerException(); 
} 
System.out.println("The string s is null"); // not executed 
} 
} 
Output 


//The NullPointerException exception occurs. You also get 
// the following message: 
java.lang.NullPointerException 

at ThrowTest.main(String[] args) 








This example demonstrates how to throw a user-defined exception using the throw and the throws statements. 


// throw example 2 


// Declare the subclass MyException: 
class MyException extends Exception 


{} 
public class ThrowTest1 


{ 
// Use the throws keyword with the method that throws the exception: 


public static void main(String[] args) throws MyException 


{ 
String s = null; 


if (s == null) 
i 


} 
// Not executed. 
System.out.println("The string s is null"); 


throw new MyException(); 


} 





Output 





//The MyException exception occurs. You also get the following message: 
MyException 
at ThrowTestl.main(String[] args) 





See Also 

Reference 
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throws (Visual J#) 


The throws keyword is used in a method declaration to list any exceptions not derived from Error or RuntimeException that 
a method can throw. 


Remarks 


To avoid abnormal termination of the program, either use throws in the declaration of the method that may throw the 
exception, or handle the exception using the try-catch or the try-catch-finally statement. 


In order to know which exception a specific method would throw, compile the program without the throws clause and the 
compiler will issue an error message that tells you the name of the exception you should declare or catch. 


Example 1 


This example is using the method System.in.read to read a character from the keyboard. This method must be used with the 
throws clause; otherwise, it throws the exception java.io.l|OException. If you try the example without the throws clause, you 
get the compile time error message "Exception 'java.io.IOException' is not caught and does not appear in throws 





clause.” 


// Throws1.jsl 
// throws example 
import java.io.*; 


class MyClass 


af 
// Use the throws keyword with the method that is expected to throw 
// an exception: 
public static void main(String[] args) throws IOException 
{ 
System.out.print("Please enter a character: "); 
// Read a character from the keyboard: 
char c = (char)System.in.read(); 
// Display the character: 
System.out.println("You entered the charcater " + c); 
} 
} 
Input 


Ww 


Sample Output 
Please enter a character: w 
You entered the character w 
Example 2 


This is example is the same as the previous example, but it shows you how to use System.in.read inside a try-catch 
statement to avoid the abnormal termination of the program. The catch block is used to catch the exception 
java.io.IOException. You can use, however, the super class java.lang.Exception in this case. 


// Throws2.jsl 
// throws example 
import java.io.*; 


class MyClass 


{ 
public static void main(String[] args) 
{ 
// Put the code that may throw an exception inside a try-catch block: 
try 
{ 


System.out.print("Please enter a character: "); 


// Read a character from the keyboard: 

char c = (char)System.in.read(); 

// Display the character: 
System.out.println("You entered the character 


+ C)5 


} 


// The catch block may handle the exception or may be empty: 
catch (IOException e) 











{ 
System.out.print("Exception caught!"); 
} 
} 
} 
Input 
€ 
Sample Output 





Please enter a character: e 


You entered the character e 





See Also 
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try-catch (Visual J#) 


The try-catch statement consists of a try block that can be followed by one or more catch blocks. The catch blocks specify 
handlers for different exceptions. This statement takes one of the following forms: 


try try-block 
catch (exception-declaration-1) catch-block-1 
catch (exception-declaration-2) catch-block-2 


ary try-block catch catch-block 
Parameters 
try-block 
Contains the code segment expected to raise the exception. 
exception-declaration, exception-declaration-1, exception-declaration-2 
The exception object declaration. 
catch-block, catch-block-1, catch-block-2 
Contains the exception handler. 
Remarks 


The try-block contains the guarded code block that may cause the exception. The block is executed until an exception is thrown 
or it is completed successfully. For example, in the following code, if you try to run the program with a string argument, it 
throws the exception NumberFormatException; and if you run it without arguments, it throws the exception 
ArraylndexOutOfBoundsException: 


public static void main(String argv[]) 


{ 
try 
{ 
int x = Integer.parseInt(argv[@]); 
} 
} 


The catch clause can take an object argument derived from the java.lang.Exception class or one of its subclasses. That 
means you can catch a specific exception such as NumberFormatException, like this: 


catch (NumberFormatException e) 


{ 
} 


// Exception handling statements. 


It is possible to use more than one specific catch clause in the same try-catch statement. In this case, the order of the catch 
clauses is important because the catch clauses are examined in order. Catch the more specific exceptions before the less 
specific ones, as the following code example demonstrates: 


try 
{ 
int x = Integer.parseInt(argv[@]); 
} 
catch (ArrayIndexOutOfBoundsException e) 
{ 
System.out.println(e) ; 
} 


catch (NumberFormatException e) 


{ 


System.out.println(e) ; 


} 
// The least specific. 


catch (Exception e) 


{ 
} 


System.out.println(e) ; 


A throw statement can be used in the catch block to rethrow the exception, which has been caught by the catch statement. For 
example: 


catch (Exception e) 


// Rethrowing exception e 
throw e; 


When inside a try block, only initialize variables that are declared therein; otherwise, an exception can occur before the 
execution of the block is completed. For example, in the following code example, the variable « is initialized inside the try block. 
An attempt to use this variable outside the try block in the print (x) statement will generate a compiler error because you are 
trying to use an unassigned local variable. 


public static void main(String argv[]) 


{ 
int x; 
try 
{ 
// Do not do the following. 
x = 123; 
Tf ean 
} 
catch (Exception e) 
{ 
Lf wen 
i: 
// Error: The local variable 'x' was 
// not initialized before use. 
System.out.print(x) ; 
} 
Example 1 


In this example, the try block contains a call to the method, MyMethod (), that may cause an exception. The catch clause 
contains the exception handler that simply displays a message along with the name of the exception. When the throw clause is 
called from inside MyMethod (), the exception is rethrown, and the system looks for the catch block and displays the message in 
the catch block. Notice that MyMethod () is visited twice: once before throwing the exception, and once when rethrowing the 
exception. 


// Rethrowing exceptions: 
// try-catch example 


class MyClass 


{ 
public static void main(String[] args) 
{ 
MyClass mc = new MyClass(); 
try 
{ 


String s = null; 
mc.MyMethod(s) ; 
} 


catch (NullPointerException e) 


{ 


System.out.println("Exception caught in the catch block: "+ 


e); 


} 
} 
public void MyMethod(String s) throws NullPointerException 
{ 
if (s == null) 
{ 
System.out.println("Hello from MyMethod."); 
throw new NullPointerException( 
"\nRethrowing exception from MyMethod; hello again!"); 
} 
} 
} 
Output 


Hello from MyMethod. 
Exception caught in the catch block: java.lang.NullPointerException: 
Rethrowing exception from MyMethod; hello again! 








Example 2 


In this example, two catch statements are used. The most specific exception, which comes first, is caught. 


// Ordering catch clauses 
// try-catch example 


class MyClass 
{ 


public static void main(String[] args) 


{ 
MyClass x = new MyClass(); 


try 

{ 
String s = null; 
x.MyMethod(s) ; 

} 


// Most specific: 
catch (NullPointerException e) 


{ 
} 


System.out.printin("First exception caught." + e); 


// Least specific: 
catch (Exception e) 


{ 
} 


System.out.println("Second exception caught." + e); 


} 


public void MyMethod(String s) 
q 
if (s == null) 
throw new NullPointerException(); 


Output 


First exception caught.java.lang.NullPointerException 

//In the preceding example, if you start with the least specific catch clause, you will 
get this error message: 

Catch unreachable: matching exceptions were caught in earlier catch clause 
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try-catch-finally (Visual J#) 


A common usage of catch and finally together is to obtain and use resources in a try block, deal with exceptional 
circumstances in a catch block, and release the resources in the finally block. 


try try-block catch catch-block(s) finally finally-block 


Parameters 


try-block 

Contains the code segment expected to raise the exception. 
catch-block(s) 

Contains the exception handler. 
finally-block 

Contains the exception handler and the cleanup code. 
Remarks 


The finally keyword is used to define a block of code following a try-catch exception block. The finally block is optional, and 
appears after the try block and after any catch blocks. The code in a finally block is guaranteed to be executed once, 
regardless of how the code in a try block executes. In normal execution, control reaches the end of the try block and then 
proceeds to the finally block, which typically performs any necessary cleanup. 


If control leaves the try block because of a return, continue, or break statement, the contents of the finally block are still 
executed before control transfers out of the try block. 


If an exception occurs in the try block, and there is an associated catch block to handle the exception within the method, 
control is transferred first to the catch block, and then to the finally block. If there is no local catch block to handle the 
exception, control is transferred first to the finally block, and then moves up the series of prior method calls until the exception 
can be handled. 


Example 


// try-catch-finally 
public class EHClass 


{ 
public static void main(String [] args) 
{ 
try 
{ 
System.out.println("Executing the try statement."); 
throw new NullPointerException(); 
catch(NullPointerException e) 
{ 
System.out.println("Caught exception #1:" + e); 
} 
finally 
{ 
System.out.println("Executing finally block."); 
} 
} 
} 
Output 


Executing the try statement. 
Caught exception #l:java.lang.NullPointerException 
Executing finally block. 
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try-finally (Visual J#) 


The finally block is useful for cleaning up any resources allocated in the try block. Control is always passed to the finally 
block regardless of how the try block exits. This statement takes the following form: 


try try-block finally finally-block 


Parameters 


try-block 


Contains the code segment expected to raise the exception. 


finally-block 


Contains the exception handler and the cleanup code. 


Remarks 


Whereas catch is used to handle exceptions that occur in the try block, finally is used to guarantee a statement block of code 
executes once regardless of how the preceding try block is exited. 


If control leaves the try block because of a return, continue, or break statement, the contents of the finally block are still 
executed before control transfers out of the try block. 


Example 


In this example, there is an invalid assignment statement that causes an exception. When you run the program, an exception is 
thrown, but the finally clause is still executed. 


// try-finally 


public class TryFinally 


public static void main(String[] args) 


i 
1 
: 
} 
Output 


intl] i = new int[3]; 


try 
{ 


// Invalid assignment to an array element: 
i[5] = 34; 


} 


finally 
{ 


// The following statement is always executed: 
System.out.println("Hello from the finally block!"); 





//When you run the program, it halts as the IndexOutOfRangeException 
// exception occurs. 


Unhandled 
he array. 





Exception: 


The 


following message is then displayed: 





System. IndexOutOfRangeException: Index was outside the bounds of t 


at TryFinally.main(String[] args) 


Hello from the finall 
//Notice that al 
// statement included in 


y bl 











Hello from the finall 
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Iteration Statements (Visual J#) 


You can create loops by using the iteration statements. Iteration statements cause embedded statements to be executed a 
number of times, subject to the loop-termination criteria. These statements are executed in order, except when a 
Jump Statements (Visual J#) is encountered. 


The following keywords are used in iteration statements: 
e do (Visual J#) 
e for (Visual J#) 


e@ while (Visual J#) 


See Also 
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do (Visual J#) 


The do statement executes a statement or a block of statements repeatedly until a specified expression evaluates to false. It 
takes the following form: 


do statement while (expression) ; 


Parameters 
expression 


A boolean expression or an expression that can be implicitly converted to boolean. The expression is used to test the loop- 
termination criteria. 


statement 
The embedded statement or statements to be executed. 
Remarks 


Unlike the while statement, the body loop of the do statement is executed at least once regardless of the value of the 
expression. 


This examples demonstrates using the do loop to print positive numbers less than 5. 
Example 1 


// do1.jsl 
// do example 


public class TestDoWhile 


{ 
public static void main(String[] args) 
{ 
int x; 
int y = Q; 
do 
{ 
X = ytt; 
System.out.println(x) ; 
} 
while(y < 5); 
} 
} 
Output 
0 
1 
2 
3 
4 
Example 2 


In this example, although the condition evaluates to false, the loop will be executed once. 


// do2.jsl 
// do example 


class DoTest { 
public static void main(String[] args) 
< 
int n = 10; 
do 


System.out.println("Current value of n is 
n++3 
} while (n < 6); 





Output 


Current value of n is 10 


See Also 

Reference 

J# Keywords 

Other Resources 

Iteration Statements (Visual J#) 


+n); 





Visual J# Reference 


for (Visual J#) 


The for loop executes a statement or a block of statements repeatedly until a specified expression evaluates to false. It takes 
the following form: 


for ([initializers]; [expression]; [iterators]) statement 

Parameters 
initializers 

A comma-separated list of expressions or assignment statements to initialize the loop counters. 
expression 

An expression that can be implicitly converted to bool. The expression is used to test the loop-termination criteria. 
iterators 

Expression statement or statements to increment or decrement the loop counters. 
statement 

The embedded statement or statements to be executed. 
Remarks 


The for statement executes the statement repeatedly as follows: 
e First, the initializers are evaluated. 


e Then, while the expression evaluates to true, the statement is executed and the iterators are evaluated. 


e When the expression becomes false, control is transferred outside the loop. 


Because the test of expression takes place before the execution of the loop, a for statement executes zero or more times. 


All of the expressions of the for statement are optional; for example, the following statement is used to write an infinite loop: 


for (33) 
{ 


} 


Example 


// statements_for1.jsl 
// for loop example 


public class ForLoopTest 


{ 
public static void main(String[] args) 
{ 

for (int i = 1; i <= 53 i++) 
System.out.println(i); 

} 

} 

Output 
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while (Visual J#) 


The while statement executes a statement or a block of statements until a specified expression evaluates to false. It takes the 
following form: 


while (expression) statement 


Parameters 
expression 


A boolean expression or an expression that can be implicitly converted to boolean. The expression is used to test the loop- 
termination criteria. 


statement 
The embedded statement or statements to be executed. 
Remarks 
Because the test of expression takes place before each execution of the loop, a while loop executes zero or more times. 


Awhile loop can be terminated when a break, return, or throw statement transfers control outside the loop. To pass control 
to the next iteration without exiting the loop, use the continue statement. 


Example 


// while1.isl 
// while example 


class WhileTest 





{ 
public static void main(String[] args) 
{ 
int n = 1; 
while (n < 6) 
{ 
System.out.println("Current value of n is " + n); 
n++3 
i; 
i 
I 
Output 
Current value of nis 1 
Current value of n is 2 
Current value of n is 3 
Current value of nis 4 
Current value of n is 5 
See Also 
Reference 
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Jump Statements (Visual J#) 


Branching is performed using jump statements, which cause an immediate transfer of the program control. The following 
keywords are used in jump statements: 


e@ break (Visual J#) 
@ continue (Visual J#) 
e default (Visual J#) 


e return (Visual J#) 


See Also 
Reference 
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break (Visual J#) 


The break keyword is used to define a break statement that, without a label, transfers control out of the innermost enclosing 
while, do, for, or switch statement. If the break statement includes a label and the statement is executed, control is 
transferred out of the enclosing statement to the line immediately following the label declaration. 


The break statement also transfers control outside of try-catch blocks. If the break statement with a label is executed within a 
try or catch block, and an associated finally block is defined for the try-catch block, then the contents of the finally block 
will first be executed. After the entire finally block has executed, control is once again transferred to the first statement 
immediately following the label declaration. This statement takes one of the following forms: 


break; 
break label; 


Parameters 
label 

A label that identifies a block of code. 
Remarks 


The label takes the form of an identifier followed by a colon: 


myLabel: Statement(s) 


Notice that the labeled block must contain the break statement. 

You cannot transfer program control to a labeled block that does not include the break statement. 

Example 1 

In this example, the conditional statement contains a counter that is supposed to count from 1 to 100; however, the break 


statement terminates the loop after 4 counts. 


// statements_break1.jsl 
// break example 


class BreakTest 


{ 
public static void main(String[] args) 
{ 
for (int i = 13; i <= 100; i++) 
{ 
if (i == 5) 
break; 
System.out.print(i + " "); 
} 
} 
} 
Output 
123 4 
Example 2 


This example demonstrates the use of break in a switch statement. 


// statements_break2.jsl 
// break and switch 
import java.io.*; 


class BreakSwitch 


public static void main(String[] args) throws IOException 


{ 
System.out.print("Enter your selection (1, 2, or 3): ")3 
char n = (char)System.in.read(); 
switch(n) 
case '1': 
System.out.println("Current value is " + 1); 
break; 
case '2': 
System.out.println("Current value is " + 2); 
break; 
case '3': 
System.out.printin("Current value is "+ 3); 
break; 
default: 
System.out.println("Sorry, invalid selection."); 
} 
} 
} 
Input 


1 


Sample Output 


Enter your selection (1, 2, or 3): 1 
Current value is 1 

//If you entered 4, the output would be: 
//Enter your selection (1, 2, or 3): 4 
//Sorry, invalid selection. 


Example 3 


In this example, the break statement is used to break the loop and jumps to a specific label. This is the goto form in J#. Notice 
that the labeled block must contain the break statement 


// statements_break3.jsl 
// break to a label example 


class BreakLabel 


{ 
public static void main(String[] args) 
{ 
Bye: 
for(int i=1; i<=5; i++) 
{ 


System.out.println("i=' 
for(int j=1; j<=5; j++) 


+i); 


System.out.println("j=' 
for(int k=1; k<=5; k++) 


+j)3 


if(k == 1) System.out.printin( "k=" + k + 
": Hello from the inner loop."); 
if(k == 2) 
{ 
System.out.printin("k=" + k + 
": Hello again from the inner loop."); 
// Jump after looping twice. 
break Bye; 
ij 


} 
System.out.println("Not reached."); 


} 
} 


System.out.println("Bye, I am out of here!"); 


} 


System.out.print1ln("Not reached."); 





Output 











Hello again from the inner loop. 
, IT am out of here! 





1=1 
j=1 
k=1: Hello from the inner loop. 
k=2 
Bye 





See Also 
Reference 
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continue (Visual J#) 


The continue statement, without a label, transfers control to the end of the innermost enclosing while, do, or for loop. Once 
control is passed, the current loop iteration ends and a new one begins. If the continue statement includes a label and is 
executed, control is transferred to the last statement of the outer loop. In this case, the continue target label must point to a 
while, do, or for loop. Notice that this is unlike the labeled break statement, where the target need not be a loop, or iteration, 
statement. 


If the continue statement with a label is executed within a try or catch block, and an associated finally block is defined for 
the try-catch block, then the contents of the finally block is executed first. After the entire finally block is executed, control is 
once again transferred to the last statement of the loop immediately following the label declaration. It takes the following form: 


continue; 
continue label; 


Example 1 


In this example, a counter is initialized to count from 1 to 10. By using the continue statement in conjunction with the 
expression (i < 9), the statements between continue and the end of the for body are skipped. 


// statements_continue1.jsl 
// continue example 


class ContinueTest 


{ 
public static void main(String[] args) 
{ 
for (int i = 1; i <= 10; i++) 
{ 
if (i < 9) 
continue; 
System.out.println(i); 
} 
} 
} 
Output 
9 
10 
Example 2 


In this example, two nested loops are used to search for a substring within a string. The labeled form of continue is used to 
skip an iteration on the outer loop. 


// statements_continue2.jsl 
// continue example 


public class ContinueWithLabelTest 


{ 
public static void main(String[] args) 
{ 
String searchStr = "This is a string"; 
String subStr SS" 5 
boolean foundIt = false; 
int maxlen = searchStr.length() - subStr.length(); 
BLOCK1: 


for (int i 


{ 


@; i <= maxlen; i++) 


} 
} 





Output 


int n = subStr.length(); 
int j = i; 


int k = Q; 
while (n-- != @) 
{ 
if (searchStr.charAt(j++) != subStr.charAt(k++) ) 
{ 
continue BLOCK1; 
} 
} 
foundIt = true; 
break; 


} 

if (foundIt) 
{ 

} 

else 


d 
} 


System.out.println("Found it"); 


System.out.println("Didn't find it"); 


Found it 


See Also 
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default (Visual J#) 


The default keyword can be used in the switch statement to specify the default label. 


See Also 
Reference 
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return (Visual J#) 


The return statement terminates execution of the method in which it appears and returns control to the calling method. It can 
also return the value of the optional expression. If the method is of the type void, the return statement can be omitted. This 
statement takes the following form: 


return [expression]; 
Parameters 
expression 
The value returned by a method. expression is not allowed with methods of the type void. 
Example 
In the following example, the method a() returns the variable Area as a double value. 


// statements_return.jsl 
// return example 


class ReturnTest 


{ 
static double CalculateArea(int r) 
{ 
double area; 
area = r*r*Math.PI; 
return area; 
} 
public static void main(String[] args) 
t 
int radius = 5; 
System.out.printlin("The area is "+ 
Math.ceil(CalculateArea(radius))); 
} 
} 
Output 


The area is 79.0 


See Also 

Reference 
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Literal Keywords (Visual J#) 


J# has the following literal keywords: 
null (Visual J#) 
true (Visual J#) 


false (Visual J#) 


See Also 
Reference 
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false (Visual J#) 


Represents the Boolean value false. 











Example 
// keyword_false.jsl 
class MyClass 
. 
public static void main(String[] args) 
1 
boolean a = false; 
System.out.println( a ? "yes" "no" ); 
} 
} 
Output 
no 
See Also 
Reference 
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null (Visual J#) 


The null keyword is a literal that represents a null reference, one that does not refer to any object. null is the default value of 
reference-type variables. A null literal is always of the null type. 


Remarks 

There is no permitted conversion from the null type to any primitive type. 

There is no permitted conversion to the null type other than the identity conversion. 
Example 


The following code example checks that the value of a variable is not null before calling an operation on it. 


import java.util.Date; 
class MyClass 


{ 
public static void main(String[] args) 
{ 
MyClass class1 = new MyClass(); 
class1.printBirthday(); 
} 
public void printBirthday() 
{ 
System.out.println("Hello, " + name); 
System.out.print("Your birthday is: "); 
if (birthday != null) 
System.out.println(birthday.toString()); 
else 
System.out.println("unknown!"); 
} 
private String name = "John Smith"; 
private Date birthday = null; 
} 
Output 


Hello, John Smith 
Your birthday is: unknown! 


See Also 

Reference 
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true (Visual J#) 


Represents the Boolean value true. 








no" ); 


Example 
// js_keyword_true.jsl 
class test 
: 
public static void main(String[] args) 
{ 
boolean a = true; 
System.out.println( a ? "yes" * 
} 
} 
Output 
yes 
See Also 
Reference 
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Modifier Keywords (Visual J#) 


Modifiers are used to modify declarations of types and type members. This section introduces the following J# modifiers: 
abstract (Visual J#) 

const (Visual J#) 

final (Visual J#) 

multicast (Visual J#) 

native (Visual J#) 

static (Visual J#) 


volatile (Visual J#) 


See Also 
Reference 
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abstract (Visual J#) 


The abstract modifier can be used with classes, methods, properties, and events. 
Use the abstract modifier in a class declaration to indicate that a class is intended only to be a base class of other classes. 
Remarks 
Abstract classes have the following features: 
e An abstract class cannot be instantiated. 
e An abstract class may contain abstract methods and accessors. 
e An abstract class cannot be declared with the final modifier. 


e Anon-abstract class derived from an abstract class must include actual implementations of all inherited abstract 
methods and accessors. 


Use the abstract modifier in a method or property declaration to indicate that the method or property does not contain 
implementation. 


Abstract methods have the following features: 
e Abstract method declarations are only permitted in abstract classes. 


e Because an abstract method declaration provides no actual implementation, there is no method body; the method 
declaration simply ends with a semicolon and there are no braces ({ }) following the signature. For example: 


public abstract void myMethod(); 


e The implementation is provided by an overriding method, which is a member of a non-abstract class. 
e lItis an error to use the static modifier in an abstract method declaration. 

Abstract properties behave like abstract methods, except for the differences in declaration and invocation syntax. 
e Itis an error to use the abstract modifier on a static property. 


e An abstract inherited property can be overridden in a derived class by including a property declaration with the same 
syntax as the abstract property. 


An abstract class must provide implementation for all interface members. 


An abstract class that implements an interface might map the interface methods onto abstract methods. For example: 


interface I 


{ 
void m(); 
} 
abstract class C implements I 
{ 
public abstract void m(); 
} 
Example 


In this example, the class MyDerivedClass is derived from an abstract class, MyBaseClass. The abstract class contains an 
abstract method, myMethod(), and two abstract properties, get_x() and get_Y(). 


In the following example, if you attempt to instantiate the abstract class by using a statement like this: 


// Error 
MyBaseClass mC1 = new MyBaseClass(); 


you will get the following error message: 





Cannot create a new object of type 'MyBaseClass' because it is an 
"abstract' class 





// abstract_keyword.jsl 
// Abstract Classes 


// Abstract class: 
abstract class MyBaseClass 


‘ 
protected int x = 100; 
protected int y = 150; 


// Abstract method: 
public abstract void myMethod(); 


// Abstract property: 
/** @property */ 
public abstract int get_X(); 


// Abstract property: 

/** @property */ 

public abstract int get_Y(); 
} 


class MyDerivedClass extends MyBaseClass 


1 
public void myMethod() 


// Overriding property: 
/** @property */ 

public int get_X() 

1 


} 


return x+10; 


// Overriding property: 
/** @property */ 

public int get_Y() 

{ 


} 


return y+10; 


public static void main(String[] args) 
{ 
MyDerivedClass mC = new MyDerivedClass(); 
mC.myMethod() ; 
System.out.printin("x = " + mC.get_X() + 
", y=" + mC.get_Y¥()); 











Output 
x = 111, y = 161 


See Also 
Reference 
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const (Visual J#) 


const is reserved for future use as a keyword. 
Remarks 


While const is not currently implemented, it is reserved for future use. Therefore, const cannot be used as an identifier for a 
class, interface, field, method, property, delegate, event, or any other language feature. 


See Also 
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final (Visual J#) 


You can use the final modifier to modify variables, fields, methods, and classes. When a variable is declared final, it can be set 
only once. A final field can be set once by the constructor of its class. A method declared with the final modifier cannot be 
overridden or hidden. Final classes cannot be inherited, or extended. 


Remarks 
Using Final Variables 


You can declare a local constant by declaring a variable with the final modifier. Once you assign it a value, it will always 
contain this value. You can initialize a final variable at the time of declaration, or you can defer its initialization, in which case it 
is called a blank final. 


If a final variable holds an object reference, the state of the object may be changed by operations on the object, but the 
variable will always refer to the same object. 


public void myMethod() 


{ 
// Need not be compile-time constants: 
final int i = (int)(Math.random() * 20); 
// Not yet initialized: 
final int blankfinal; 
I/we 
// Must be initialized before use: 
blankfinal = 101; 
I] aes 

} 


Using Final Fields 


A field can be declared final. Both class and instance variables, static and non-static fields, can be declared final. When used 
together with static, final is used to flag constants. 


Example 

This example demonstrates the declaration and use of final fields. 
// final1.jsl 
// Constant fields 


public class Value 


{ 
} 


public int i = 1; 


public class FinalData 

{ 
// Can be compile-time constants: 
final int i1 = 9; 
static final int i2 = 99; 


// Typical public constant: 
public static final int i3 = 999; 


// Need not be compile-time constants: 
final int i4 = (int)(Math.random() * 11); 
static final int i5 = (int)(Math.random() * 11); 


Value v1 = new Value(); 
final Value v2 = new Value(); 
static final Value v3 = new Value(); 


// Arrays: 
final int[] a={1, 2, 3, 4, 5, 6 }; 


public void print(String id) 
{ 


} 


System.out.printin(id + ": "4+ "i4 =" 4 i144", 15 =" + i5); 


public static void main(String[] args) 
{ 
FinalData fd1i = new FinalData(); 
// Error: Can't change value! 
// ¥d1.i1++; 
// OK. Object isn't constant 
fd1.v2.i++; 
// OK. Not final. 
fd1.v1 = new Value(); 


for (int i = @; i < fdl.a.length; i++) 


fdl.a[i]++; // OK. Object isn't constant. 
} 


// Error: Can't change handle! 
// ¥d1.v2 = new Value(); 

// Error: Can't change handle! 
// #d1.v3 = new Value(); 

// Error: Can't change handle! 
// fd1l.a = new int[3]; 


fd1.print("fd1"); 
System.out.println("Creating new FinalData"); 
FinalData fd2 = new FinalData(); 
fd1.print("fd1"); 

fd2.print("fd2"); 


Sample Output 


fdi: i4 = 0, i5 =7 
Creating new FinalData 
fdi: i4 = 0, i5 =7 
fd2: i4 = 8, i5 =7 


Using Final Methods and Method Parameters 


A method can be declared final to prevent subclasses from overriding or hiding it. A private method and all methods declared 
in a final class are implicitly final, because it is impossible to override them. However, it is permitted for the declarations of 
such methods to include, redundantly, the final keyword. A method declared final cannot also be declared abstract. 


public class MyClass 


{ 
public final void MyMethod() 
{ 
} 

} 


Method parameters can also be declared final. This means that inside the method you cannot change what the parameter 
handle points to, as the following demonstrates: 


public class Gyro 


{ 
} 


public void spin() { } 


public class FinalParameters 


{ 


void withfinal(final Gyro g) 
{ 


// Error: g is final. 
//g = new Gyro(); 
g-.spin(); 


void withoutfinal(Gyro g) 
// OK: g is not final. 


g = new Gyro(); 
g-.spin(); 


public int f1(final int i) 


si 
// Error: Can't change i. 
// return ++i; 
// You can only read from a final primitive. 
return i + 1; // OK. 
} 
public static void main(String[] args) 
{ 
FinalParameters fp = new FinalParameters(); 
fp.withoutfinal(nul1) ; 
fp.withfinal(null) ; 
int i = 100; 
int j = fp.f1(i); 
} 


Using Final Classes 


A class can be declared final if its definition is complete and no subclasses are desired or required. Consequently, a final class 
cannot have any subclasses, and the methods of a final class are never overridden. A final class cannot appear in the extends 
clause of another class declaration. A class declared final cannot also be declared abstract because the implementation of 
such a class could never be completed. 


public final class MyClass 


public void MyMethod() { } 


See Also 
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multicast (Visual J#) 


The multicast keyword is used in conjunction with the delegate keyword to declare a reference type that can be used to 
encapsulate one or more named methods. Delegates are roughly similar to function pointers in C++; however, delegates are 
type-safe and secure. 


The declaration of a multicast delegate type takes the following form: 


[attributes] [modifiers] multicast delegate result-type identifier ([formal-parameters]); 


Parameters 
where: 
attributes (Optional) 
Additional declarative information. 
modifiers (Optional) 
The allowed modifiers are the access modifiers public, private, and protected. 
result-type 
The result type. If the delegate is associated with a named method, the result-type must match the return type of the method. 
identifier 
The delegate name. 
formal-parameters (Optional) 
Parameter list. 
Remarks 


A delegate lets you pass a function as a parameter. The type safety of delegates requires the function you pass as a delegate 
to have the same signature as the delegate declaration. 


A multicast delegate differs from a regular delegate in that it can take several named parameters and combine them 
together. When the delegate is invoked, all the methods are invoked in the order in which they were combined. 


Delegates are the basis for events. 
Example 


The following is a simple example of declaring and using a multicast delegate. 


// keyword_multicast_1.jsl 
import System.Delegate; 


// multicast delegate declaration 
/** @delegate */ 
multicast delegate void MyDelegate(int i); 


class Program 


{ 


public static void main(String[] args) 


{ 


Program p = new Program(); 


MyDelegate d1 = new MyDelegate(p.DelegateFunctionA) ; 
MyDelegate d2 = new MyDelegate(p.DelegateFunctionB) ; 
MyDelegate d = (MyDelegate)Delegate.Combine(d1, d2); 
p.TakesADelegate(d) ; 


public void TakesADelegate(MyDelegate SomeFunction) 











{ 
SomeFunction. Invoke(21) ; 
} 
public void DelegateFunctionA(int i) 
1 
System.out.print1ln( 
"Called by multicast delegate with number: "+ i+ "."); 
} 
public void DelegateFunctionB(int i) 
{ 
System.out.println( 
"Once again, that number was: "+ i+ "."); 
} 
} 
Output 


Called by multicast delegate with number: 21. 
Once again, that number was: 21. 


See Also 
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native (Visual J#) 


The native modifier is used as a method modifier, declaring a method written in unmanaged code. 
Method Modifier 


Use the native modifier in a method declaration to indicate that the method is implemented externally. A common use of the 
native modifier is with the dll.import attribute. For more information, see DIlllmportAttribute. 


It is an error to use the abstract and native modifiers together to modify the same member. Using the native modifier means 
that the method is implemented outside the J# code, while using the abstract modifier means that the method 
implementation is not provided in the class. 


Because an external method declaration provides no actual implementation, there is no method body; the method declaration 
simply ends with a semicolon and there are no braces ({ }) following the signature. For example: 


public static native int myMethod(int x); 


Note 








The native keyword is more limited in use than the extern keyword in C++. To compare with the C++ keyword, see 
Using extern to Specify Linkage in the C++ Language Reference. 








Example 1 


In this example, the program receives a string from the user and displays it inside a message box. The program uses the 
MessageBox method imported from the User32.dll library. 











class MyClass 
ij 
/** @d1l.import("User32.d11") */ 
public static native int MessageBox( 
int h, 
String m, 
String c, 
int type); 
public static void main(String[] args) 
1 
try 
{ 
byte[] myString = new byte[100]; 
System.out.print("Enter your message: "); 
System.in.read(myString) ; 
int retVal = MessageBox(@, new String(myString).trim(), 
"My Message Box", @); 
catch (java.io. IOException ex) 
System.out.println(ex.toString()); 
} 
} 
Example 2 


This example creates an external DLL, written in C, which is invoked by the J# program in Example 3. 


Code 





// js_cmdll.c 

// compile with: /LD /MD 

int __declspec(dllexport) myMethod(int i) 
{ 


return i*10; 
} 


Example 3 


This example demonstrates using the native keyword to call an external DLL, from Example 2, within a J# program. 





// js_cm.jsl 
public class MyClass 
{ 


/** @d1l.import("js_cmdl1.d11") */ 
public static native int myMethod(int x); 
public static void main(String[] args) 


{ W 


System.out.println("myMethod() returns " + 
myMethod(5) + ".")3 








Output 


myMethod() returns 50. 


Remarks 


To build the project, use the following steps: 


@ Compile js_cmdll.ctoa DLL using the Visual C++ command line: 


cl /LD /MD js_cmdll.c 





@ Compile cm.js1 using the command line: 


vjc js_cm.jsl 











This will create the executable file js_cm.exe. When you run this program, myMethod will pass the value 5 to the DLL file, which 
returns the value multiplied by 10. 


See Also 
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static (Visual J#) 


Use the static modifier to declare a static member, which belongs to the type itself rather than to a specific object. The static 
modifier can be used with classes, fields, methods, properties, and events, but cannot be used with destructors or types other 
than classes. 


Remarks 
e Aconstant or type declaration is implicitly a static member. 


e While an instance of a class contains a separate copy of all instance fields of the class, there is only one copy of each 
static field. 


e Itis not possible to use this to reference static methods or property accessors. 


e Only inner classes can be static. 


e The static keyword can also be used to create a static initializer block that runs only once, when the object is first loaded 
into memory. 





The static keyword is more limited in use than in C++. To compare with the C++ keyword, see Static (C++) in the C++ 
Language Reference. 





To demonstrate instance members, consider a class that represents a company employee. Assume that the class contains a 
method to count employees and a field to store the number of employees. Both the method and the field do not belong to any 
instance employee. Instead they belong to the company class. Therefore, they should be declared as static members of the 
class. 


Example 


This example reads the name and ID of a new employee, increments the employee counter by one, and displays the 
information for the new employee as well as the new number of employees. For simplicity, this program reads the current 
number of employees from the keyboard. In a real application, this information should be read from a file. 


// js_static_keyword.jsl 
// Static members 
public class Employee 


{ 
public String id; 
public String name; 


public Employee() 
{ 
} 


public Employee(String name, String id) 
{ 


this.name = name; 
this.id = id; 


public static int employeeCounter; 


public static int AddEmployee() 
1 


} 


return ++employeeCounter; 


} 


class MainClass extends Employee 


{ 


public static void main(String[] args) 


{ 


try 


System.out.print("Enter the employee's name: "); 

byte[] name = new byte[100]; 

System.in.read(name) ; 

System.out.print("Enter the employee's ID: "); 

byte[] id = new byte[100]; 

System.in.read(id) ; 

// Create the employee object: 

Employee e = new Employee(new String(name).trim(), 
new String(id).trim()); 


System.out.print("Enter the current number of employees: 


byte[] n = new byte[10e]; 

System.in.read(n) ; 

Employee.employeeCounter = Integer.parseInt( 

new String(n).trim()); 

Employee. AddEmployee(); 

// Display the new information: 

System.out.println("Name: " + e.name); 

System.out.println("ID: "+ e.id); 

System.out.println("New Number of Employees: " + 
Employee.employeeCounter) ; 


catch (java.io. IOException ex) 


System.out.println(ex.toString()); 


ii 
i 
i 
Input 
Jan Stoklasa 
AF643G 
AIRS) 


Sample Output 


Enter the employee's name: Jan Stoklasa 
Enter the employee's ID: AF643G 

Enter the current number of employees: 15 
Name: Jan Stoklasa 

ID: AF643G 

New Number of Employees: 16 


See Also 

Reference 

J# Keywords 

this (Visual J#) 

Other Resources 

Access Modifiers (Visual J#) 


")3 


Visual J# Reference 


volatile (Visual J#) 


The volatile keyword indicates that a field can be modified in the program by something such as the operating system, the 
hardware, or a concurrently executing thread. 


volatile declaration 


Parameters 
declaration 


The declaration of a field. 
Remarks 


The system always reads the current value of a volatile object at the point it is requested, even if the previous instruction asked 
for a value from the same object. Also, the value of the object is written immediately on assignment. 


The volatile modifier is usually used for a field that is accessed by multiple threads without using the synchronized 
statement to serialize access. Using the volatile modifier ensures that one thread retrieves the most up-to-date value written 
by another thread. 


The type of a field marked as volatile is restricted to the following types: 

e Any reference type. 

e Any value type. 

e The types byte, ubyte, short, int, long, char, float, double, and boolean. 
Local variables cannot be declared volatile; only fields can be declared volatile. 
Example 


The following sample shows how to declare a public field variable as volatile. 


// jsharp_volatile.jsl 
class Test 


if 
public volatile int i; 
Test(int i) 
{ 
this.i = i; 
} 
public int getI() 
{ 
return i; 
} 
public static void main(String[] args) 
{ 
Test test = new Test(22); 
System.out.println("i is guaranteed to be read here: " + 
test.getI()); 
} 
} 
Output 


i is guaranteed to be read here: 22 


See Also 
Reference 
J# Keywords 
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byte (Visual J#) 

char (Visual J#) 

double (Visual J#) 

float (Visual J#) 

int (Visual J#) 

long (Visual J#) 

short (Visual J#) 
synchronized (Visual J#) 
ubyte (Visual J#) 
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Operator Keywords (Visual J#) 


This section introduces the following operator keywords: 
e@ new (Visual J#) 
Create objects. 
e instanceof (Visual J#) 


Check whether the run-time type of an object is compatible with a given type. 


See Also 
Reference 
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instanceof (Visual J#) 


Used to check whether the run-time type of an object is compatible with a given type. The instanceof operator is used in an 
expression of the following form. 


expression instanceof type 
Parameters 
expression 
An expression of a reference type. 
type 
A type. 
Remarks 


An instanceof expression evaluates to true if both of the following conditions are met: 


e expression is not null. 


e expression can be cast to type. That is, a cast expression of the form (type) (expression) will complete without throwing 
an exception. 


Note that the instanceof operator only considers reference conversions, boxing conversions, and unboxing conversions. Other 
conversions, such as user-defined conversions, are not considered by the instanceof operator. 


Example 


// js_keyword_instanceof.jsl 
// The instanceof operator. 
class Classi 


{ 
} 
class Class2 
af 
} 
public class IsTest 
{ 
public static void test(Object o) 
{ 
Classi a; 
Class2 b; 


if (o instanceof Class1) 


{ 
System.out.println("o is instance of Class1"); 
a = (Class1)o; 
// Do something with "a." 
} 
else if (o instanceof Class2) 
af 
System.out.println("o is instance of Class2"); 
b = (Class2)o; 
// Do something with "b." 
} 
else 
{ 
System.out.println("o is neither Class1 nor Class2."); 
} 


public static 





void main(String[] args) 





{ 
Class1 c1 = new Class1(); 
Class2 c2 = new Class2(); 
test(c1); 
test(c2); 
test("a string"); 

} 

} 
Output 


o is instance of Cl 
o is instance of Cl 
o is neither Classl 





See Also 
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new (Visual J#) 


Used to create new objects and dynamically allocate the necessary memory. For example: 


MyClass mc = new MyClass(); 


If the class does not define a constructor, the new operator invokes the default constructor. 

If the new operator fails to allocate memory, the application throws an exception. 

Example 

In the following example, a class object is created and initialized by using the new operator and then assigned values. The 


default and the assigned values are displayed. 


// operator_new.jsl 
// The new operator. 


class MyClass 


{ 

public String name; 

public int id; 

// Default constructor: 

public MyClass () 

{ 

} 

// Parameterized Constructor: 

public MyClass (int id, String name) 

{ 
this.id = id; 
this.name = name; 

} 

public static void main(String[] args) 

{ 
// Create objects using the default constructor: 
MyClass Employeel = new MyClass(); 
// Display values: 
System.out.println("Default values:"); 
System. out.print1n(" Class members: " + Employeel.name + 

", " + Employee1.id); 
// Create objects using the parameterized constructor: 
MyClass Employee2 = new MyClass(1234, "Craig Combel"); 
// Display values: 
System.out.println("Assigned values:"); 
System. out.print1n(" Class members: " + Employee2.name + 
", " + Employee2.id); 
} 
} 
Output 


Default values: 
Class members: null, 0 
Assigned values: 
Class members: Craig Combel, 1234 





Notice in the example that the default value of a string is null. 


See Also 


Reference 
J# Keywords 
class (Visual J#) 
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Miscellaneous Keywords (Visual J#) 


This section contains the following J# keywords: 
e extends (Visual J#) 
Used in a class declaration to extend (inherit) another class. 
@ import (Visual J#) 
Used to permit the use of types in a package so you do not have to qualify the use of a type in that package. 
e@ package (Visual J#) 
Used to declare a scope. 
e strictfp (Visual J#) 


Adds strict constraints that imply that the results of all expressions must be those predicted by IEEE 754 arithmetic on 
operands represented in single and double precision formats. 


@ synchronized (Visual J#) 
Used to mark a method or a statement block as a critical section. 
e transient (Visual J#) 
Used to indicate that a field is not part of the persistent state of an object. 
e void (Visual J#) 
Used to specify that the method does not return a value. 
® enum Keyword 


Used to declare an enumeration. 


See Also 
Reference 
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extends (Visual J#) 


Used in a class declaration to extend, or inherit, another class. The inherited class is referred to as the super class, while the 
inheriting class is referred to as the subclass. The declaration of a subclass takes the following form: 


[attributes] [modifiers] class identifier [extends super-class] { class-body }[3] 


Parameters 
attributes (Optional) 


Additional declarative information. 
modifiers (Optional) 
The allowed modifiers are abstract, final, private, protected, and public. 
identifier 
The class name. 
super-class (Optional) 
A base class that is inherited by this subclass. 
class-body 
Declarations of the class members. 
Remarks 


When a class extends another, it has access to its data members and methods. It can also extend the features of the super class 
by including other members of its own. 


Only single inheritance is allowed in J#. In other words, a class can extend one super class only, as follows: 
class MyClass extends MySuperClass { } 
Example 


In this example, the class Employee extends the class Citizen. In MyClass, the class Employee is instantiated and then the 
instance information is retrieved by calling the method Get Info (), which displays the employee's information in addition to 
calling GetPersonalInfo() from the super class to retrieve the citizen's information. 


// Keyword-extend.jsl 
// Inheritance example 


// Super class declaration: 
class Citizen 


{ 
String driversLicenseNo = "555-5555-WA"; 
String name = "Sally Abolrous"; 
public void GetPersonalInfo() 
{ 
System.out.println("Name: " + name); 
System.out.println("ID Card Number: " + driversLicenseNo) ; 
} 
} 


// The subclass declaration: 
class Employee extends Citizen 


{ 


String companyName = "Lucerne Publishing"; 
String companyID = "ENG-@@7-USA"; 


public void GetInfo() 
{ 


// Calling GetPersonalInfo method from the super calss: 
System.out.println("Citizen's Information:"); 
GetPersonalInfo(); 


System.out.println("\nJob Information:"); 
System.out.println("Company Name: " + companyName) ; 
System.out.println("Company ID: " + companyID); 
} 
} 


class MyClass 
1 


public static void main(String[] args) 


1 
Employee E = new Employee(); 
E.GetInfo(); 





Output 


Citizen's Information: 
Name: Sally Abolrous 
ID Card Number: 555-5555-WA 


Job Information: 
Company Name: Lucerne Publishing 
Company ID: ENG-007-USA 





When you call a method in the super class that has the same name as a method in the subclass, use the keyword super. For 
example, if you have two methods with the name Get Info, you can call the method in the super class like this: 








super.GetInfo(); 








For more information see super (Visual J#). 
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import (Visual J#) 


The import directive is used to permit the use of types in a package so you do not have to qualify the use of a type in that 
package. The import directive takes one of the following forms: 


import package[[.package]...].class; 
import package[[.package]...].*; 


Parameters 
package 

The package that contains the class or classes that you want to use. 
class 


The class name that you want to use. 


Specifies that you want to include all classes in a package without listing each class explicitly. 
Remarks 


Create an import directive to use the types in a package without having to specify the package. An import directive does not 
give you access to any packages that are nested in the package you specify. 


Packages come in two categories: user-defined and system-defined. User-defined packages are packages defined in your code. 
See the documentation for the INET Framework for a list of the system-defined packages. 


Example 
This example shows how to define an import directive for a class. It consists of three files, pack1 jsl, pack2,jsl, and pack3 jsl. 


Compile the first two files as libraries, and then compile the third file using references to those libraries. 


// pack1.jsl 
// compile with: /t:library 
package Package1; 


public class MyClass1 


{ 
public String toString() 
{ 
return "You are in Package1.MyClass1"; 
} 
} 


// pack2.jsl 
// compile with: /t:library 
package Package2; 


public class MyClass2 


{ 
public String toString() 
{ 
return "You are in Package2.MyClass2"; 
} 
} 


// pack3.jsl 
// compile with: /r:pack1.d11l,pack2.d11 
package Package2; 


// Imports all classes in package Packagel. 
import Packagel1.*; 
// Imports only class MyClass in package Package2. 











import Package2.MyClass2; 
class Test 
{ 
public static void main(String[] args) 
1 
MyClass1 class1 = new MyClass1(); 
System.out.println(class1.toString()); 
MyClass2 class2 = new MyClass2(); 
System.out.printin(class2.toString()); 
} 
} 
Output 


You are in Packagel.MyClassl 
You are in Package2.MyClass2 
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package (Visual J#) 


The package keyword is used to declare a scope. This package scope lets you organize code and gives you a way to create 
globally unique types. 


package name[.name1] ...]; 
type-declarations 


Parameters 
name, name1 


A package name can be any legal identifier. A package name can contain periods. 
type-declarations 


Within a package, you can declare one or more of the following types: 


e class 
e interface 
e delegate 


Remarks 


Even if you do not explicitly declare one, a default package is created. This unnamed package, sometimes called the global 
package, is present in every file. Any identifier in the global package is available for use in a named package. 


In J#, packages implicitly have public access unless compiled with the /securescoping compiler option, in which case they are 
scoped to the assembly in which they reside. For a discussion of the access modifiers you can assign to elements within a 
package, see the access modifiers public (Visual J#), private (Visual J#), and protected (Visual J#). 


Unlike C++ or C# namespaces, you can only specify one package declaration per source file. Nested packages must be 
declared in a separate file. 


It is possible to define a package in two or more declarations. For example, the following example defines both classes as part 
of the MyCompany. Proj1 package: 

// file MyClass.jsl 

package MyCompany.Proj1; 


class MyClass 
{ 
} 


// file MyClass1.jsl 
package MyCompany.Proj1; 


class MyClass1 


{ 
} 


Example 


This example shows how to call a static method in another package. The example consists of two files, package1 js! and 
package2.,jsI. Compile the first one as a library and use it as a reference when you compile the second file. 


// Package1.jsl 

// compile with: /t:library 

// A sub-package of SomePackage. 
package SomePackage.Nested; 


public class NestedPackageClass 


public static void sayHello() 
{ 


} 


System.out.println("Hello") ; 


} 


// Package2.jsl 

// compile with /r:Package1.d1l 
// Package example. 

package SomePackage; 


public class MyClass 
{ 


public static void main(String[] args) 


i 
} 


SomePackage.Nested.NestedPackageClass.sayHello(); 





Output 


Hello 
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strictfp (Visual J#) 


The strictfp keyword can be applied to a class, interface, or method. When you declare a method using the strictfp keyword, 
all code in the method will be executed according to strict constraints. When you use the strictfp keyword on a class or 
interface, all code in the class, including initializers and code in nested types, will be evaluated strictly. The strict constraints 
imply that the results of all expressions must be those predicted by IEEE 754 arithmetic on operands represented in single and 


double precision formats. 


Remarks 


While strictfp is recognized as a valid keyword by the J# compiler, strictness is not enforced. For performance reasons, the 
compiler defaults to the common language runtime (CLR) implementation for floating point arithmetic constraints. 


Example 1 


The following example shows a class declared with the strictfp modifier. 


// keyword_strictfp.jsl 
// Example of precision control with strictfp 


public strictfp class MyClass 


{ 
public MyClass() 
{ 
} 
public static void main(String[] args) 
{ 
float aFloat = @.6710339Ff; 
double aDouble = @.04150553411984792d; 
double sum = aFloat + aDouble; 
float quotient = (float)(aFloat / aDouble); 
System.out.printlin("float: " + aFloat); 
System.out.println("double: " + aDouble); 
System.out.println( "sum: "+ Sum); 
System.out.println("quotient: " + quotient) ; 
} 
} 


Sample Output 


float: 0.6710339 
double: @.04150553411984792 


sum: @.71253945297742238 
quotient: 16.1673355 
Example 2 


The following example shows a method declared with the strictfp modifier. 


// keyword_strictfp_2.jsl 
// Example of precision control with strictfp: 
public class MyClass2 


{ 
public float aFloat; 


public double aDouble; 


public MyClass2() 
{ 
} 


public strictfp double add(float a, double b) 
1 


return (a + b); 


} 

public static void main(String[] args) 

{ 
MyClass2 myClass2 = new MyClass2(); 
myClass2.aFloat = @.6710339Ff; 
myClass2.aDouble = @.04150553411984792d; 
double sum = myClass2.add(myClass2.aFloat, myClass2.aDouble) ; 
System.out.println("float: " + myClass2.aFloat); 
System.out.println("double: " + myClass2.aDouble) ; 
System.out.println( "sum: "+ SUM); 

} 





Sample Output 





float: @.6710339 
double: @.04150553411984792 
sum: @.71253945297742238 
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synchronized (Visual J#) 


The synchronized keyword can be used in one of two ways: 


@ To mark a statement block as a critical section by obtaining the mutual-exclusion lock for a given object, executing a 
statement, and then releasing the lock. 


@ To mark a method as a critical section by obtaining the mutual-exclusion lock for a given object, executing the contents of 
the method, and then releasing the lock. 


This statement takes one of the following forms: 


synchronized(expression) statement_block 
access modifier synchronized return_value method _name(method_params) 


Parameters 
expression 


Specifies the object that you want to synchronize on. expression must be a reference type. 


Typically, expression will either be this, if you want to protect an instance variable, or a class object (getClass), if you want to 
protect a static variable (or if the critical section occurs in a static method in the given class). 


statement_block 

The statements of the critical section. 
access_modifier 

The access modifier for the statement. 
return_value 

The return value for the method. 
method_name 

The name of the method to apply the synchronized keyword to. 
method_params (Optional) 

The parameters, if any, that the method takes. 
Remarks 


The synchronized keyword ensures that one thread does not enter a critical section while another thread is in the critical 
section of code. If another thread attempts to enter synchronized code, it will wait —block — until the object is released. 


The synchronized keyword calls Enter at the beginning of the block and Exit at the end of the block. 
Example 1 


The following example shows a simple use of threads in J#. 


// statements_lock.jsl 
import java.lang.Thread; 


class ThreadTest implements Runnable 


af 
public void run() 
{ 
System.out.println("run called"); 
} 
} 


public class MainClass 


{ 


public static void main(String[] args) 


try 


ThreadTest b = new ThreadTest(); 
Thread t = new Thread(b); 


t.start(); 
// Wait for thread to finish. 
t.join(); 

} 

catch (InterruptedException ex) 

{ 
System.out.printin(ex.toString()); 

} 

} 
} 
Output 


run called 


Example 2 
The following example uses threads and synchronized. As long as the synchronized statement is present, the statement 


block is a critical section and balance will never become a negative number. 


// statements_synchronized2.jsl 
import java.lang.Thread; 
import java.util.Random; 


class Account implements Runnable 
{ 
int balance; 


Random r = new Random(); 


public Account(int initial) 


{ 

balance = initial; 
} 
public void run() 
{ 

doTransactions(); 
} 


int withdraw(int amount) throws Exception 
{ 
// This condition will never be true unless the synchronized 
// statement is commented out: 
if (balance < @) 
{ 


} 


throw new Exception("Negative Balance"); 


// Comment out the next line to see the effect of leaving out 
// the synchronized keyword: 
synchronized (this) 


{ 

if (balance >= amount) 

{ 
System.out.println("Balance before Withdrawal " + balance); 
System.out.printin("Amount to Withdraw : -" + amount); 
balance = balance - amount; 
System.out.println("Balance after Withdrawal : " + balance); 
return amount; 

i 

else 


// Transaction rejected: 


return Q; 
} 
} 
} 
public void doTransactions() 
{ 
try 
{ 
for (int i = @; i < 100; i++) 
withdraw(r.nextInt(10@)); 
} 
catch (Exception ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
class Test 
1 
public static void main(String[] args) 
{ 
Thread[] threads = new Thread[10]; 
Account acc = new Account(10@@); 
for (int i = 0; i < 10; i++) 
Thread t = new Thread(acc); 
threads[i] = t; 
for (int i = 0; i < 10; i++) 
threads[i].start(); 
} 
} 
} 
Example 3 


The following example demonstrates using the synchronized method parameter on the withdraw method from the previous 
example, rather than using a synchronized statement. 


// statements_synchronized3.jsl 
import java.lang.Thread; 
import java.util.Random; 


class Account implements Runnable 
{ 
int balance; 


Random r = new Random(); 


public Account(int initial) 


{ 

balance = initial; 
} 
public void run() 
{ 

doTransactions(); 
i 


synchronized int withdraw(int amount) throws Exception 


// This condition will never be true unless the synchronized 
// method modifier is commented out: 
if (balance < @) 


{ 
throw new Exception("Negative Balance"); 
} 
if (balance >= amount) 
i 
System.out.println("Balance before Withdrawal : " + balance); 
System.out.println("Amount to Withdraw : -" + amount); 
balance = balance - amount; 
System.out.println("Balance after Withdrawal : " + balance); 
return amount; 
} 
else 
{ 
// Transaction rejected: 
return @; 
} 
} 
public void doTransactions() 
{ 
try 
{ 
for (int i = @; i < 100; i++) 
withdraw(r.nextInt(10@) ); 
} 
catch (Exception ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 


} 


class Test 


public static void main(String[] args) 


{ 
Thread[] threads = new Thread[10]; 
Account acc = new Account(10@@); 
for (int i = @; i < 10; i++) 
Thread t = new Thread(acc); 
threads[i] = t; 
} 
for (int i = @3; i < 10; i++) 
threads[i].start(); 
} 
} 
} 
| 
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transient (Visual J#) 


The transient keyword is used to indicate that a field is not part of the persistent state of an object. Fields marked as transient 


will not be saved during serialization or restored during deserialization. 


Remarks 


By default, all public, protected, and private fields of a class are persisted during the serialization process. Fields marked with 


the transient keyword will be excluded from serialization. 


Example 


The following example serializes a class containing six integers. Three of the integers are serialized to a file and three are not 
serialized because they are marked with the transient keyword. When a new object is created using the data stored in the file, 
only the non-transient fields are restored to their original value. The non-serialized attributes are initialized with their default 


value, which is zero for integers. 


// keyword_transient.jsl 
import java.io.*; 


public class MyClass implements Serializable 


{ 


public static void main(String[] args) 


{ 


MyClass myClass = new MyClass(); 


// Add 10@ to all the fields. 
myClass.publicInt = 100; 
myClass.publicTransientInt = 101; 


myClass.set_ProtectedInt(1@2) ; 
myClass.set_ProtectedTransientInt (103) ; 


myClass.set_PrivateInt(104) ; 
myClass.set_PrivateTransientInt(105) ; 


// Print out myClass. 
System.out.println("Before serialization..."); 
System.out.println("publicInt: " + 
myClass.publicInt) ; 
System.out.println("publicTransientInt: " + 
myClass.publicTransientInt) ; 
System.out.println("protectedInt: " + 
myClass.get_ProtectedInt()); 
System.out.println("protectedTransientInt: " + 
myClass.get_ProtectedTransientInt()); 
System.out.println("privateInt: " + 
myClass.get_PrivateInt()); 
System.out.printlin("privateTransientInt: " + 
myClass.get_PrivateTransientInt()); 
System.out.println(); 


try 
{ 
// Serialize MyClass to a file. 
FileOutputStream fileOutStr = 
new FileOutputStream("C:\\SerializedClass.txt"); 


ObjectOutputStream objOutStr = 
new ObjectOutputStream(fileOutStr) ; 
objOutStr.writeObject(myClass) ; 


// Create a new instance of MyClass by reading in 
// the serialized myClass from the file created previously. 
FileInputStream fileInStr = 

new FileInputStream("C:\\SerializedClass.txt"); 


MyClass myClass2 = null; 


ObjectInputStream objiInStr = 
new ObjectInputStream(fileInStr) ; 
myClass2 = (MyClass)objInStr.readObject(); 


// Print out myClass2. 
System.out.println("After serialization..."); 
System.out.println("publicInt: " + 
myClass2.publicInt) ; 
System.out.println("publicTransientInt: " + 
myClass2.publicTransientInt) ; 
System.out.println("protectedInt: " + 
myClass2.get_ProtectedInt()); 
System.out.println("protectedTransientInt: " + 
myClass2.get_ProtectedTransientInt()); 
System.out.println("privateInt: " + 
myClass2.get_PrivateInt()); 
System.out.println("privateTransientInt: " + 


myClass2.get_PrivateTransientInt()); 


} 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
catch (ClassNotFoundException ex) 
if 
System.out.println(ex.toString()); 
} 
} 
public MyClass() 
{ 
} 


/** @property */ 
public int get _ProtectedInt() 
{ 


} 

/** @property */ 

public void set_ProtectedInt(int value) 
{ 

} 

/** @property */ 

public int get_ProtectedTransientInt() 
< 

} 

/** @property */ 

public void set_ProtectedTransientInt(int value) 
{ 

} 

/** @property */ 

public int get _PrivateInt() 

{ 

} 


/** @property */ 
public void set_PrivateInt(int value) 


return protectedInt; 


protectedInt = value; 


return protectedTransientInt; 


protectedTransientInt = value; 


return privateInt; 


if 

} 

/** @property */ 

public int get_PrivateTransientInt() 

1 

} 

/** @property */ 

public void set_PrivateTransientInt(int value) 


{ 
} 


privateInt = value; 


return privateTransientIint; 


privateTransientInt = value; 
public int publicInt = @; 
public transient int publicTransientInt = 1; 


protected int protectedInt = 2; 
protected transient int protectedTransientIint = 


private int privateInt = 4; 
private transient int privateTransientInt = 5; 





Output 


Before serialization... 
publicInt: 100 
publicTransientiInt: 101 
protectediInt: 102 
protectedTransientInt: 103 
privateiInt: 104 
privateTransientint: 105 





After serialization... 
publiciInt: 100 
publicTransientiInt: 0 
protectediInt: 102 
protectedTransientint: 0 
privateiInt: 104 
privateTransientint: 0 
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void (Visual J#) 


When used as the return type for a method, void specifies that the method does not return a value. 
The void keyword is not allowed in a method's parameter list. A method that takes no parameters and returns no value is 


declared as follows: 


void MyMethod() ; 
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enum Keyword 


In Microsoft Visual J# 2005, it is now possible to author enumeration types using the enum keyword. It is used to declare a 
user-defined enumeration, which consists of a set of named constants called the enumerator list. Every enumeration type has 
an underlying type of int. By default, the first enumerator has the value 0, and the value of each successive enumerator is 
increased by 1. For example: 


enum Day {Sat, Sun, Mon, Tue, Wed, Thu, Fri} 


In this enumeration, Sat is 0, Sun is 1, Mon is 2, and so forth. You can display the elements of the enumeration directly, like this: 


System.out.println(Day.Mon) ; // Displays Mon. 


You can also display the integers associated with the named constant, like this: 





System.out.println((int)Day.Mon) ; // Displays 2. 











You can change the values of the enumeration by initializing the elements. For example: 





enum Day {Sat(1), Sun, Mon, Tue, Wed, Thu, Fri} 











In this enumeration, the sequence of elements is forced to start from 1 instead of 0. 


It is also possible to initialize more than one element. For example, consider the enumeration: 


enum DayOff {Sat(7), Sun(1)} 


In this case, the value associated with Sat is 7 and the value associated with Sun is 1. 


You can pass enumerations as parameters to methods. For example, you can declare a method like this: 





public static void MyMethod(DayOff d) 
{ 


// Display the enum element as a string: 
System.out.println(d); 











This method is called by using a call like this: 





MyMethod(DayOff.Sat); // Displays Sat. 











Remarks 


Enumerations are type-safe; that is, there is no automatic conversion between enum and int. For example, the following code 
generates a compile-time error: 


DayOff dl = 1; #// Error. 


You can, however, use a cast to create an integer variable from an enum element: 





int di = (int)DayOff.Sun; // Ok. 





To find out the type from which an enum is derived, use a statement like this: 


System.out.println("The " + 
DayOff.Sat.getClass().ToType() + 








type is derived from " + 


DayOff.Sat.getClass().ToType().get_BaseType() +"."); 


The previous statement gives the following output: 


The DayOff type is derived from System. Enum. 


You can also get the underlying type by using a statement like the following statement: 


System.out.println("Underlying type: 


)))3 


This statement gives the following output: 


The underlying type is System.Int32. 


You can apply FlagsAttribute to an enumeration to indicate that the enumeration should be treated as a bit field; that is, as a set 


of flags (see Example 2). 


Example 1 


The type enum might also be used in the switch statement. The following example demonstrates such use. 


// enum-ex1.jsl 
// Using enum with switch. 


// Declare an enum type for working days: 
enum WorkingDay {Mon(1), Tue, Wed, Thu, Fri}; 


public class MyClass 


{ 


public static void main(String [] args) 


{ 


// Declare an enum element of the type WorkingDay: 


WorkingDay d = WorkingDay.Fri; 


int dayNum = 


(int)d; 


// Test the selected day: 
switch (d) 


{ 


case WorkingDay.Mon: 
System.out.println("The 
System.out.println("The 
(int)d + "."); 
break; 

case WorkingDay.Tue: 
System.out.println("The 
System.out.println("The 
(int)d + ".")3 
break; 

case WorkingDay.Wed: 
System.out.println("The 
System.out.println("The 
(int)d + ".")3 
break; 

case WorkingDay.Thu: 
System.out.println("The 
System.out.println("The 
(int)d + "."); 
break; 

case WorkingDay.Fri: 
System.out.println("The 
System.out.println("The 
dayNum + "."); 
break; 


selected day is 
number of the day 


selected day is 
number of the day 


selected day is 
number of the day 


selected day is 
number of the day 


selected day is 
number of the day 


+ d+ 
is + 


+ d+ 


is + 


+ d+ 


is + 


+ d+ 


is + 


+ d+ 


is + 


+ System. Enum.GetUnderlyingType(DayOff.class.ToType( 


-")3 


-")3 


")3 


-")3 


-")3 


default: 
System.out.println("Not case is suitable!"); 
break; 





Output 


The selected day is Fri. 
The number of the day is 5. 





Example 2 


This example demonstrates using the FlagsAttribute attribute with enumerations. 


// enum-ex2.jsl 
// Using FlagsAttribute with enum. 


import System.*; 


/** @attribute Flags() */ 
public enum CarOptions 














{ 
SunRoof (@x@1) , 
Spoiler(@x@2), 
FogLights(@x@4), 
TintedWindows (@x@8 ) 
} 
public class flagtest 
‘ 
public static void main(String args[]) 
si 
CarOptions options = CarOptions.SunRoof | CarOptions.FogLights; 
System.out.println(options) ; 
System.out.println((int)options) ; 
} 
} 
Output 


SunRoof, FogLights 
5 


Notice that if you remove the FlagsAttribute attribute, the example will output the following: 


3) 
i) 
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Primitive Types (Visual J#) 


This section contains the following keywords that are used to declare primitive types in J#: 
e boolean (Visual J#) 
e byte (Visual J#) 
e char (Visual J#) 
e double (Visual J#) 
e float (Visual J#) 
e int (Visual J#) 
@ long (Visual J#) 
e short (Visual J#) 


e@ ubyte (Visual J#) 


See Also 
Reference 


J# Keywords 


Visual J# Reference 


boolean (Visual J#) 


The boolean keyword is used to declare a primitive data type containing a truth value. The boolean type has two values, 
represented by the literals true and false. 


Literals 
You can assign a Boolean value to a boolean variable. You can also assign an expression that evaluates to boolean to a 


boolean variable. 


// keyword_boolean.jsl 
package MyPackage; 
public class MyClass 


{ 
public static void main(String[] args) 
{ 
boolean i = true; 
char c = '@'; 
System.out.println(i); 
i = false; 
System.out.println(i); 
boolean alphabetic = (c > 64 && c < 123); 
System.out.println(alphabetic) ; 
} 
} 
Output 
true 
false 
false 


Conversions 


In C++, a value of type boolean can be converted to a value of type int; in other words, false is equivalent to zero and true is 
equivalent to nonzero values. In J#, there is no conversion between the boolean type and other types. For example, the 
following if statement is invalid in J#, while it is legal in C++: 


int x = 123; 

// Invalid in J# 
if (x) 
{ 


printf_s("The value of x is nonzero."); 


} 


To test a variable of the type int, you have to explicitly compare it to a value (for example, zero), as follows: 


int x = 123; 
// The J# way: 
if (x != @) 
{ 
System.out.println("The value of x is nonzero."); 
} 
Example 1 


In this example, you enter a character from the keyboard and the program checks if the input character is a letter. If so, it 
checks if it is lowercase or uppercase. In each case, the proper message is displayed. 


// keyword_boolean_2.jsl 
// Character Tester 
public class BoolTest 











{ 
public static void main(String[] args) 
{ 
try 
{ 
System.out.print("Enter a character: "); 
char c = (char)System.in.read(); 
if (Character.isLetter(c)) 
if (Character.isLowerCase(c)) 
System.out.println("The character is lowercase."); 
else 
System.out.println("The character is uppercase."); 
else 
System.out.println("The character is not an alphabetic character."); 
} 
catch (java.io. IOException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 
iu 
Input 


X 


Sample Output 


Enter a character: X 
The character is uppercase. 





Additional sample runs might look as follows: 





Enter a character: x 
The character is lowercase. 


Enter a character: 2 
The character is not an alphabetic character. 
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byte (Visual J#) 


The byte keyword denotes an integral type that stores values according to the size and range shown in the following table. 


Type Range Sie 





be 28 to 127 Signed 8-bit integer 


Literals 


You can declare and initialize a byte variable like this example: 


byte myByte = 127; 


In the preceding declaration, the integer literal 127 is implicitly converted from int to byte. If the integer literal exceeds the 
range of byte, a compilation error will occur. 


A cast must be used when calling overloaded methods. Consider, for example, the following overloaded methods that use byte 


and int parameters: 


public static void myMethod(int i) {} 
public static void myMethod(byte b) {} 





Using the byte cast guarantees that the correct type is called. For example: 





// Calling the method with the int parameter. 
MyClass.myMethod(5); 

// Calling the method with the byte parameter. 
MyClass.myMethod((byte)5); 








Conversions 
There is a predefined implicit widening conversion from byte to short, int, long, float, or double. 


You cannot implicitly convert nonliteral numeric types of larger storage size to byte. Consider, for example, the following two 
byte variables x and y: 





byte x = 10, y = 20; 











The following assignment statement will produce a compilation error, because the arithmetic expression on the right-hand side 
of the assignment operator evaluates to int by default. 


// Error: conversion from int to byte: 
byte z =x + y3 





To fix this problem, use a cast: 





// OK: explicit conversion: 
byte z = (byte)(x + y); 











It is possible, though, to use the following statements, where the destination variable has the same storage size or a larger 
storage size: 


byte x = 10, y = 20; 


int m = xX + y; 
long n= x + y3 





Notice also that there is no implicit conversion from floating-point types to byte. For example, the following statement 
generates a compiler error unless an explicit cast is used: 





// Error: no implicit conversion from double: 
byte x = 3.0; 


// OK: explicit conversion: 
byte y = (byte)3.0; 





For information on arithmetic expressions with mixed floating-point types and integral types, see float (Visual J#) and 
double (Visual J#). 
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char (Visual J#) 


The char keyword is used to declare a Unicode character in the range indicated in the following table. Unicode characters are 
16-bit characters used to represent most of the known written languages throughout the world. 




















Type Range Size 
char ‘\u0000' to ‘\uffff' Unicode 16-bit character 
Literals 


Constants of the char type can be written as character literals, hexadecimal escape sequence, or Unicode representation. You 
can also cast the integral character codes. All of the following statements declare a char variable and initialize it with the 
character x: 





// Character literal: 

char myChar = 'X'; 

// Cast from integral type: 
char myChar = (char)88; 

// Unicode: 

char myChar = '\u@@58'; 











Conversions 


A char can be implicitly converted to short, int, long, float, or double. However, there are no implicit conversions from other 
types to the char type. 
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double (Visual J#) 


The double keyword denotes a simple type that stores 64-bit floating-point values. The following table shows the precision 
and approximate range for the double type. 

















Type Approximate range Precision 
double -1.7E308 to 1.7E308 15-16 digits 
Literals 


By default, a real numeric literal on the right-hand side of the assignment operator is treated as double. However, if you want 
an integer number to be treated as double, use the suffix d or D, for example: 





double x = 3D; 





Conversions 


You can mix numeric integral types and floating-point types in an expression. In this case, the integral types are converted to 
floating-point types. The evaluation of the expression is performed according to the following rules: 


e If one of the floating-point types is double, the expression evaluates to double (or boolean in the case of relational or 
Boolean expressions). 


e If there is no double type in the expression, it evaluates to float (or boolean in the case of relational or Boolean 
expressions). 


A floating-point expression can contain the following sets of values: 
e Positive and negative zero 
e Positive and negative infinity 
e Not-a-Number value (NaN) 


e The finite set of nonzero values 


For more information on these values, refer to the IEEE Standard for Binary Floating-Point Arithmetic, available on the Web site 
http://www.ieee.org/portal/index,jsp. 


Example 1 


In the following example, an int, a short, a float, and a double are added together giving a double result. 





// keyword_double.jsl 
// Mixing types in expressions 
public class MixedTypes 


{ 
public static void main(String[] args) 
{ 
int x = 3; 
float y = 4.5f; 
short z = 5; 
double w = 1.7E+3; 
// Double result. 
System.out.printin("The sum is " + (x + y + z + w))3 
} 
Output 


The sum is 1712.5 
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float (Visual J#) 


The float keyword denotes a simple type that stores 32-bit floating-point values. The following table shows the precision and 
approximate range for the float type. 

















Type Approximate range Precision 
float -3.4E38 to 3.4E38 7 digits 
Literals 


By default, a real numeric literal on the right-hand side of the assignment operator is treated as double. Therefore, to initialize 
a float variable, use the suffix £ or F, for example: 





| 
float x = 3.5F; 


If you do not use the suffix in the previous declaration, you will get a compilation error because you are attempting to store a 
double value into a float variable. 


Conversions 


You can mix numeric integral types and floating-point types in an expression. In this case, the integral types are converted to 
floating-point types. The evaluation of the expression is performed according to the following rules: 


e If one of the floating-point types is double, the expression evaluates to double (or boolean in the case of relational or 
Boolean expressions). 


e If there is no double type in the expression, the expression evaluates to float (or boolean in the case of relational or 
Boolean expressions). 


A floating-point expression can contain the following sets of values: 


e Positive and negative zero 

e Positive and negative infinity 

e Not-a-Number value (NaN) 

e The finite set of nonzero values 


For more information on these values, refer to the IEEE Standard for Binary Floating-Point Arithmetic, available on the Web site 
http://www.ieee.org/. 


Example 1 
In the following example, an int, a short, and a float are included in a mathematical expression giving a float result. Notice 


that there is no double in the expression. 


// keyword_float.jsl 
// Mixing types in expressions 
class MixedTypes 


‘ 
public static void main(String [] args) 
{ 
int x = 3; 
float y = 4.5f; 
short z = 5; 
System.out.println("The result is " + (x*y/z)); 
} 
} 
| 
Output 


The result is 2.7 


See Also 
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int (Visual J#) 


The int keyword denotes an integral type that stores values according to the size and range shown in the following table. 


Type Range Se 





int -2,147,483,648 to 2,147,483,647 Signed 32-bit integer 


Literals 


You can declare and initialize a variable of the type int as follows: 


int myInt = 123; 


When an integer literal has no suffix, its type is the first of these types in which its value can be represented: int or long. In the 
previous example, it is of the type int. 


Conversions 


There is a predefined implicit conversion from int to long, float, or double. For example: 


// OK: implicit conversion to float 


float myFloat = 123; 








There is a predefined implicit conversion from byte, ubyte, short, Ulnt16, or char to int. For example, if you have a long 
variable, myLong, the following assignment statement will produce a compilation error without a cast: 


long myLong = 22; 

// Error: no implicit conversion from long. 
int myInt = myLong; 

// OK: explicit conversion. 

int myInt = (int)myLong; 








There is no implicit conversion from floating-point types to int. For example, the following statement generates a compiler 
error unless an explicit cast is used: 





// Error: no implicit conversion from double. 
int x = 3.0; 


// OK: explicit conversion. 
int y = (int)3.0; 





For information on arithmetic expressions with mixed floating-point types and integral types, see float (Visual J#) and 
double (Visual J#). 
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long (Visual J#) 


The long keyword denotes an integral type that stores values according to the size and range shown in the following table. 


Type Range See 


—9,223,372,036,854,775,808 to 9,223,372,036,854,775,807 Signed 64-bit integer 





Literals 


You can declare and initialize a long variable as follows: 


long myLong = 429496729; 


In the preceding declaration, the integer literal 429496729 is implicitly converted from int to long. If the integer literal does 
not fit into a long storage location, a compilation error will occur. 


You can also use the suffix L with the long type, like this: 





long myLong = 4294967296L; 











When you use the suffix L, the type of the literal integer is determined to be long. 


A common use of the suffix is with calling overloaded methods. Consider, for example, the following overloaded methods that 
use long and int parameters: 





public static void myMethod(int i) {} 
public static void myMethod(long 1) {} 





Using the suffix L guarantees that the correct type is called, for example: 





// Calling the method with the int parameter: 
MyClass.myMethod(5) ; 
// Calling the method with the long parameter: 
MyClass.myMethod(5L); 








You can use the long type with other numeric integral types in the same expression, in which case the expression is evaluated 
as long (or boolean in the case of relational or Boolean expressions). For example, the following expression evaluates as long: 


898L + 88 


Note 





You can also use the lowercase letter "I" as a suffix. However, the letter "I" 


ity. 


is easily confused with the digit "1." Use "L" for clar 








For information on arithmetic expressions with mixed floating-point types and integral types, see float (Visual J#) and 
double (Visual J#). 


Conversions 


There is a predefined implicit conversion from long to float, or double. Otherwise, a cast must be used. For example, the 
following statement will produce a compilation error without an explicit cast: 





// Error: no implicit conversion from long to int: 
int x = 8L; 

// OK: explicit conversion to int: 

int x = (int)8L; 





There is a predefined implicit conversion from byte, ubyte, short, int, or char to long. 


Notice also that there is no implicit conversion from floating-point types to long. For example, the following statement 
generates a compiler error unless an explicit cast is used: 





// Error: no implicit conversion from double: 
long x = 3.0; 


// OK: explicit conversion: 
long y = (long)3.9; 
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short (Visual J#) 


The short keyword denotes an integral data type that stores values according to the size and range shown in the following 
table. 




















Type Range Size 
short -32,768 to 32,767 Signed 16-bit integer 
Literals 


You can declare and initialize a short variable like this example: 





short x = 32767; 











In the preceding declaration, the integer literal 32767 is implicitly converted from int to short. If the integer literal does not fit 
into a short storage location, a compilation error will occur. 


A cast must be used when calling overloaded methods. Consider, for example, the following overloaded methods that use 
short and int parameters: 





public static void myMethod(int i) {} 
public static void myMethod(short s) {} 


Using the short cast guarantees that the correct type is called, for example: 


// Calling the method with the int parameter: 
MyClass.myMethod(5) ; 

// Calling the method with the short parameter: 
MyClass.myMethod((short)5); 











Conversions 

There is a predefined implicit conversion from short to int, long, float, or double. 

You cannot implicitly convert nonliteral numeric types of larger storage size to short. Consider, for example, the following two 
short variables x and y: 


short x = 5, y = 12; 


The following assignment statement will produce a compilation error because the arithmetic expression on the right-hand side 
of the assignment operator evaluates to int by default. 





// Error: no conversion from int to short: 
short z = x + y3 





To fix this problem, use a cast: 


// OK: explicit conversion: 


short z = (short)(x + y)3 





It is possible, though, to use the following statements, where the destination variable has the same storage size or a larger 
storage size: 





int m = x + y3 
long n= x + y3 





There is no implicit conversion from floating-point types to short. For example, the following statement generates a compiler 
error unless an explicit cast is used: 





// Error: no implicit conversion from double: 
short x = 3.0; 

// OK: explicit conversion: 
short y = (short)3.@; 











For information on arithmetic expressions with mixed floating-point types and integral types, see float (Visual J#) and 
double (Visual J#). 
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ubyte (Visual J#) 


The ubyte keyword denotes an integral type that stores values as indicated in the ae table. 





ubyte to 255 Unsigned 8-bit integer 


Literals 


You can declare and initialize a ubyte variable like this example: 
ubyte myByte = 255; 
In the preceding declaration, the integer literal 255 is implicitly converted from int to ubyte. If the integer literal exceeds the 
range of ubyte, a compilation error will occur. 
Conversions 


There is a predefined implicit conversion from ubyte to short, int, long, float, or double. 


You cannot implicitly convert nonliteral numeric types of larger storage size to ubyte. Consider, for example, the following two 
ubyte variables x and y: 


ubyte x = 10, y = 20; 


The following assignment statement will produce a compilation error, because the arithmetic expression on the right-hand side 
of the assignment operator evaluates to int by default. 





// Error: conversion from int to ubyte: 
ubyte Zz = X + y3 


To fix this problem, use a cast: 


// OK: explicit conversion: 
ubyte z = (ubyte)(x + y)3; 











It is possible, though, to use the following statements, where the destination variable has the same storage size or a larger 
storage size: 


int x = 10, y = 20; 


int m = xX + y3 
long n= x + y3 





Also, there is no implicit conversion from floating-point types to ubyte. For example, the following statement generates a 
compiler error unless an explicit cast is used: 





// Error: no implicit conversion from double 
ubyte x = 3.0; 

// OK: explicit conversion: 

ubyte y = (ubyte)3.@; 











When calling overloaded methods, a cast must be used. Consider, for example, the following overloaded methods that use 
ubyte and int parameters: 





public static void myMethod(int i) {} 
public static void myMethod(ubyte b) {} 





Using the ubyte cast guarantees that the correct type is called. For example: 





// Calling the method with the int parameter. 
MyClass.myMethod(5) ; 


// Calling the method with the ubyte parameter. 
MyClass.myMethod((ubyte)5) ; 





For information on arithmetic expressions with mixed floating-point types and integral types, see float (Visual J#) and 
double (Visual J#). 
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Selection Statements (Visual J#) 


A selection statement causes the program control to be transferred to a specific flow based upon whether a certain condition is 
true or not. 


The following keywords are used in selection statements: 
if (Visual J#) 


switch (Visual J#) 
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if (Visual J#) 


The if statement selects a statement for execution based on the value of a Boolean expression. It takes the following form: 


if (expression) 
statement1 
[else 
statement2 ] 


Parameters 
expression 


An expression that can be implicitly converted to boolean. 
statement! 

The embedded statement or statements to be executed if expression is true. 
statement2 

The embedded statement or statements to be executed if expression is false. 
Remarks 


If expression is true, statement is executed. If the optional else clause exists and expression evaluates to false, statement2 is 
executed. After executing the if statement, control is transferred to the next statement. 


If any of the two results of the if statement (true or false) results in executing more than one statement, multiple statements 
can be conditionally executed by including them into blocks. 


The statement or statements to be executed upon testing the condition can be of any kind, including another if statement 
nested into the original if statement. In nested if statements, the else clause belongs to the last if that does not have a 
corresponding else. For example: 


if (x > 10) 
if (y > 20) 
System.out.printin("Statement_1"); 
else 
System.out.printlin("Statement_2"); 


In this example, Statement_2 will be displayed if the condition (y > 20) evaluates to false. However, if you want to associate 
Statement_2 with the condition (x >10), use braces: 


if (x > 10) 
{ 
if (y > 20) 
System.out.println("Statement_1"); 
} 


else 
System.out.println("Statement_2"); 


In this case, Statement_2 will be displayed if the condition (x > 10) evaluates to false 
Example 1 
In this example, the numbers from 0 to 5 are checked if they are odd or even and the result is displayed by using a for loop. 


// if-else1.jsl 
// if-else example 


public class MyClass 
{ 


public static void main(String[] args) 


{ 


for (int i = @3; i <= 53 i++) 
af 
if (Math. IEEEremainder(i, 2.0) == Q) 
System.out.println(i + " even"); 
else 
System.out.println(i + " odd"); 
} 
} 
} 
Output 
0 even 
1 odd 
2 even 
3 odd 
4 even 
5 odd 


It is also possible to extend the if statement to handle multiple conditions using the following else-if arrangement: 














if (Condition_1) 
Statement_1; 

else if (Condition 2) 
Statement_2; 

else if (Condition_3) 
Statement_3; 

else 
Statement_n; 

Example 2 


This example checks if the input character is lowercase, uppercase, or a number. Otherwise, it is not an alphanumeric character. 
The program makes use of the else-if ladder. 


// if-else2.jsl 
// if example 


public class IfTest 
{ 
public static void main(String[] args) 
{ 
try 
if 
System.out.print("Enter a character: "); 
int i = System.in.read(); 
char c (char)i; 


if (Character.isUpperCase(c)) 
System.out.println("The character 
else if (Character.isLowerCase(c)) 
System.out.println("The character 
else if (Character.isDigit(c)) 
System.out.println("The character 
else 
System.out.println("The character 


is uppercase."); 


is lowercase."); 


is a number."); 


is not alphanumeric."); 


} 


catch (Exception e) 


{ 
} 


// You may insert a catch statement or do nothing. 





Sample Output 





Enter a character: E 
The character is uppercase. 





Additional sample runs might look as follows: 


Run #2 





Enter a character: e 
The character is lowercase. 


Run #3: 


Enter a character: 4 
The character is a number. 











Run #4: 





Enter a character: $ 
The character is not alphanumeric. 





See Also 
Reference 
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switch (Visual J#) 


The switch statement is a control statement that handles multiple selections by passing control to one of the case statements 
within its body. It takes the following form: 


Switch (expression) 


{ 
case constant-expression: 
statement 
jump-statement 
[default: 
statement 
jump-statement ] 


Parameters 
expression 


An ordinal type (integral type or char or enum) expression. 
statement 
The embedded statement or statements to be executed if control is transferred to the case or the default. 
jump-statement 
A break statement that transfers control out of the case body. 
constant-expression 
Control is transferred to a specific case according to the value of this expression. 
Remarks 


Control is transferred to the case statement whose constant-expression matches expression. The switch statement can include 
any number of case instances, but no two case constants within the same switch statement can have the same value. 
Execution of the statement body begins at the selected statement and proceeds until the jump-statement transfers control out 
of the case body. 


The jump-statement parameter is required after each case block. Unlike the C++ switch statement, J# does not support an 
explicit fall through from one case label to another, unless the case statement has no code. 


If expression does not match any constant-expression, control is transferred to the statement or statements that follow the 
optional default label. If there is no default label, control is transferred outside the switch. 


Example 1 


// switch1.jsl 
// swicth example 
import java.io.*; 


class SwitchTest 


{ 


public static void main(String[] args) 

{ 
System.out.println("Coffee sizes: 1=Small 2=Medium 3=Large") ; 
System.out.print("Please enter your selection: "); 
int cost = Q; 


try 
{ 
char n = (char)System.in.read(); 
switch (n) 
{ 
case '1': 


cost = 25; 


break; 
case '2': 
cost = 50; 
break; 
case '3': 
cost = 75; 
break; 
default: 
System.out.printin 
("Invalid selection. Please select 1, 2, or 3."); 


if (cost != @) 
System.out.println("Please insert 
" cents."); 
System.out.println("Thank you for your business."); 


+ cost + 


} 
catch (IOException e) 
{ 
// You may insert a catch statement or do nothing. 
} 
} 
} 
Input 


2 


Sample Output 


Coffee sizes: 1=Small 2=Medium 3=Large 
Please enter your selection: 2 

Please insert 5@ cents. 

Thank you for your business. 


Code Discussion 


In the preceding example, a char type variable, n, was used for the switch cases. Notice that you can also use any ordinal 
variable, such as int. In this case, you can use switch cases like these: 


switch(s) 
{ 


case 1: 


case 2: 


Example 2 


The following sample shows that fall through from one case label to another is allowed for empty case labels. 


// switch2.jsl 
// switch example 


class SwitchTest 


{ 
public static void main(String[] args) 
{ 
int n = 1; 
switch(n) 
{ 
case 1: 
case 2: 
case 3: 
System.out.println("It's 3."); 
break; 


default: 


System.out.println("Not sure what it is."); 





Output 


Des: 3s 


See Also 
Reference 
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Reference Types (Visual J#) 


This section introduces the following keywords used to declare reference types: 
e class (Visual J#) 
e delegate (Visual J#) 


e interface (Visual J#) 


See Also 
Reference 
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class (Visual J#) 


Classes are declared using the keyword class, which takes the following form: 





[attributes] [modifiers] class identifier [extends super-class] [implements interface-list] 
{ class-body }[3;] 








Parameters 
attributes (Optional) 


Additional declarative information. 
modifiers (Optional) 

The allowed modifiers are abstract, final, private, protected and public, static and strictfp. 
identifier 

The class name. 
super-class (Optional) 

A base class that is inherited by this class. 
interface-list (Optional) 

Implemented interfaces, all separated by commas. 
class-body 

Declarations of the class members. 
Remarks 


Only single inheritance is allowed in J#. In other words, a class can extend one super class only. However, a class can 
implement more than one interface. The following table shows examples of class inheritance and interface implementation: 





Inheritance Example 

None class ClassA { } 

Single class DerivedClass extends BaseClass { } 

None, implements two interfaces class ImplClass implements IFacel, IFace2 { } 

Single, implements one interface class ImplDerivedClass extends BaseClass implements IFacel { } 








The access levels protected (Visual J#) and private (Visual J#) are only allowed on nested classes. 


A class can contain declarations of the member methods and fields (instance variables). A class can also include classes and 
interfaces. 


Example 1 


The following example demonstrates declaring class fields, constructors, and methods. It also demonstrates object instantiation 
and printing instance data. In this example, two classes are declared, the Kid class, which contains two private fields, name and 
age, and two public methods. The second class is MainClass, used for data processing. 


// keyword_class.jsl 
// class example 


public class Kid 
{ 


private int age; 
private String name; 











// Default constructor: 
public Kid() 
{ 


} 


name = "N/A"; 


// Constructor: 
public Kid(String name, int age) 
{ 

this.name = name; 

this.age = age; 


} 


// Printing method: 
public void PrintKid() 


t 
System.out.println(name + ", " + age + " years old."); 
} 
} 
public class MainClass 
{ 
public static void main(String[] args) 
{ 
// Create objects. 
// Objects must be created using the new operator: 
Kid kid1 = new Kid("Isabella", 4); 
Kid kid2 = new Kid("Angelina", 2); 
// Create an object using the default constructor: 
Kid kid3 = new Kid(); 
// Display results: 
System.out.print("Kid #1: "); 
kid1.PrintKid(); 
System.out.print("Kid #2: "); 
kid2.PrintKid(); 
System.out.print("Kid #3: "); 
kid3.PrintKid(); 
} 
} 
Output 


Kid #1: Isabella, 4 years old. 
Kid #2: Angelina, 2 years old. 
Kid #3: N/A, 0 years old. 


Notice, in the preceding example that the private fields, name and age, can only be accessed through the public methods of the 
Kid class. For example, you cannot print the kid's name from the Main method using a statement like this: 





// Error 
System.out.print (kidl.name); 


However, it is possible to do that if the Main method is a member of the kid class. 


Notice also that for the object created using the default constructor (kid3), the age field was initialized to zero. 


See Also 
Reference 
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delegate (Visual J#) 


The delegate keyword is used to declare a reference type that can be used to encapsulate a named method. Delegates are 
roughly similar to function pointers in C++; however, delegates are type-safe and secure. 


The declaration of a delegate type takes the following form: 


[attributes] [modifiers] delegate result-type identifier ([formal-parameters]); 


Parameters 
attributes (Optional) 


Additional declarative information. 
modifiers (Optional) 
The allowed modifiers are the access modifiers public, private, and protected. 
result-type 
The result type. If the delegate is associated with a named method, the result type must match the return type of the method. 
identifier 
The delegate name. 
formal-parameters (Optional) 
Parameter list. 
Remarks 


A delegate lets you pass a function as a parameter. The type safety of delegates requires the function you pass as a delegate 
to have the same signature as the delegate declaration. 


Delegates are the basis for events. 

Example 1 

The following is a simple example of declaring and using a delegate. 
// keyword_delegate_1.jsl 
// delegate declaration 


/** @delegate */ 
delegate void MyDelegate(int i); 


class Program 


{ 
public static void main(String[] args) 
{ 
Program p = new Program(); 
MyDelegate d = new MyDelegate(p.DelegateFunction) ; 
p.TakesADelegate(d) ; 
} 
public void TakesADelegate(MyDelegate SomeFunction) 
{ 
SomeFunction. Invoke(21) ; 
} 
public void DelegateFunction(int i) 
{ 
System.out.println( 
"Called by delegate with number: "+ i+ ".")3 
} 


Output 
Called by delegate with number: 21. 
Example 2 


In the following example, one delegate is mapped to both static and instance methods and returns specific information from 
each. 


// keyword_delegate_2.jsl 
// Calling both static and instance methods from delegates 


// Delegate declaration. 
/** @delegate */ 
delegate void MyDelegate(); 


public class MyClass 











. 
public void InstanceMethod() 
if 
System.out.println("A message from the instance method."); 
} 
static public void StaticMethod() 
{ 
System.out.println("A message from the static method."); 
} 
} 
public class MainClass 
{ 
static public void main(String[] args) 
MyClass p = new MyClass(); 
// Map the delegate to the instance method: 
MyDelegate d = new MyDelegate(p.InstanceMethod) ; 
d.Invoke(); 
// Map to the static method: 
d = new MyDelegate(MyClass.StaticMethod) ; 
d.Invoke(); 
} 
} 
Output 


A message from the instance method. 
A message from the static method. 


See Also 

Reference 
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interface (Visual J#) 


An interface defines a contract. A class that implements an interface must adhere to its contract. The declaration takes the 
following form: 


[attributes] [access-modifier] interface identifier [extends interface-list] {interface-bod 
y} 


Parameters 
attributes (Optional) 
Additional declarative information. 
access-modifier (Optional) 
The allowed modifiers are public, protected, private, abstract, static, strictfp. 
identifier 
The interface name. 
interface-list (Optional) 
A list that contains one or more comma-separated interfaces that are extended by the interface. 
interface-body 
Declarations of the interface members. 
Remarks 
An interface can be a member of a namespace or a class and may contain methods and fields (variables). 
Methods of interfaces are implicitly public and abstract. 
Fields of an interface must be initialized and are implicitly public, static, and final. 
An interface can extend one or more base interfaces. In the following example, the interface IMyInterface extends from two 


base interfaces, IBasel and IBase2: 


interface IMyInterface extends IBase1, IBase2 


{ 
void MethodA(); 


void MethodB(); 


Interfaces can be implemented by classes. A class can implement more than one interface. For example: 


class Class1 implements Iface1, Iface2 


{ 
} 


// Class members. 


It is possible to declare an interface object, which can be used to refer to objects that implement the interface. See the second 
of the following examples. 


Example 1 
The following example demonstrates interface implementation. In this example, the interface 1Point contains field declarations, 


and one method that displays the point object. 


// keyword_interface1.jsl 
// Interface implementation 


interface IPoint 


int x = @; 
int y = Q; 
void PrintPoint(); 


} 
class MyPoint implements IPoint 
if 
// Fields (variables): 
int x; 
int y; 
// Constructor: 
public MyPoint(int x, int y) 
sf 
this.x = x3 
this.y = y; 
} 
// An extra method that does not exist in the interface: 
public void PrintPoint() 
{ 
System.out.println("x=" + x + ", y="4+ y)3 
} 
} 
class MainClass 
{ 
public static void main(String[] args) 
{ 
MyPoint p = new MyPoint(2,3); 
System.out.print("My Point using a class object: "); 
p.PrintPoint(); // Using a class object. 
// Creating an interface reference: 
System.out.print("My Point using an interface object: 
IPoint ip = new MyPoint(2@, 30); 
// Using an interface object. 
ip.PrintPoint(); 
} 
} 
Output 


My Point using a class object: x=2, y=3 
My Point using an interface object: x=20, y=30 





See Also 
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Access Keywords (Visual J#) 


This section introduces the following access keywords: 
@ super (Visual J#) 
Accesses the members of the base class. 
e this (Visual J#) 


Refers to the current instance of the class. 


See Also 
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super (Visual J#) 


The super keyword is used to access members of the base class—super class—from within a derived class—subclass. Use the 
super keyword to: 


e Call a method on the base class that has been overridden by another method. 
e Specify which base-class constructor should be called when creating instances of the derived class. 
A super access is permitted only in a constructor, an instance method, or an instance property accessor. 
It is an error to use the super keyword from within a static method. 
Example 1 
In this example, both the base class, Person, and the derived class, Employee, have a method named Get info. By using the 


super keyword, it is possible to call the Get info method on the base class from within the derived class. 


// super1.jsl 
// Accessing base class members 


public class Person 


{ 
protected String ssn = "555-55-5555"; 
protected String name = "Isabella D. Abolrous"; 
public void GetInfo() 
{ 
System.out.println("Name: " + name); 
System.out.println("SSN: " + ssn); 
} 
} 
class Employee extends Person 
{ 
public String id = "ABC123EFG"; 
public void GetInfo() 
{ 
// Calling the base class GetInfo method: 
super.GetInfo(); 
System.out.println("Employee ID: " + id); 
} 
} 
class TestClass 
{ 
public static void main() 
{ 
Employee E = new Employee(); 
E.GetInfo(); 
} 
} 
Output 


Name: Isabella D. Abolrous 
SSN: 555-55-5555 
Employee ID: ABC123EFG 








Example 2 


This example shows how to specify the base-class constructor called when creating instances of a derived class. 


// super2.jsl 
// super keyword example 


public class MyBase 


{ 
int num; 
public MyBase() 
{ 
System.out.println("I am now in MyBase()."); 
public MyBase(int i) 
num = i; 
System.out.println("I am now in MyBase(int i), and num = " 
+ i); 
} 
} 
public class MyDerived extends MyBase 
{ 
public MyDerived() 
{ 
// This constructor will call MyBase.MyBase(). 
super(); 
} 
public MyDerived(int i) 
// This constructor will call MyBase.MyBase(int i). 
super(i); 
} 
public static void main() 
si 
MyDerived md = new MyDerived(); 
MyDerived md1 = new MyDerived(555); 
} 
} 
Output 
I am now in MyBase(). 
I am now in MyBase(int i), and num = 555 
See Also 
Reference 
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this (Visual J#) 


The this keyword refers to the current instance of the class. Static member functions do not have a this pointer. The this 
keyword can be used to access members from within constructors, instance methods, and instance accessors. 


The following are common uses of this: 


e To qualify members hidden by similar names, as follows: 


public Employee(String name, String alias) 


{ 
// Use this to qualify the fields, name and alias: 
this.name = name; 
this.alias = alias; 

} 


e To pass an object as a parameter to other methods, as follows: 


Tax.CalcTax(this) 


It is an error to refer to this in a static method, static property accessor, or variable initializer of a field declaration. 
Example 1 


In this example, this is used to qualify the Employee class members, name and alias, which are hidden by similar names. It is 
also used to pass an object to the method calcTax, which belongs to another class. 


// keywords_this.jsl 

// this example 

import java.math.BigDecimal ; 
public class Employee 


{ 
public String name; 
public String alias; 
public BigDecimal salary = new BigDecimal(3000.0@) ; 
// Constructor: 
public Employee(String name, String alias) 
1 
// Use this to qualify the fields, name and alias: 
this.name = name; 
this.alias = alias; 
} 
// Printing method: 
public void printEmployee() 
{ 
System.out.println("Name: " + name + "\nAlias: " + alias); 
// Passing the object to the CalcTax method by using this: 
System.out.println("Taxes: $" + Tax.CalcTax(this).setScale(2)); 
} 
} 
public class Tax 
{ 
public static BigDecimal CalcTax(Employee E) 
1 
return new BigDecimal(@.08 * E.salary.doubleValue()); 
} 
} 


public class MainClass 





{ 
public static void main(String[] args) 
{ 
// Create objects: 
Employee E1 = new Employee("John M. Trainer", "jtrainer"); 
// Display results: 
E1.printEmployee(); 
} 
} 
Output 


Name: John M. Trainer 
Alias: jtrainer 
Taxes: $240.00 


For additional examples, see class (Visual J#). 


See Also 
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J# Operators 


J# provides a large set of operators, which are symbols that specify which operations to perform in an expression. J# 
predefines the usual arithmetic and logical operators, as well as a variety of others as shown in the following table. 





Operator category 


Operators 





Arithmetic 


+ Operator (Visual J#) 
- Operator (Visual J#) 
* Operator (Visual J#) 
/ Operator (Visual J#) 


% Operator (Visual J#) 





Logical (boolean and bitwise) 


String concatenation 


Increment, decrement 


& Operator (Visual J#) 

| Operator (Visual J#) 

“ Operator (Visual J#) 

! Operator (Visual J#) 

~ Operator (Visual J#) 
&& Operator (Visual J#) 


|| Operator (Visual J#) 


+ Operator (Visual J#) 


++ Operator (Visual J#) 


-- Operator (Visual J#) 











Shift << Operator (Visual J#) 
>> Operator (Visual J#) 
>>> Operator (Visual J#) 

Relational == Operator (Visual J#) 


!= Operator (Visual J#) 
< Operator (Visual J#) 
> Operator (Visual J#) 
<= Operator (Visual J#) 


>= Operator (Visual J#) 








Assignment 


Member access 
Indexing arrays 
Cast 
Conditional 


Object creation 





= Operator (Visual J#) 
+= Operator (Visual J#) 
-= Operator (Visual J#) 
*= Operator (Visual J#) 
/= Operator (Visual J#) 
%= Operator (Visual J#) 
&= Operator (Visual J#) 
|= Operator (Visual J#) 
!= Operator (Visual J#) 
<<= Operator (Visual J#) 


>>= Operator (Visual J#) 


. Operator (Visual J#) 

[] Operator (Visual J#) 
() Operator (Visual J#) 
?: Operator (Visual J#) 


new Operator 


instanceof Operator 





See Also 
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>= Operator (Visual J#) 


All primitive numeric types define a "greater than or equal" relational operator (>=) that returns true if the first operand is 
greater than or equal to the second, false otherwise. 


expr1 >= expr2 
Parameters 
expr1 
An expression of primitive numeric type. 
expr2 
An expression of primitive numeric type. 
Remarks 


If the promoted type of the operands is int or long, then signed integer comparison is performed; if this promoted type is 
float or double, then floating-point comparison is performed. 


Example 


// operator_greater_than_or_equal.jsl 


class MyClass 


{ 
public static void main(String[] args) 
{ 
System.out.println(1.1 >= 1); 
System.out.printin(1.1 >= 1.1); 
} 
} 
Output 
true 
true 
See Also 
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&& Operator (Visual J#) 


The conditional AND operator (&&) performs a logical-AND of its boolean operands, but only evaluates its second operand if 
necessary. 


expr1 && expr2 
Parameters 
expr1 
An expression of boolean type. 
expr2 
An expression of boolean type. 
Remarks 


The operation: 


xX && y 


corresponds to the operation: 


x &y 


except that if x is false, y is not evaluated because the result of the AND operation is false no matter what the value of y may 
be. This is known as "short-circuit" evaluation. 


Example 
In the following example, observe that the expression using && evaluates only the first operand. 
// operator_logical_and.jsl 


class MyClass 


{ 

static boolean fn1() 

{ 
System.out.println("fn1 called"); 
return false; 

} 

static boolean fn2() 

{ 
System.out.println("fn2 called"); 
return true; 

} 

public static void main(String[] args) 

{ 
System.out.println("Regular AND:"); 
System.out.printin("Result is: " + (fn1() & fn2()))3 
System.out.println("Short-circuit AND:"); 
System.out.println("Result is: " + (fn1() && fn2())); 

} 

} 
Output 


Regular AND: 
fnl called 


fn2 called 

Result is: false 
Short-circuit AND: 
fnl called 
Result is: false 




















See Also 
Other Resources 
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% Operator (Visual J#) 


The modulus operator (%) computes the remainder after dividing its first operand by its second. All numeric types have 
predefined modulus operators. 





expri1 % expr2 





Parameters 
expr1 


An expression of primitive numeric type. 
expr2 
An expression of primitive numeric type. 


Example 





// operator_modulus.jsl 


class MyClass 
{ 


public static void main(String[] args) 

{ 
System.out.println(5 % 2); // int 
System.out.println(-5 % 2); // int 
System.out.print1n(5.0 % 2.2); // double 
System.out.printlin(5.ef % 2.2); // Float 








Output 


1 

-1 
0.59999999999999964 
0.5999999 


See Also 
Other Resources 
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- Operator (Visual J#) 


The - operator can function as either a unary or a binary operator. 


- expr 
expri1 - expr2 


Parameters 
expr 
An expression of primitive numeric type or enum type. 
expr7 
An expression of primitive numeric type. 
expr2 
An expression of primitive numeric type. 
Remarks 


Unary - operators are predefined for all numeric types and enum types. The result of a unary - operation on a numeric type is 
the negation of the operand. 


Binary - operators can be applied only on primitive numeric types and are predefined to subtract the second operand from the 
first. 


Example 


// operator_minus.jsl 
class MyClass 


{ 
public static void main(String[] args) 
1 
int a = 5; 
System.out.println(-a); 
System.out.println(a - 1); 
System.out.println(a - .5); 
} 
H 
Output 
=9 
4 
4.5 
See Also 


Other Resources 
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-- Operator (Visual J#) 


The decrement operator (--) decrements its operand by 1. The decrement operator can appear before or after its operand: 


-- var 
var -- 


Parameters 
var 


An expression of primitive numeric type. 
Remarks 


The first form is a prefix decrement operation. The result of the operation is the value of the operand after it has been 
decremented. 


The second form is a postfix decrement operation. The result of the operation is the value of the operand before it has been 
decremented. 


A variable that is declared final cannot be used as the operand of a decrement operator. 
Example 


// operator_decrement.jsl 


class MyClass 


{ 
public static void main(String[] args) 
1 
double x; 
x = 1.5; 
System.out.println(--x); 
x = 1.5; 
System.out.println(x--); 
System.out.println(x) ; 
} 
} 
Output 
0 55 
ue) 
O53 
See Also 
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|| Operator (Visual J#) 


The conditional-OR operator (||) performs a logical OR of its boolean operands, but only evaluates its second operand if 
necessary. 


expri || expr2 





Parameters 
expr7 


An expression of boolean type. 
expr2 

An expression of boolean type. 
Remarks 


The operation: 
x Il y 
corresponds to the operation: 


x | y 








except that if x is true, y is not evaluated because the result of the OR operation is true no matter what the value of y might be. 
This is known as "short-circuit" evaluation. 


Example 


In the following example, observe that the expression using || evaluates only the first operand. 














// operator_short_circuit_OR.jsl 
class MyClass 
{ 
static boolean fn1() 
{ 
System.out.println("fn1 called"); 
return true; 
} 
static boolean fn2() 
{ 
System.out.println("fn2 called"); 
return false; 
} 
public static void main(String[] args) 
{ 
System.out.println("Regular OR:"); 
System.out.println("Result is: " + (fn1() | fn2())); 
System.out.printlin("Short-circuit OR:"); 
System.out.println("Result is: " + (fn1() || £n2())); 
} 
} 
Output 


Regular OR: 
fnl called 


fn2 called 
Result is: true 
Short-circuit OR: 
fnl called 
Result is: true 

















See Also 
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~ Operator (Visual J#) 


The ~ operator performs a bitwise complement operation on its operand. 





~ expr 
Parameters 
expr 
An expression of primitive integral type. 


Example 





// operator_bitwise_compl.jsl 
class MyClass 


public static void main(String[] args) 











{ 
System.out.printlin("~" + 8 + "= " + 8); 
System.out.printlin("~" + -8 + "= " + ~-8); 
} 
} 
Output 
~8 = -9 
~-8 = 7 
See Also 


Other Resources 
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> Operator (Visual J#) 


All numeric types define a “greater than" relational operator (>) that returns true if the first operand is greater than the second, 
false otherwise. 


expri1 > expr2 
Parameters 
expr1 
An expression of primitive numeric type. 
expr2 
An expression of primitive numeric type. 
Remarks 


If the promoted type of the operands is int or long, then signed integer comparison is performed; if this promoted type is 
float or double, then floating-point comparison is performed. 


Example 


// operator_greater_than.jsl 


class MyClass 


{ 
public static void main(String[] args) 
{ 
System.out.println(1.1 > 1); 
System.out.printin(1.1 > 1.1); 
} 
} 
Output 
true 
false 
See Also 


Other Resources 
J# Operators 


Visual J# Reference 


== Operator (Visual J#) 


For primitive numeric types, enum types, value types, and boolean types, the equality operator (==) returns true if the values 
of its operands are equal, false otherwise. For reference types, including java.lang.String, == returns false if its two operands 
refer to different objects, even if they contain identical values. For string constants, however, == compares the values of the 
strings and returns true if the two strings are identical. 


expri1 == expr2 
Parameters 
expr7 
An expression of primitive numeric type, enum type, value type, boolean type, or reference type. 
expr2 
An expression of primitive numeric type, enum type, value type, boolean type, or reference type. 
Remarks 


If the promoted type of the operands is int or long, then an integer equality test is performed; if the promoted type is float or 
double, then a floating-point equality test is performed. 


If the operands of an equality operator are both of type boolean, then the operation is boolean equality. 
If the operands of an equality operator are both of reference type or the null type, then the operation is object equality. 
If the operands of an equality operator are both of value type, then the operation is value equality. 
Example 
// operator_equality.jsl 


class MyClass 


{ 
public static void main(String[] args) 
{ 
// Numeric equality: 
System.out.println((2 + 2) == 4); // true 
// Reference equality: different Objects, same value. 
String s = new String("1"); 
String t = new String("1"); 
System.out.println(s == t); // false 
// Define some Strings: 
String a = "hello"; 
String b = String.Copy(a); 
String c = "hello"; 
// Compare string values for a constant values. 
// true 
System.out.println(a == c); 
// Compare String objects; 
// a is a constant but b is an object: 
System.out.println(a == b); // false 
} 
} 

Output 

true 

false 

true 

false 





See Also 

Reference 

!= Operator (Visual J#) 
Other Resources 

J# Operators 
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< Operator (Visual J#) 


All primitive numeric types define a "less than" relational operator (<) that returns true if the first operand is less than the 
second, false otherwise. 


expri1 < expr2 
Parameters 
expr1 
An expression of primitive numeric type. 
expr2 
An expression of primitive numeric type. 
Remarks 


If the promoted type of the operands is int or long, then signed integer comparison is performed; if this promoted type is 
float or double, then floating-point comparison is performed. 


Example 


// operator_less_than.jsl 


class Test 


{ 
public static void main(String[] args) 
{ 
System.out.printin(1 < 1.1); 
System.out.printin(1.1 < 1.1); 
} 
} 
Output 
true 
false 
See Also 


Other Resources 
J# Operators 
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| Operator (Visual J#) 


Binary | operators are predefined for the integral primitive types, enum types, and boolean types. For integral primitive types 
and enum types, | computes the bitwise OR of its operands. For boolean operands, | computes the logical OR of its operands; 
that is, the result is false only if both its operands are false. 


expr1 | expr2 
Parameters 
expr1 
An expression of primitive integral type, enum type, or boolean type. 
expr2 
An expression of primitive integral type, enum type, or boolean type. 
Example 


// operator_OR.jsl 


class MyClass 


{ 
public static void main(String[] args) 
{ 
// Logical or: 
System.out.println(true | false); 
// Logical or: 
System.out.println(false | false); 
// Bitwise or: 
System. out.println(Integer.toHexString(@xf8 | @x3f)); 
} 
} 
Output 
true 
false 
ff 
See Also 


Other Resources 
J# Operators 
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+ Operator (Visual J#) 


The + operator can function as either a unary or a binary operator. 


+ expr 
expr1 + expr2 


Parameters 
expr 

An expression of primitive numeric type or enum type. 
expr7 

An expression of primitive numeric type or String type. 
expr2 

An expression of primitive numeric type or String type. 
Remarks 


Unary + operators are predefined for all numeric types and enum types. The result of a unary + operation on a numeric type 
or enum type is simply the value of the operand. 


Binary + operators are predefined for numeric and string types. For numeric types, + computes the sum of its two operands. If 
the promoted type of the expression is int or long, then integer arithmetic is performed; if this promoted type is float or 
double, then floating-point arithmetic is performed. 


When one or both operands are of type String, + concatenates the string representations of the operands. 
Example 


// operator_plus.jsl 


class MyClass 


{ 
public static void main(String[] args) 
if 
// Unary plus: 
System.out.println(+5) ; 
// Addition: 
System.out.println(5 + 5); 
// Addition: 
System.out.println(5 + .5); 
// String concatenation. 
// Note automatic conversion from double to string: 
System.out.printin("5" + "5"); 
} 
} 
Output 
S) 
10 
Ds 
Gis) 
See Also 


Other Resources 
J# Operators 
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>> Operator (Visual J#) 


The signed right-shift operator (>>) shifts its first operand right by the number of bits specified by its second operand. 


expr >> count 
Parameters 
Expr 
An expression of primitive integral type; the value to be shifted. 
Count 
An expression of primitive integral type; the shift count. 
Remarks 


If the promoted type of expr is an int (32-bit quantity), the shift count is given by the low-order five bits of count (count & 
Ox1f). 


If the promoted type of expr is a long (64-bit quantity), the shift count is given by the low-order six bits of count (count & 
Ox3f). 


The signed right-shift is an arithmetic shift with sign-extension. 
Example 

// operator_right_shift.jsl 

class MyClass 


public static void main(String[] args) 


{ 
int i = -1000; 
System.out.println(i >> 3); 
} 
} 
Output 
-125 
See Also 
Reference 


<< Operator (Visual J#) 
Other Resources 
J# Operators 
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<< Operator (Visual J#) 


The left-shift operator (<<) shifts its first operand left by the number of bits specified by its second operand. 


expr << count 


Parameters 
expr 


An expression of primitive integral type; the value to be shifted. 
count 
An expression of primitive integral type; the shift count. 
Remarks 
If the promoted type of expr is an int, the shift count is given by the low-order five bits of count (count & Oxf). 
If the promoted type of expr is a long, the shift count is given by the low-order six bits of count (count & 0x3f). 
The high-order bits of expr are discarded and the low-order empty bits are zero-filled. Shift operations never cause overflows. 
Example 


// operator_left_shift.jsl 


class MyClass 


{ 
public static void main(String[] args) 
{ 
int i = 1; 
long lg = 1; 
// Shift and convert to hexadecimal: 
System.out.println(Integer.toHexString(i << 1)); 
System.out.println(Integer.toHexString(i << 33)); 
System.out.println(Integer.toHexString((int)lg << 33)); 
} 
} 
Output 
2 
2 
2 


Note that i<<1 and i<<33 give the same result, because 1 and 33 have the same low-order five bits. 


See Also 

Reference 

>> Operator (Visual J#) 
Other Resources 

J# Operators 
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* Operator (Visual J#) 


The multiplication operator (*) computes the product of its operands. 


expri * expr2 
Parameters 
expr1 
An expression of primitive numeric type. 
expr2 
An expression of primitive numeric type. 
Remarks 


All numeric types have predefined multiplication operators. If this promoted type is int or long, then integer arithmetic is 
performed; if this promoted type is float or double, then floating-point arithmetic is performed. 


Example 


// operator_mult.jsl 


class MyClass 


i 
public static void main(String[] args) 
{ 
System.out.printin(5 * 2); 
System.out.printin(-.5 * .2); 
} 
} 
Output 
10 
=0.2 
See Also 


Other Resources 
J# Operators 


Visual J# Reference 


“ Operator (Visual J#) 


Binary “ operators are predefined for the primitive types, enum types, and boolean. For primitive types and enum types, * 
computes the bitwise exclusive-OR of its operands. For boolean operands, * computes the logical exclusive-OR of its 
operands; that is, the result is true only if exactly one of its operands is true. 


expri1 * expr2 
Parameters 
expr1 
An expression of primitive integral type, or enum type, or boolean type. 
expr2 
An expression of primitive integral type, or enum type, or boolean type. 
Example 


// operator_bitwise OR.jsl 


class MyClass 


{ 
public static void main(String[] args) 
{ 
// Logical exclusive-OR: 
System.out.println(true * false); 
// Logical exclusive-OR: 
System.out.println(false * false); 
// Bitwise exclusive-OR (converted to hexadecimal): 
System.out.println(Integer.toHexString(@xf8 * Ox3f)); 
} 
} 
Output 
true 
false 
on 
See Also 


Other Resources 
J# Operators 
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& Operator (Visual J#) 


The & operator can function as a logical or a bitwise AND operator. 


expr1 & expr2 


Parameters 
expr1 


An expression of primitive numeric type, or enum type, or boolean type. 
expr2 

An expression of primitive numeric type, or enum type, or boolean type. 
Remarks 


Binary & operators are predefined for the primitive numeric types, enum types and boolean types. For primitive types and 
enum types, & computes the bitwise AND of its operands. For boolean operands, & computes the logical AND of its operands; 
that is, the result is true if and only if both its operands are true. 


The & operator evaluates both operators regardless of the first one's value. For example: 


int i = 0; 

if (false & ++i == 1) 

System.out.printin("You won't get this output (the expression is false), but i == 1"); 
Example 


// operator_ampersand.jsl 


class MyClass 


{ 
public static void main(String[] args) 
sf 
// Logical and: 
System.out.println(true & false); 
// Logical and: 
System.out.printlin(true & true); 
// Bitwise and (converted to hexadecimal): 
System.out.println(Integer.toHexString(Oxf8 & Ox3f)); 
} 
} 
Output 
false 
true 
38 
See Also 


Other Resources 
J# Operators 
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<= Operator (Visual J#) 


All primitive numeric types define a "less than or equal" relational operator (<=) that returns true if the first operand is less 
than or equal to the second, false otherwise. 


expri1 <= expr2 
Parameters 
expr1 
An expression of primitive numeric type. 
expr2 
An expression of primitive numeric type. 
Remarks 


If the promoted type of the operands is int or long, then signed integer comparison is performed; if this promoted type is 
float or double, then floating-point comparison is performed. 


Example 


// operator_less_than_or_equal.jsl 


class MyClass 


{ 
public static void main(String[] args) 
{ 
System.out.printin(1 <= 1.1); 
System.out.printin(1.1 <= 1.1); 
} 
} 
Output 
true 
true 
See Also 


Other Resources 
J# Operators 
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/ Operator (Visual J#) 


The division operator (/) divides its first operand by its second. All primitive numeric types have predefined division operators. 





expri1 / expr2 
Parameters 
expr1 
An expression of primitive numeric type. 
expr2 


An expression of primitive numeric type. 








Remarks 
Example 
// operator_division.jsl 
class MyClass 
{ 
public static void main(String[] args) 
{ 
System.out.println(-5/2); 
System.out.println(-5.0/2); 
} 
; 
Output 
-2 
2235 
See Also 


Other Resources 
J# Operators 
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++ Operator (Visual J#) 


The increment operator (++) increments its operand by 1. The increment operator can appear before or after its operand, as 
follows: 


++ var 
var ++ 


Parameters 
Var 


An expression of primitive numeric type. 
Remarks 


The first form is a prefix increment operation. The result of the operation is the value of the operand after it has been 
incremented. 


The second form is a postfix increment operation. The result of the operation is the value of the operand before it has been 
incremented. 


A variable that is declared final cannot be used as the operand of an increment operator. 
Example 


// operator_increment.jsl 


class MyClass 


{ 
public static void main(String[] args) 
i 
double x; 
x = 1.5; 
System.out.println(++x) ; 
x = 1.5; 
System.out.println(x++) ; 
System.out.println(x) ; 
} 
} 
Output 
25 
5 
2.5 
See Also 


Other Resources 
J# Operators 
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!= Operator (Visual J#) 


The inequality operator (!=) returns false if its operands are equal, true otherwise. 


expri1 != expr2 
Parameters 
expr1 
An expression. 
expr2 
An expression. 
Remarks 


For primitive types, enum types, and value types, the inequality operator (!=) returns true if the values of its operands are 
different, false otherwise. For reference types (including String), or the null type, != returns true if its two operands refer to 
different objects. For the String type, however, it is possible to create objects by assigning the string literal to the variable 
directly. In this case, != compares the values of the strings and returns false if they are identical. 


Example 
// operator_inequality.jsl 


class MyClass 


{ 
public static void main(String[] args) 
{ 
// Numeric inequality: 
System.out.println(4 != (2 + 2)); // false 
// Reference equality: different objects, same value: 
String s = new String("1"); 
String t = new String("1"); 
// Compare the two objects: 
// true 
System.out.printlin(s != t); 
// String equality: different variables, same value: 
String a = "hello"; 
String b = "hello"; 
// Compare the two strings: 
System.out.println(a != b); // false 
} 
Output 
false 
true 
false 
See Also 
Reference 


== Operator (Visual J#) 
Other Resources 
J# Operators 


Visual J# Reference 


! Operator (Visual J#) 


The logical complement operator (!) is a unary operator that complements its operand. It is defined for boolean and returns 
true only if its operand is false. 


! expr 





Parameters 
expr 


An expression of boolean type. 


Example ee 








// operator_negation.jsl 
class Test 
{ 
public static void main(String[] args) 
{ 
System.out.println(!true) ; 
System.out.println(!false) ; 
} 
} 
Output 
false 
true 
See Also 


Other Resources 
J# Operators 
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%= Operator (Visual J#) 


The modulus assignment operator. 





lhs %= expr 
Parameters 
lhs 
A storage location. 
expr 
An expression. 
Remarks 


An expression using the %= assignment operator, such as: 





xX “= y 











is equivalent to: 





X=xX%KYy 











except that x is only evaluated once. The % Operator (Visual J#) is predefined for numeric types to compute the remainder after 
division. 











Example 
Code 
// js_operator_modulus_assignment.jsl 
class Test 
, 
public static void main(String[] args) 
{ 
int a = 5; 
a %= 3; 
System. out.println(a) ; 
} 
} 
Output 
2 
See Also 
Reference 


% Operator (Visual J#) 
Other Resources 
J# Operators 
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() Operator (Visual J#) 


In addition to being used to specify the order of operations in an expression, parentheses are used to specify casts (type 
conversions): 


( type ) expr 





Parameters 


type 
The name of the type to which expr is to be converted. 
expr 
An expression. 
Remarks 
A cast explicitly converts a value from expr's type to type; the cast will fail if no such conversion is defined. 
Example 


The following program casts a double to an int. The program will not compile without the cast. 





// js_operator_parentheses.jsl 
class Test 
{ 
public static void main(String[] args) 
{ 
double x = 1234.7; 
int a; 
// cast double to int: 
a = (int)x; 
System.out.println(a); 
} 
} 
Output 
1234 
See Also 


Other Resources 
J# Operators 
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*= Operator (Visual J#) 


The multiplication assignment operator. 





lhs *= expr 
Parameters 
lhs 
A storage location. 
expr 
An expression. 
Remarks 


An expression using the *= assignment operator, such as: 





x t= y 











is equivalent to the following: 





x=x *y 











except that x is only evaluated once. The * Operator (Visual J#) is predefined for numeric types to perform multiplication. 


Example SO 








// jS_operator_multiplication_assignment.js1l 
class Test 
{ 
public static void main(String[] args) 
{ 
int a = 5; 
a *= 6; 
System. out.print1n(a) ; 
} 
} 
Output 
30 
See Also 
Reference 


* Operator (Visual J#) 
Other Resources 
J# Operators 


Visual J# Reference 


. Operator (Visual J#) 


The member access operator. 


The dot operator (.) is used for member access. The dot operator specifies a method or class or other member within a 
package, or specifies a sub-package. The dot operator is used extensively to access specific methods within the J# Class 
Libraries, as in this example: 


// class System in package java.lang. 
java.lang.System.out.println("hello"); 





namel . name2 











Parameters 
name 


A package or type. 
name2 

A package, type, method, or field. 
Remarks 


For example, consider the following class: 


class Simple 


{ 
public int a; 
public void b() 
{ 
} 

} 


Simple s = new Simple(); 





The variable s has two members, a and b; to access them, use the dot operator: 





// Assign to field a: 

S.a = 6; 

// Invoke member function b: 
s.b(); 





The dot is also used to form qualified names, which are names that specify the package or interface, for example, to which they 
belong. 





// class System in package java.lang. 
java. lang.System.out.println("hello"); 


The import directive makes some name qualification optional: 





import java.lang.System; 


java. lang.System.out.println("hello"); 
// same thing 
System.out.println("hello") ; 








But when an identifier is ambiguous, it must be qualified: 





import java.lang.System; 














// A package containing another System class: 
import OtherSystem; 


// Must qualify System: 
java.lang.System.out.println( "hello" ); 





See Also 
Other Resources 
J# Operators 
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/= Operator (Visual J#) 


The division assignment operator. 





lhs /= expr 
Parameters 
ths 
A storage location. 
expr 
An expression. 
Remarks 


An expression using the /= assignment operator, such as: 





x /=y 











is equivalent to: 





x=x/y 











except that x is only evaluated once. The / Operator (Visual J#) is predefined for numeric types to perform division. 


Example OO 











// js_operator_division_assignment.jsl 
class Test 
{ 
public static void main(String[] args) 
{ 
int a = 5; 
a /= 6; 
System. out.printl1n(a) ; 
double b = 5; 
b /= 6; 
System.out.println(b) ; 
} 
} 
Output 
0 
0 .83333333333333337 
See Also 
Reference 


/ Operator (Visual J#) 
Other Resources 
J# Operators 
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?: Operator (Visual J#) 


The conditional operator (?:) returns one of two values depending on the value of a Boolean expression. The conditional 
operator is used in an expression of the following form: 





cond-expr ? expri1 : expr2 





Parameters 
cond-expr 


An expression of type boolean. 
expr1 

An expression. 
expr2 

An expression. 
Remarks 


If cond-expr is true, expr? is evaluated and becomes the result; if cond-expr is false, expr2 is evaluated and becomes the result. 
Only one of expr7 and expr2 is ever evaluated. 


Calculations that might otherwise require an if-else construction can be expressed more concisely and elegantly with the 
conditional operator. For example, to avoid a division by zero in the calculation of the sine function you could write either the 
following: 


if (x != 0.0) 
if 
s = Math.sin(x)/x;3 
} 
else 
{ 
s = 1.0; 
} 











Or, using the conditional operator: 





s = X != @.0 ? Math.sin(x)/x : 1.0; 





The conditional operator is right-associative, so an expression of the following form: 














is evaluated as: 





a?b: (c Pd: e) 











and not as: 


(a? b:c)?d:e 


The conditional operator cannot be overloaded. 


Example 





// js_operator_conditional.jsl 


class Test 


public static double sin(double x) 











{ 
return x != @.@ ? Math.sin(x)/x : 1.0; 

} 

public static void main(String[] args) 

{ 
System.out.println(sin(@.2)); 
System.out.println(sin(@.1)); 
System.out.println(sin(@.@)); 

} 

} 
Output 


0.99334665397530608 
0.99833416646828155 
1.0 


See Also 
Reference 

if (Visual J#) 
Other Resources 
J# Operators 
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[] Operator (Visual J#) 


Square brackets ([]) are used for declaring arrays and specifying an index within an array. 





type [] 
array [ indexexpr ] 











Parameters 


type 
A type. 
array 
An array. 
indexexpr 
An index expression. 
Remarks 
An array type is a type followed by []: 
// fib is of type int[], "array of int" 
int[] fib; 


// Create a 10@-element int array: 
fib = new int[100]; 





To access an element of an array, the index of the desired element is enclosed in brackets: 





fib[@] = fib[1] = 1; 
for (int i=2; 1<100; ++i) 


fib[i] = fib[i-1] + fib[i-2]; 











An exception is thrown if an array index is out of range. 


See Also 
Other Resources 
J# Operators 
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= Operator (Visual J#) 


The exclusive-OR assignment operator. 





lhs “= expr 
Parameters 
ths 
A storage location. 
expr 
An expression. 
Remarks 


An expression of the following form: 





x “= y 











is evaluated as the following: 





xXx=x%4 y 











except that x is only evaluated once. The “ Operator (Visual J#) performs a bitwise exclusive-OR operation on integral 
operands and logical exclusive-OR on boolean operands. 








Example 
// js_operator_xor_assignment.jsl 
class Test 
if 
public static void main(String[] args) 
i 
int a = @x@c; 
a *= 0x06; 
System.out.println("@x" + Integer.toHexString(a) ); 
boolean b = true; 
b “= false; 
System.out.println(b) ; 
} 
} 
Output 
Oxa 
true 
See Also 
Reference 


’ Operator (Visual J#) 
Other Resources 
J# Operators 
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|= Operator (Visual J#) 


The OR assignment operator. 





lhs |= expr 
Parameters 
ths 
A storage location. 
expr 
An expression. 
Remarks 


An expression using the |= assignment operator, such as: 





x |= y 











is equivalent to: 





x=x ly 











except that x is only evaluated once. The | Operator (Visual J#) performs a bitwise OR operation on integral operands and 
logical OR on boolean operands. 








Example 
// js_operator_or_assignment.jsl 
class Test 
if 
public static void main(String[] args) 
i 
int a = @x@c; 
a |= @x@6; 
System.out.printlin("@x" + Integer.toHexString(a) ); 
boolean b = true; 
b |= false; 
System.out.println(b) ; 
} 
} 
Output 
Oxe 
true 
See Also 
Reference 


| Operator (Visual J#) 
Other Resources 
J# Operators 
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+= Operator (Visual J#) 


The addition assignment operator. 





lhs += expr 
Parameters 
ths 
A storage location. 
expr 
An expression. 
Remarks 


An expression using the += assignment operator, such as: 





xX += y 











is equivalent to: 





x=xX+y 











except that x is only evaluated once. The meaning of the + Operator (Visual J#) is dependent on the types of x and y -- addition 
for numeric operands, concatenation for string operands, and so forth. 








Example 
// js_operator_addition_assignment.jsl 
class Test 
if 
public static void main(String[] args) 
i 
int a = 5; 
a += 6; 
System.out.println(a) ; 
String s = "Micro"; 
s += "soft"; 
System.out.println(s); 
} 
} 
Output 
11 
Microsoft 
See Also 
Reference 


+ Operator (Visual J#) 
Other Resources 
J# Operators 
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<<= Operator (Visual J#) 


The left-shift assignment operator. 





lhs <<= expr 
Parameters 
lhs 
A storage location. 
expr 
An expression. 
Remarks 


An expression of the form: 





X <<= y 











is evaluated as: 





x =x << y 











except that x is only evaluated once. The << Operator (Visual J#) shifts x left by an amount specified by y. 


Example ——————— 








// js_operator_left_shift_assignment.jsl 
class Test 
{ 
public static void main(String[] args) 
{ 
int a = 1000; 
a <<= 4; 
System.out.println(a) ; 
} 
} 
Output 
16000 
See Also 
Reference 


<< Operator (Visual J#) 
Other Resources 
J# Operators 
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= Operator (Visual J#) 


The assignment operator (=) stores the value of its right-hand operand in the storage location denoted by its left-hand 
operand and returns the value as its result. The operands must be of the same type (or the right-hand operand must be 
implicitly convertible to the type of the left-hand operand). 


lhs = expr 


Parameters 


lhs 

A storage location. 
expr 

An expression. 
Example 


// js_operator_assignment.jsl 


class Test 


{ 


public static void main(String[] args) 

{ 
double x; 
int i; 
// int to int assignment. 
i = 5; 
// Implicit conversion from int to double. 
x =i; 
// Needs cast: 
i = (int)x; 
System.out.printin("i is "+ i + 
Integer objInt = new Integer(i); 
System.out.println("boxed value = " + objInt + 

", class is " + objInt.getClass()); 

i = objiInt.intValue(); 
System.out.println( "unboxed: 


» X is + X)3 


+ i); 


Output 


iis 5, x is 5.0 
boxed value = 5, class is class java.lang.Integer 
unboxed: 5 


See Also 
Other Resources 
J# Operators 
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-= Operator (Visual J#) 


The subtraction assignment operator. 





lhs -= expr 
Parameters 
lhs 
A storage location. 
expr 
An expression. 
Remarks 


An expression using the -= assignment operator, such as: 





xX -=y 











is equivalent to the following: 














except that x is only evaluated once. 


Example SO 








// jS_operator_subtraction_assignment.jsl 
class Test 
{ 
public static void main(String[] args) 
{ 
int a = 5; 
a -= 6; 
System. out.println(a) ; 
} 
} 
Output 
SL 
See Also 
Reference 


- Operator (Visual J#) 
Other Resources 
J# Operators 
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>>= Operator (Visual J#) 


The right-shift assignment operator. 





lhs >>= expr 
Parameters 
lhs 
A storage location. 
expr 
An expression. 
Remarks 


An expression of the following form: 





X >= y 











is evaluated as follows: 





xX =X >> y 











except that x is only evaluated once. The >> Operator (Visual J#) shifts x right by an amount specified by y. 


Example ——————— 








// jSs_operator_right_shift_assignment.jsl 
class Test 
{ 
public static void main(String[] args) 
{ 
int a = 1000; 
a >>= 4; 
System. out.printl1n(a) ; 
} 
} 
Output 
62 
See Also 
Reference 
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>>> Operator (Visual J#) 


The unsigned right-shift operator (>>>) shifts its first operand right by the number of bits specified by its second operand. 





expr >>> count 
Parameters 
Expr 
An expression of primitive integral type; the value to be shifted. 
Count 
An expression of primitive integral type; the shift count. 
Remarks 


If the promoted type of expr is an int (32-bit quantity), the shift count is given by the low-order five bits of count (count & 
Ox1f). 


If the promoted type of expr is a long (64-bit quantity), the shift count is given by the low-order six bits of count (count & 
Ox3f). 


The unsigned right-shift is an arithmetic shift with zero-extension. 


Example EY 


// operator_right_shift.jsl 
class MyClass 


public static void main(String[] args) 











{ 
int i = -1000; 
System.out.println(i >>> 3); 
} 
} 
Output 
536870787 
See Also 
Reference 
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Visual J# Compiler 


The compiler produces executable (.exe) files, dynamic-link library (dll) files, and modules (.netmodule) files. 


Every compiler option is available in two forms: -option and /option. The documentation only shows the /option form. The - 
option form is equivalent. 


In This Section 
Building from the Command Line 


Information about building a Visual J# application from the command line. 
Visual J# Compiler Options Listed by Category 
A categorical listing of the compiler options. 
Visual J# Compiler Options Listed Alphabetically 
An alphabetical listing of the compiler options. 
Visual J++ Compiler Options Mapped to Visual J# Compiler Options 
Information on how compiler options in Visual J++® 6.0 map to compiler options in Visual J#. 
Compiler Errors VJSO001 Through VJS9999 


Documents the errors thrown by the Visual J# compiler. 


Related Sections 
Setting Visual J# Project Properties 


Lists the general steps for setting properties that govern how your project is compiled, built, and debugged. Includes 
information about custom build steps. 


Default and Custom Builds 
Includes information on build types and configurations. 
Preparing and Managing Builds 


Contains procedures for building within the Visual Studio® .NET development environment. 
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Building from the Command Line (Visual J#) 


The Visual J# compiler can be invoked at the command line by typing the name of its executable file (vjc.exe) on the command 
line. You may need to adjust your path if you want vjc.exe to be invoked from any subdirectory on your computer. 


If you are building and running Visual J# samples from the command line, run vsVars.bat, located in the <%Program 
Files%>\Microsoft Visual Studio 8\Common7\Tools directory. Alternatively, you can use the Visual Studio command prompt. 
To do so, click Start, point to All Programs, point to Microsoft Visual Studio, and then click Visual Studio Tools. 


Boolean options, such as /debug, can be enabled or disabled using + or - to enable or disable the option. For example, to 
enable debug information generation you can specify /debug+, or just /debug. 


At the command line, options and source code file names need not be in a particular order. 





4Note 





These .NET Framework libraries are referenced by default: vjslib.dll, vjscor.dll, vjslibcw.dll, mscorlib.dll, System.adll. 








Rules for Command-Line Syntax 


The Visual J# compiler code uses the following rules when interpreting arguments given on the operating system (OS) 
command line: 


e Arguments are delimited by white space, which is either a space or a tab. 


e The caret character (%) is not recognized as an escape character or delimiter. The character is handled completely by the 
command-line parser in the OS before being passed to the argv array in the program. 


e Astring surrounded by double quotation marks ("string") is interpreted as a single argument, regardless of white space 
contained within. A quoted string can be embedded in an argument. 


e A double-quotation mark preceded by a backslash (\") is interpreted as a literal double-quotation mark character ("). 
e Backslashes are interpreted literally, unless they immediately precede a double-quotation mark. 


e If an even number of backslashes is followed by a double-quotation mark, one backslash is placed in the argv array for 
every pair of backslashes, and the double-quotation mark is interpreted as a string delimiter. 


e If an odd number of backslashes is followed by a double-quotation mark, one backslash is placed in the argv array for 


every pair of backslashes, and the double-quotation mark is escaped by the remaining backslash, causing a literal 
double-quotation mark (") to be placed in argv. 


Sample Command Lines 


e Compiles Filejsl, producing File.exe: 


vjc File.jsl 


Compiles File,jsl, producing File.dll: 


vjc /target:library File.jsl 


Compiles File,jsl, producing My.exe: 
vjc /out:My.exe File.jsl 
e Compiles all jsl files in the current directory and defines the DEBUG symbol. The output is File2.exe: 


vjc /define:DEBUG /out:File2.exe *.jsl 


@ Compiles all Visual J# files in the current directory, producing a debug version of File2.dll. The short form of the /target 


option is used). No logo is displayed: 


vjc /t:l1 /out:File2.d1ll /nologo /debug *.jsl 





© Compiles all js! files in the current directory and all subdirectories, producing MyLibrary.dll: 


vjc /target:library /recurse:*.jsl /out:MyLibrary.dll 











© Compiles mainjsl, importing classes from MyLibrary.dll: 


vjc /reference:MyLibrary.dll main.jsl 


See Also 

Other Resources 

Visual J# Compiler 

Visual J# Compiler Options Listed Alphabetically 
Visual J# Compiler Options Listed by Category 
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Visual J# Compiler Options Listed by Category 


The following compiler options are sorted by category. For an alphabetical list, see 
Visual J# Compiler Options Listed Alphabetically. 


Optimization 
Option Purpose 
/optimize Enables or disables optimizations. 





Output Files 
Option Purpose 


/out Specifies output file. 
/target Specifies the format of the output file by using one of these options: 
/targetiexe 


/targetilibrary 
/target:module 


/target:winexe 








-NET Framework Assemblies 























Option Purpose 

/delaysignn Adds the cryptographic key but does not sign the assembly. 
/keycontainer Specifies the name of the cryptographic key container. 

/keyfile Specifies the file that contains the cryptographic key. 

/libpath Specifies the location of assemblies referenced by using /reference. 
/reference Imports metadata from a file that contains an assembly. 
/securescoping Makes package-scoped members internal to the assembly. 








Debugging/Error Checking 























Option Purpose 

/debug Emits debugging information. 

/nowarn Suppresses the compiler's ability to generate specified warnings. 
/warn Sets warning level. 

/warnaserror Promotes warnings to errors. 

Preprocessor 

Option Purpose 

/define Defines preprocessor symbols. 

Resources 

Option Purpose 


/linkresource Creates a link to a .NET Framework resource in the output file. 














/resource Embeds a .NET Framework resource into the output file. 





/win32res Inserts a Win32 resource into the output file. 





Miscellaneous 


Option Purpose 
@ Specifies a response file. 
/? Lists compiler options to stdout. 


/baseaddress |Specifies the preferred base address at which to load a DLL. 


/codepage _ |Specifies the code page to use for all source code files in the compilation. 











/help Lists compiler options to stdout. 

/jcpa Provides Java-language/COM package associations. This option works only with the /platform:x86 option. 
/main Specifies the location of the main method. 

/nologo Suppresses compiler banner information. 





/platform Specifies the platform type of the common language runtime (CLR) that can run the assembly. 





/recurse Searches subdirectories for source files to compile. 





/utf8output |Displays compiler output using UTF-8 encoding. 





/x Disables language extensions. 











See Also 

Reference 
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Visual J# Compiler Options Listed Alphabetically 


The following compiler options are sorted alphabetically. For a categorical list, see 
Visual J# Compiler Options Listed By Category. 




















/keycontainer 


/keyfile 


/libpath 


/linkresource 


Option Purpose 

@ Specifies a response file. 

/? Lists compiler options to stdout. 

/baseaddress_ Specifies the preferred base address at which to load a DLL. 

/codepage Specifies the code page to use for all source code files in the compilation. 

/debug Emits debugging information. 

/define Defines preprocessor symbols. 

/delaysign Adds the cryptographic key but does not sign the assembly. 

/help Lists compiler options to stdout. 

/jcpa Provides Java-language/COM package associations. This option works only with the /platform:x86 option. 


Specifies the name of the cryptographic key container. 
Specifies the file that contains the cryptographic key. 
Specifies the location of assemblies referenced by means of /reference. 


Creates a link to a .NET Framework resource in the output file. 











/main Specifies the location of the main method. 

/nologo Suppresses compiler banner information. 

/nowarn Suppresses the compiler's ability to generate specified warnings. 

/optimize Enables or disables optimizations. 

/out Specifies output file. 

/platform Specifies the platform type of the common language runtime (CLR) that can run the assembly. 
/recurse Searches subdirectories for source files to compile. 

/reference Imports metadata from a file that contains an assembly. 

/resource Embeds a .NET Framework resource into the output file. 








/securescoping |Makes package-scoped members internal to the assembly. 




















/target Specifies the format of the output file using one of these options: 
/target:exe 
/targetilibrary 
/target:module 
/target:winexe 
/utf8output Displays compiler output using UTF-8 encoding. 
/warn Sets warning level. 
/warnaserror |Promotes warnings to errors. 
/win32res Inserts a Win32 resource in the output file. 
Vos Disables language extensions. 
See Also 
Reference 
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@ (Specify Response File) (Visual J#) 


Used to specify a file that contains compiler options and source code files to compile. These compiler options and source code 
files will be processed by the compiler just as if they had been specified on the command line. 


@response_ file 


Arguments 
response_file 


A file that lists compiler options or source code files to compile. 
Remarks 


To specify more than one response file in a compilation, specify multiple response file options. For example: 


@filel.rsp @file2.rsp 


In aresponse file, multiple compiler options and source code files can appear on one line. A single compiler option 
specification must appear on one line (cannot span multiple lines). Response files can have comments that begin with the # 
symbol. 


Specifying compiler options from within a response file is just like issuing those commands on the command line. For more 
information, see Building from the Command Line (Visual J#). 


The compiler processes the command options as they are encountered. Therefore, command line arguments can override 
previously listed options in response files. Conversely, options in a response file will override options listed previously on the 
command line or in other response files. 


To set this compiler option in the vsprvs development environment 


e This compiler option is unavailable in vsprvs. 


To set this compiler option programmatically 
e This compiler option cannot be changed programmatically. 


Example 


The following are a few lines from a sample response file: 


# build the first output file 
/target:exe /out:MyExe.exe sourcel.jsl source2.jsl 


See Also 

Reference 

Advanced Build Settings Dialog Box (J#) 
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/baseaddress (Specify Base Address of DLL) (Visual J# ) 


Used to specify the preferred base address at which to load a DLL. 


/baseaddress:address 


Arguments 
address 


The base address for the DLL. This address must be specified as a hexadecimal number. 
Remarks 
The default base address for a DLL is set by the NET Framework common language runtime. 


Be aware that the lower-order word in this address will be rounded. For example, if you specify 0x11110001, it will be rounded 
to 0x11110000. 


This option is ignored if the target is not a DLL. 


To set this compiler option in the Visual Studio development environment 


1. Open the Project Designer. For details, see How to: Set Project Properties (C#, J#). 
2. Select the Build tab. 

3. Click Advanced. 

4. Modify DLL Base Address property. 


See Also 

Reference 

Advanced Build Settings Dialog Box (J#) 

Other Resources 

Visual J# Compiler Options Listed by Category 
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/codepage (Specify Code Page for Source Code Files) (Visual 
J#) 


Specifies which code page should be used if you compile one or more source code files that were not created to use the default 
code page on your computer. 


/codepage:id 
Arguments 
id 
The ID of the code page to use for all source code files in the compilation. 
Remarks 
/codepage applies to all source code files in your compilation. 


If the source code files were created with the same codepage that is in effect on your computer or if the source code files were 
created with UNICODE or UTF-8, you need not use /codepage. 


See GetCPInfo for information on how to find which code pages are supported on your system. 
To set this compiler option in the Visual Studio development environment 


1. Open the Project Designer. For details, see How to: Set Project Properties (C#, J#). 
2. Select the Build tab. 
3. Click Advanced. 


4. Modify the Code Page property. 
To set this compiler option programmatically 


e This compiler option cannot be changed programmatically. 


See Also 

Reference 

Advanced Build Settings Dialog Box (J#) 
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/debug (Emit Debugging Information) (Visual J#) 


Causes the compiler to generate debugging information and place it in the output file(s). Use this option to create debug 
builds. 


/debug[+ | -] 
/debug:{full | pdbonly} 


Arguments 
+|- 


Specifying +, or just /debug, causes the compiler to generate debugging information and place it in a program database 
(.pdb file). Specifying -, which is in effect if you do not specify /debug, causes no debug information to be created. 


full | pdbonly 


Specifies the type of debugging information generated by the compiler. The full argument, which is in effect if you do not 
specify /debug:pdbonly, enables attaching a debugger to the running program. Specifying pdbonly allows source code 
debugging when the program is started in the debugger but will only display assembler when the running program is 
attached to the debugger. 


Remarks 
lf /debug, /debug+, or /debug;full is not specified, you will not be able to debug the output file of your program. 


For information about how to configure the debug performance of an application, see Making an Image Easier to Debug. 


To set this compiler option in the Visual Studio development environment 


1. Open the Project Designer. For details, see How to: Set Project Properties (C#, J#). 
2. Select the Build tab. 
3. Click Advanced. 


4. In the Debug Info list box, select Generate full debugging info. 
To set this compiler option programmatically 


e See Installing Symbols for Debugging System Call Crashes. 


Example 


Place debugging information in output file app . pdb. 


vjc /debug /out:app.pdb test.jsl 


See Also 

Reference 
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/define (Preprocessor Definition) (Visual J#) 


Defines name as a symbol in your program. 


/define:name[=value][;name2[=value] ] 


Arguments 
name, name2 


The name of one or more symbols that you want to define. 
value 

The optional value you assign to the symbol. 
Remarks 


Using this option has the same effect as using a #define preprocessor directive in your source file. A symbol remains defined 
until an #undef directive in the source file removes the definition or the compiler reaches the end of the file. 


You can use symbols created by this option with #if, #else, #elif, and #endif to compile source files conditionally. 
/d is the short form of /define. 


You can define multiple symbols with /define by using a semicolon or comma to separate symbol names. For example: 


/define: DEBUG; TUESDAY 


To set this compiler option in the Visual Studio development environment 
1. Open the Project Designer. For details, see How to: Set Project Properties (C#, J#). 
2. Select the Build tab. 


3. Modify the Conditional Compilation Symbols property. 


To set this compiler option programmatically 
e See DefineConstants. 


Example 


// vwjc_compiler_define.jsl 

// compile with: /define:DEBUG 
// or uncomment the next line 
// #define DEBUG 

public class Test 


{ 
public static void main(String args[]) 
#if (DEBUG) 
System.Console.WriteLine("DEBUG defined"); 
#else 
System.Console.WriteLine("DEBUG not defined"); 
#endif 
} 
} 
Output 


DEBUG defined 





See Also 
Reference 
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/delaysign (Delay the Cryptographic Key Signing) 
Determines whether an assembly signature is stored or added later. 


/delaysign[+ | -] 





Arguments 
+|- 


Use /delaysign- if you want a fully signed assembly. Use /delaysign+ if you only want to place the public key in the 
assembly. The default is /delaysign-. 


Remarks 


The /delaysign option has no effect unless used with /keyfile (Specify Strong Name Key File) (C# Compiler Options) or 
/keycontainer (Specify Strong Name Key Container) (C# Compiler Options). 


When you request a fully signed assembly (either by omitting the option or by using /delaysign-), the compiler hashes the file 
that contains the manifest (assembly metadata) and signs that hash with the private key. The resulting digital signature is 
stored in the file that contains the manifest. When an assembly is delay signed, the compiler does not compute and store the 
signature, but reserves space in the file so the signature can be added later. 


For example, using /delaysign+ allows a tester to put the assembly in the global cache. After testing, you can fully sign the 
assembly by placing the private key in the assembly using the Assembly Linker (Al.exe) utility. 


For more information, see Creating and Using Strong-Named Assemblies. 
To set this compiler option in the Visual Studio development environment 


1. Open the Properties page for the project. For details, see How to: Set Project Properties (C#, J#). 
2. Click the Signing property page. 
3. Modify the Delay sign only property. 


For information on how to set this compiler option programmatically, see DelaySign. 


See Also 
Other Resources 
Visual J# Compiler 
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/help, /? (Compiler Command-Line Help) (Visual J#) 


Sends a listing of compiler options, and a brief description of each option, to stdout. 


/help 
/? 


Remarks 
If this option is included in a compilation, no output file will be created and no compilation will take place. 
To set this compiler option in the Visual Studio development environment 
e This compiler option is unavailable in Visual Studio. 
To set this compiler option programmatically 
e This compiler option cannot be changed programmatically. 
See Also 
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/jcpa (Associate Java-Language/COM Packages) 


Used when two or more COM DLLs accessed by the application contain coclasses or interfaces with the same name. This 
situation occurs when upgrading Visual J++ 6.0 Java-language/COM applications to Visual J#. 





/jcpa:package=namespace 
/jcpa:@filename 


Arguments 
package 


The name of the package of a COM class or interface. 
namespace 

The namespace in the managed wrapper to which you want to map the package. 
filename 


The file that contains one or more package=namespace associations. In the file, separate pairs either with a new line or with 
a semicolon. 


Remarks 


When compiling JActivex-generated wrappers for Java-language/COM sources, you may have a COM interface with the same 
name in more than one package. In such a case, the corresponding managed type for this COM interface will be present in 
multiple assemblies generated with the Type Library Importer tool (Tlbimp.exe). In this situation, vjc.exe will not be able to map 
these COM interfaces with the proper managed types and will give a compile time error; you can use /jcpa to resolve this 
conflict. 


See Overview: Upgrading Java-Language/COM Components for more information. 


The /jcpa compiler option is supported by the 64-bit Visual J# compiler only when specified with /platform:x86 option. 





To set this compiler option in the Visual Studio development environment 


1. Open the Project Designer. For details, see How to: Set Project Properties (C#, J#). 
2. Select the Build tab. 
3. Click Advanced. 


4. Modify the Java-COM Package Association property. 


To set this compiler option programmatically 
e This compiler option cannot be changed programmatically. 


Example 


Compile in.js1 and associate package x with namespace y: 


vjc /jcpa:x=y in.jsl 
| 


See Also 

Reference 
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/keycontainer (Specify Cryptographic Key Container) 


Specifies the name of the cryptographic key container. 


/keycontainer: string 





Arguments 
string 


The name of the strong name key container. 
Remarks 


When the /keycontainer option is used, the compiler creates a sharable component by inserting a public key from the 
specified container into the assembly manifest and signing the final assembly with the private key. To generate a key file, type 
sn -k file at the command line. sn -i installs the key pair into a container. 


If you compile with /target:module (Create Module to Add to Assembly) (Visual J#), the name of the key file is held in the 
module and incorporated into the assembly when you compile this module into an assembly. 


You can also pass your encryption information to the compiler with/keyfile (Specify Cryptographic Key Filename). Use 
/delaysign (Delay the Cryptographic Key Signing) if you want the public key added to the assembly manifest but want to delay 
signing the assembly until it has been tested. 


For more information, see Creating and Using Strong-Named Assemblies. 
To set this compiler option in the Visual Studio development environment 


e This compiler option is not available in the Visual Studio development environment. 


You can programmatically access this compiler option with AssemblyKeyContainerName. 


See Also 
Other Resources 
Visual J# Compiler 
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/keyfile (Specify Cryptographic Key Filename) 


Specifies the filename containing the cryptographic key. 


/keyfile:file 


Remarks 
file 


The name of the file containing the strong name key. 
Remarks 


When this option is used, the compiler inserts the public key from the specified file into the assembly manifest. Unless 
/delaysign+ is used, the final assembly is signed with the private key. To generate a key file, type sn -k file at the command 
line. 


If you compile with /target:module, the name of the key file is held in the module and incorporated into the assembly if the 
module is eventually compiled into an assembly. 


You can also pass your encryption information to the compiler with /keycontainer (Specify Cryptographic Key Container). Use 
/delaysign (Delay the Cryptographic Key Signing) if you want a partially signed assembly. 


In case both /keyfile and /keycontainer are specified (either by command line option or by custom attribute) in the same 
compilation, the compiler will first try the key container. If that succeeds, then the assembly is signed with the information in 
the key container. If the compiler does not find the key container, it will try the file specified with /keyfile. If that succeeds, the 
assembly is signed with the information in the key file and the key information will be installed in the key container (similar to 
sn -i) so that on the next compilation, the key container will be valid. 


A key file might contain only the public key. 


See Creating and Using Strong-Named Assemblies for more information on signing an assembly. 


To set this compiler option in the Visual Studio development environment 


1. Open the Properties page for the project. For details, see How to: Set Project Properties (C#, J#). 
2. Click the Signing property page. 
3. Modify the Choose a strong name key file property. 

You can programmatically access this compiler option with AssemblyOriginatorKeyFile. 


See Also 
Other Resources 
Visual J# Compiler Options Listed by Category 
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/libpath (Specify Assembly Reference Locations) 


Specifies the location of assemblies referenced by means of the /reference (Import Metadata) (Visual J#) option. 


/libpath:dir1i[; dir2] 
Arguments 
dir 


A directory for the compiler to look in if a referenced assembly is not found in the current working directory (the directory 
from which you are invoking the compiler) or in the common language runtime's system directory. 


dir2 


One or more additional directories to search in for assembly references. Separate additional directory names with a 
semicolon. 


Remarks 
/libpath prepends to the LIB environment variable. 
The compiler searches for assembly references that are not fully qualified in the following order: 
1. Current working directory. This is the directory from which the compiler is invoked. 
2. The common language runtime system directory. 
3. The Visual J# system directory. 
4. Directories specified by /libpath. 


5. Directories specified by the LIB environment variable. 


Use /reference (Import Metadata) (Visual J#) to specify an assembly reference. 

/libpath is additive; specifying it more than once appends to any prior values. 

An alternative to using /libpath is to copy into the working directory any required assemblies; this will allow you to simply 
pass the assembly name to /reference. You can then delete the assemblies from the working directory. 


To set this compiler option in the Visual Studio development environment 


1. Open the Project Designer. For details, see How to: Set Project Properties (C#, J#). 
2. Select the Reference Paths tab. 


3. Modify the contents of the Reference Path list box. 


Example 


Compile t2.4s1 to create an .exe file. The compiler will look in the working directory and in the assemblies directory of the C 
drive for assembly references. 


vjc /libpath:c:\assemblies /reference:t2.d1l t2.jsl 


See Also 

Reference 

Reference Paths Page, Project Designer (C#, J#) 
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/linkresource (Link to .NET Framework Resource) (Visual J#) 


Creates a link to a .NET Framework resource in the output file; the resource file is not placed in the output file. 


/linkresource: filename [, identifier ] 


Arguments 
filename 


The .NET Framework resource file to which you want to link from the assembly. 
identifier (optional) 


The logical name for the resource; the name used to load the resource. The default is the name of the file name. At most one 
logical name can be specified for a resource. 


Remarks 
/resource (Embed Resource File to Output) (Visual J# embeds a resource file in the output file. 
Linked resources are public in the assembly when created with the Visual J# compiler. 


/linkresource requires one of the /target (Specify Output File Format) (Visual J#) options other than 
/target:module (Create Module to Add to Assembly) (Visual J#). 


If filename is a .NET Framework resource file created, for example, by Resource File Generator (Resgen.exe) or in the 
development environment, it can be accessed with members in the System.Resources namespace (see 
System.Resources.ResourceManager for more information). For all other resources, use the GetManifestResource* methods 
in the System.Reflection.Assembly class to access the resource at run time. 


filename can be any file format. For example, you may want to make a native DLL part of the assembly, so it can be installed 
into the Global Assembly Cache and accessed from managed code in the assembly. 


/linkres is the short form of /linkresource. 
To set this compiler option in the Visual Studio development environment 


e This compiler option is unavailable in Visual Studio. 


To set this compiler option programmatically 
e This compiler option cannot be changed programmatically. 


Example 


Compile in.js1 and link to resource file rf. resource: 


vjc /linkresource:rf.resource in.jsl 
| 


See Also 
Other Resources 
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/main (Specify Location of main Method) (Visual J#) 


Specifies which class contains the main method you want to use as the entry point into the program if your compilation 
includes more than one class with a main method. 


/main:class 


Arguments 
Class 


The class that contains the main method. 
Remarks 
The class name specified in the argument can be a simple name or a fully qualified name that includes the package name. 


This option is for use when compiling an .exe file. 
To set this compiler option in the Visual Studio development environment 


1. Open the Project Designer. For details, see How to: Set Project Properties (C#, J#). 
2. Select the Application tab. 
3. Modify the Startup object property. 

Example 


Compile ClassA.js1 and ClassB. js1, specifying that the main method will be found in classa: 


vjc ClassA.jsl ClassB.jsl /main:ClassA 


See Also 

Reference 
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/nologo (Suppress Banner Information) (Visual J#) 


Suppresses display of the sign-on banner when the compiler starts up and display of informational messages during 
compiling. 


/nologo[+| -] 
Arguments 
a) 


Specifying /nologo+, or just /nologo, causes the compiler to not display banner information. Specifying /nologo-, which is 
in effect if you do not specify this compiler option, causes the banner to be displayed. 


Remarks 


This option is not available from within the development environment; it is only available when compiling from the command 
line. 


To set this compiler option in the Visual Studio development environment 
e This compiler option is unavailable in Visual Studio. 

To set this compiler option programmatically 
e This compiler option cannot be changed programmatically. 

See Also 


Other Resources 
Visual J# Compiler 


Visual J# Reference 


/nowarn (Suppress Specified Warnings) (Visual J#) 


Used to suppress the compiler's ability to generate one or more warnings. 


/nowarn:number1[,number2[...]] 


Arguments 
number7, number2 


A warning number that you want the compiler to suppress. 
Remarks 
Separate multiple warning numbers with a comma. 


You only need to specify the numeric part of the warning identifier. For example, if you want to suppress VJSO028, you could 
specify /nowarn: 28. 


To set this compiler option in the Visual Studio development environment 


1. Open the Project Designer. For details, see How to: Set Project Properties (C#, J#). 
2. Select the Build tab. 
3. Modify the Suppress Warnings property. 


See Also 

Reference 

Build Page, Project Designer (J#) 

Other Resources 

Visual J# Compiler Options Listed by Category 
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/optimize (Enable/Disable Optimizations) (Visual J#) 


Enables or disables optimizations performed by the compiler to make your output file smaller, faster, and more efficient. 
/optimize also tells the common language runtime to optimize code at run time. 


/optimize[+ | -] 
Arguments 
+|- 


By default, /optimize- is in effect. To prevent an optimized output file, specify /optimize-. Specifying /optimize is the same 
as specifying /optimize+. 


Remarks 
/o is the short form of /optimize. 


It is possible to combine the /optimize and /debug options. 

To set this compiler option in the Visual Studio development environment 
1. Open the Project Designer. For details, see How to: Set Project Properties (C#, J#). 
2. Select the Build tab. 
3. Modify the Optimize Code property. 


Example 


Compile t2.js1 and enable compiler optimizations: 
vjc t2.jsl /optimize 


See Also 

Reference 

Build Page, Project Designer JJ#) 

Other Resources 

Visual J# Compiler Options Listed by Category 
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/out (Set Output File Name) (Visual J#) 


Specifies the name of the output file. 


/out: filename 
Arguments 
filename 
The name of the output file created by the compiler. 
Remarks 
If you do not specify the name of the output file: 
e An EXE will take its name from the source code file that contains the entry point main method. 


e A DLL will take its name from the first source code file. 


Specify the full name and extension of the file you want to create. 
To set this compiler option in the Visual Studio development environment 


1. Open the Project Designer. For details, see How to: Set Project Properties (C#, J#). 
2. Select the Application tab. 


3. Modify the Assembly Name property. 

To set this compiler option programmatically 
e See OutputFileName. 

Example 


Compile t1.js1 and t2.4s1 and create output file app. exe: 


vjc t1.jsl t2.jsl /out:app.exe 


See Also 

Reference 

Application Page, Project Designer (Visual Basic) 
Other Resources 

Visual J# Compiler 


/platform (Specify Output Platform) (Visual J#) 


Specifies which version of the common language runtime (CLR) can run the assembly. This compiler option is supported on 
both the 32-bit and 64-bit versions of the Visual J# compiler. 


/platform:{x86 | x64 | Itanium | anycpu} 


Arguments 
anycpu 


Compiles your assembly to run on any platform. This is the default behavior when you select the 64-bit Visual J# compiler 
and when the /platform option is not specified. 


x86 


Compiles your assembly to be run by the 32-bit, x86-compatible CLR. This is the default behavior when you choose the 32- 
bit Visual J# compiler and when the /platform option is not specified. 


x64 
Compiles your assembly to be run by the 64-bit CLR on a computer that supports the x64 or EM64T instruction set. 
Itanium 
Compiles your assembly to be run by the 64-bit CLR on a computer that has an Itanium or IA64 processor. 
Remarks 
Use the /platform option to specify the type of processor that the output file targets. 
In general, .NET Framework assemblies written in Visual J# run the same regardless of the platform. 
On a 64-bit Windows operating system: 
e Assemblies compiled with /platform:x86 execute on the 32-bit CLR running under WOW64. 
e Executables compiled with the /platform:anycpu execute on the 64-bit CLR. 


e ADLL compiled with the /platform:anycpu executes on the same CLR as the process into which it loaded. 


For more information about how to develop an application that runs on a Windows 64-bit operating system, see 
64-bit Applications. 





Note 





To be compatible with the previous releases of Visual J# Redistributable, the code generated by the 32-bit Visual J# compiler 
that ships with Microsoft Visual J# 2.0 Redistributable Package — Second Edition targets the x86 platform by default. To run t 
he existing Visual J# applications natively on 64-bit platforms, rebuild the existing applications by using the /platform optio 
n and create anycpu or 64-bit platform-specific applications. 





Example 


The following example shows how to use /platform to specify that the application should only be run by the 64-bit CLR ona 
64-bit Windows operating system for Itanium. 


vjc /platform:Itanium myItanium.jsl 


See Also 
Other Resources 
Visual J# Compiler 
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/recurse (Find Source Files in Subdirectories) (Visual J#) 


Used to compile source code files in all child directories of either the specified directory (dir) or of the project directory. 


/recurse:[dir\]file 
Arguments 
dir (optional) 


The directory in which you want the search to begin. If this is not specified, the search begins in the project directory. 
Wildcard characters are not allowed. 


file 
The file(s) to search for. Wildcard characters are allowed. 
Remarks 


Only one dir\file combination can be specified with this option. If you want to specify another dir\file pair, use a separate 
/recurse option. 


You can use wildcards in a file name to compile all matching files in the project directory without using /recurse. 
To set this compiler option in the Visual Studio development environment 

e This compiler option is unavailable in Visual Studio. 
To set this compiler option programmatically 


e This compiler option cannot be changed programmatically. 


Example 


Compile all jsl source code files in the current directory: 
vjc *.jsl 

Compile all .jsl source code files in the dir1\dir2 directory and any directories below it and generate dir2.d11: 
vjc /target:library /out:dir2.d1ll /recurse:dir1\dir2\*.jsl 


See Also 
Other Resources 
Visual J# Compiler 
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/reference (Import Metadata) (Visual J#) 


Causes the compiler to make public type information in the specified files available to the project you are currently compiling. 


/reference: file[;file2] 


Arguments 
file, file2 


One or more files that contain an assembly manifest. To import more than one file, separate file names with either a comma 
or a semicolon. 


Remarks 


If you reference an assembly (Assembly A), which itself references another assembly (Assembly B), you will need to reference 
Assembly B if: 


e A type you use from Assembly A inherits from a type or implements an interface from Assembly B and you try to use a 
member of the base type/interface from Assembly B. 


e If you invoke a field, property, event, or method that has a return type or parameter type from Assembly B. 


Use /libpath (Specify Assembly Reference Locations) to specify the directory in which one or more of your assembly references 
is located. The /libpath topic also discusses which directories the compiler searches for assemblies. 


In order for the compiler to recognize a type in an assembly (not a module), it needs to be forced to resolve the type, which you 
can do, for example, by defining an instance of the type. There are other ways to resolve type names in an assembly for the 
compiler, for example, if you inherit from a type in an assembly, the type name will then become known to the compiler. 


/r is the short form of /reference. 

To set this compiler option in the Visual Studio development environment 
e@ See Add Reference Dialog Box. 

Example 


Compile source file input .js1 and import metadata from metad1.d11 and metad2.d11 to produce out.exe: 


vjc /reference:metad1.d11;metad2.d11 /out:out.exe input.jsl 


See Also 
Other Resources 
Visual J# Compiler Options Listed by Category 
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/resource (Embed Resource File to Output) (Visual J# 


Embeds the resource file in the output file. 


/resource:filename[, identifier ] 


Arguments 
filename 


The .NET Framework resource file you want to embed in the output file. 
identifier (optional) 


The logical name for the resource; the name used to load the resource. The default is the name of the file name. At most one 
logical name can be specified for a resource. 


Remarks 


Use /linkresource (Link to NET Framework Resource) (Visual J#) to link a resource to an assembly and not place the resource 
file in the output file. 


Resources are public in the assembly when created with the Visual J# compiler. 


If filename is a .NET Framework resource file created, for example, by Resource File Generator (Resgen.exe) or in the 
development environment, it can be accessed with members in the System.Resources namespace (see 
System.Resources.ResourceManager for more information). For all other resources, use the GetManifestResource* methods in 
the Assembly class to access the resource at run time. 


/res is the short form of /resource. 
To set this compiler option in the Visual Studio development environment 
1. Add a resource file to your project. 
2. Select the file you want to embed in Solution Explorer. 
3. In the Properties window, select Build Action for the resource file. 
4. Set Build Action to Embedded Resource. 


Example 


Compile in.js1 and attach resource file rf. resource: 


vjc /resource:rf.resource in.jsl 


See Also 
Other Resources 
Visual J# Compiler 
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/securescoping (Make Package-Scoped Members Inaccessible 
Outside Assembly) 


Used to restrict the scope for package scoped classes in a package. 


/securescoping[+ | -] 
Arguments 
+ |- 


By default, /securescoping- is in effect. To mark metadata for package-scoped items as public, specify /securescoping-. 
Specifying /securescoping+ is the same as specifying /securescoping. 


Remarks 


Classes are associated with packages. When the assembly containing a package is referenced in another compilation, package- 
scoped members are available to classes in a package with the same name. 


When the /securescoping option is specified, the package scope is treated as assembly scope when emitting metadata for a 
member. Note that package scoped members include members marked with the protected modifier. 


/ss is the short form of /securescoping. 
To set this compiler option in the Visual Studio development environment 


1. Open the Project Designer. For details, see How to: Set Project Properties (C#, J#). 
2. Select the Build tab. 
3. Click Advanced. 


4. Click Enable Secure Scoping. 
To set this compiler option programmatically 
e This compiler option cannot be changed programmatically. 
Example 
Compile source file input .js1 and make package types inaccessible when the assembly is referenced: 


vjc /securescoping /target:library input.jsl 


See Also 

Reference 

Advanced Build Settings Dialog Box (J#) 
Other Resources 

Visual J# Compiler 
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/target (Specify Output File Format) (Visual J#) 


The /target compiler option can be specified in one of four forms: 
/targetiexe 
Create a console .exe file. 
/targetilibrary 
Create a code library. 
/target:module 
Create a module. 
/target:winexe 
Create a Windows .exe file. 


/target causes a .NET Framework Assembly manifest to be placed in an output file. Each Visual J# project includes assembly 
settings in its project properties. To view or change the assembly settings, see Signing Page, Project Designer. 


Each invocation of vjc.exe produces, at most, one output file. If you specify a compiler option such as /out or /target more 
than once, the last one the compiler sees is put into effect. Information about all files in a compilation is placed in the manifest. 
All output files contain assembly metadata in the manifest. Use MSIL Disassembler (Ildasm.exe) to view the metadata in an 
output file. 


See Also 
Other Resources 


Visual J# Compiler Options Listed by Category 
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/target:exe (Create a Console Application) (Visual J#) 


Causes the compiler to create an executable (EXE) console application. 





/target:exe 





Remarks 

The /target:exe option is in effect by default. The executable file will be created with the .exe extension. 

Use /target:winexe (Create a Windows Program) (Visual J#) to create a Windows-based program executable. 
Unless otherwise specified with the /out (Set Output File Name) (Visual J#) option, the output 

file name takes the name of the input file that contains the main method. 


One and only one main method is required in the source code files that are compiled into an .exe file. The 
/main (Specify Location of main Method) (Visual J#) compiler option lets you specify which class contains the main method, in 
cases where your code has more than one class with a main method. 


/t:e is the short form of /target:exe. 
To set this compiler option in the Visual Studio development environment 


1. Open the Project Designer. For details, see How to: Set Project Properties (C#, J#). 
2. Select the Application tab. 
3. In the Output Type combo box, select Console Application. 

Example 


Each of the following command lines will compile in.4js1, creating in.exe! 





vjc /target:exe in.jsl 


vjc in.jsl 





See Also 

Reference 

/target (Specify Output File Format) (Visual J#) 
Application Page, Project Designer (Visual Basic) 
Other Resources 

Visual J# Compiler Options Listed by Category 
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/target:library (Create a Code Library) (Visual J#) 


Causes the compiler to create a dynamic-link library (DLL) rather than an executable file (EXE). The DLL will be created with the 
.dll extension. 





/target: library 





Remarks 


Unless otherwise specified with the /out (Set Output File Name) (Visual J#) option, the output file name takes the name of the 
first input file. 


When building a .dll file, a main method is not required. 
/t:l is the short form of /target:library. 


To set this compiler option in the Visual Studio development environment 


1. Open the Project Designer. For details, see How to: Set Project Properties (C#, J#). 
2. Select the Application tab. 


3. In the Output Type combo box, select Class Library. 


Example 


Compile in.js1, creating in.dll: 
vjc /target:library in.jsl 
-Or- 


vjc /t:l in.jsl 








See Also 

Reference 

/target (Specify Output File Format) (Visual J#) 
Application Page, Project Designer (Visual Basic) 
Other Resources 

Visual J# Compiler 
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/target:module (Create Module to Add to Assembly) (Visual J#) 


Specifies that an assembly manifest in a Microsoft intermediate language (MSIL) output file will not be generated. 


/target:module 


Remarks 

By default, the output file will have an extension of .netmodule. 

A file that does not have an assembly cannot be loaded by the INET Framework common language runtime. 
Example 


Compile in.js1, creating in.netmodule: 


vjc /target:module in.jsl 


See Also 

Reference 

/target (Specify Output File Format) (Visual J#) 
Application Page, Project Designer (Visual Basic) 
Other Resources 

Visual J# Compiler Options Listed by Category 
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/target:winexe (Create a Windows Program) (Visual J#) 


Causes the compiler to create an executable (EXE), Windows-based program. The executable file will be created with the .exe 
extension. 


/target:winexe 








Remarks 


A Windows-based program is one that provides a user interface from either the .NET Framework library or with the Win32 
APIs. 


Use /target:exe (Create a Console Application) (Visual J#) to create a console application. 


Unless otherwise specified with the /out (Set Output File Name) (Visual J#) option, the output file name takes the name of the 
input file that contains the main method. 


One and only one main method is required in the source code files that are compiled into an .exe file. The 
/main (Specify Location of main Method) (Visual J#) option lets you specify which class contains the main method, in cases 
where your code has more than one class with a main method. 


/t:w is the short form of /target:winexe. 
To set this compiler option in the Visual Studio development environment 


1. Open the Project Designer. For details, see How to: Set Project Properties (C#, J#). 
2. Select the Application tab. 
3. In the Output Type combo box, select Windows Application. 

Example 


Compile in.js1 into a Windows-based program: 





vjc /target:winexe in.jsl 





See Also 

Reference 

/target (Specify Output File Format) (Visual J#) 
Application Page, Project Designer (Visual Basic) 
Other Resources 

Visual J# Compiler Options Listed by Category 
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/utf8output (Display Compiler Messages with UTF-8) (Visual 
J#) 


Displays compiler output using UTF-8 encoding. 


/utf8output[+ | -] 
Arguments 
+ |- 


By default, /utf8output- is in effect. To prevent displaying compiler output using UTF-8 encoding, specify /utf8output-. 
Specifying /utf8output is the same as specifying /utf8output+. 


Remarks 


In some international configurations, compiler output cannot correctly be displayed in the console. In these configurations, use 
/utf8output and redirect compiler output to a file. 


To set this compiler option in the Visual Studio development environment 
e This compiler option is unavailable in Visual Studio. 

To set this compiler option programmatically 
e This compiler option cannot be changed programmatically. 

See Also 


Other Resources 
Visual J# Compiler 
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/warn (Specify Warning Level) (Visual J#) 


Specifies the warning level for the compiler to display. 





/warn:option 


Arguments 
option 


The minimum warning level you want displayed for the build. Valid values are 0-4: 


























Warning le |Meaning 

vel 

0 Turns off emission of all warning messages. 

1 Displays severe warning messages. 

2 Displays level 1 warnings plus certain, less-severe warnings, such as warnings about hiding class members. 
This is the default warning level at the command line. 

3 Displays level 2 warnings plus certain, less-severe warnings, such as warnings about expressions that always e 
valuate to true or false. 

4 Displays all level 3 warnings plus informational warnings. 

Remarks 


Use /warnaserror (Treat Warnings as Errors) (Visual J#) to treat all warnings as errors. 


/w is the short form of /warn. 
To set this compiler option in the Visual Studio development environment 


1. Open the Project Designer. For details, see How to: Set Project Properties (C#, J#). 
2. Select the Build tab. 


3. Modify the Warning Level property. 


Example 


Compiles in.js1 and directs the compiler to only display level 1 warnings: 


vjc /warn:1 in.jsl 


See Also 

Reference 

Advanced Build Settings Dialog Box (J#) 
Other Resources 

Visual J# Compiler 
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/warnaserror (Treat Warnings as Errors) (Visual J#) 


Treats all warnings as errors. Any messages that would ordinarily be reported as warnings are instead reported as errors, and 
the build process is halted (no output files are built). 


/warnaserror[+ | -] 
Arguments 
eal 


By default, /warnaserror- is in effect, which causes warnings to not prevent the generation of an output file. /warnaserror+, 
which is the same as /warnaserror, causes warnings to be treated as errors. 


Remarks 
Use /warn (Specify Warning Level) (Visual J#) to specify the level of warnings that you want the compiler to display. 


The compiler does not distinguish between warning levels if you want warnings to be treated as errors. 


To set this compiler option in the Visual Studio development environment 


1. Open the Project Designer. For details, see How to: Set Project Properties (C#, J#). 
2. Select the Build tab. 


3. In the Treat Warnings As Errors group, click None or All. 


Example 


Compiles in.jsl and directs the compiler to display no warnings: 


vjc /warnaserror in.jsl 


See Also 

Reference 

Advanced Build Settings Dialog Box (J#) 
Other Resources 

Visual J# Compiler 
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/win32icon (Visual J#) 


Inserts an icon graphic resource for visually enhancing your application 


/win32icon: filename 


Remarks 
where: 
filename 
The .ico file that you want to add to your output file. 
Remarks 


The /win32icon option inserts an .ico file in the output file, which gives the output file the desired appearance in the Windows 
Explorer. An .ico file can be created with the Resource Compiler. The Resource Compiler is invoked when you compile a Visual 
C++ program; an .ico file is created from the .rc file. 


See /linkresource (to reference) or /resource (to attach) a NET Framework resource file. See /win32res to import a .res file. 
To set this compiler option in the Visual Studio development environment 


1. Open the Project Designer. For details, see How to: Set Project Properties (C#, J#). 
2. Select the Application tab. 
3. In the Win32 Resource File box, specify the file path to the resource file. 

Example 


Compile in.js1 and attach an ico file rf.ico to produce in.exe: 


vjc /win32icon:rf.ico in.cs 
| 


See Also 
Other Resources 
C# Compiler Options 
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/win32res (Import a Win32 Resource File) (Visual J#) 


Inserts a Win32 resource in the output file. A Win32 resource file can be created with the Resource Compiler. The Resource 
Compiler is invoked when you compile a Visual C++ program; a .res file is created from the .rc file. 


/win32res:filename 


Arguments 
filename 


The resource file that you want to add to your output file. 
Remarks 


A Win32 resource can contain version or bitmap (icon) information that would help identify your application in the Windows 
Explorer. If you do not specify /win32res, the compiler will generate version information based on the assembly version. 


See /linkresource (Link to .NET Framework Resource) (Visual J#) (to reference) or 
/resource (Embed Resource File to Output) (Visual J# (to attach) a .NET Framework resource file. 


To set this compiler option in the Visual Studio development environment 


1. Open the Project Designer. For details, see How to: Set Project Properties (C#, J#). 
2. Select the Application tab. 


3. In the Win32 Resource File box, specify the file path to the resource file. 
To set this compiler option programmatically 


e This compiler option cannot be changed programmatically. 


Example 


Compile in.js1 and attach a Win32 resource file rf. res to produce in.exe: 


vjc /win32res:rf.res in.jsl 


See Also 

Reference 

Application Page, Project Designer (Visual Basic) 
Other Resources 

Visual J# Compiler 
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/x (Disable Language Extensions) 


Disables language extensions 


/x:[all | net] 
Arguments 
all 


Disable all language extensions. This includes the Microsoft extensions in Visual J++ 6.0 as well as any new .NET Framework- 
specific language extensions. 


net 


Disable only the .NET Framework-specific language extensions. The Microsoft extensions in Visual J++ 6.0 are not disabled in 
this mode. 


Remarks 
For a list of Microsoft extensions in Visual J++ 6.0, see Support for Visual J++ 6.0. 


For a list of the INET Framework-specific language extensions, see Language Extensions to Support the .NET Framework. 
To set this compiler option in the Visual Studio development environment 

1. Open the Project Designer. For details, see How to: Set Project Properties (C#, J#). 

2. Select the Build tab. 

3. Click Advanced. 


4. In the Disable Language Extensions list box, select Enable all extensions, Disable .NET extensions, or Disable all 
extensions. 


To set this compiler option programmatically 
e This compiler option cannot be changed programmatically. 


Example 


Compile in.js1 and disable all language extensions: 
vjc /x:all in.jsl 


See Also 

Reference 

Advanced Build Settings Dialog Box (J#) 
Other Resources 

Visual J# Compiler 
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Visual J++ Compiler Options Mapped to Visual J# Compiler 


Options 


Visual J# compiler options differ from the compiler options provided for Visual J+ +® 6.0. The following table provides a 
mapping of the compiler options. Not all Visual J++ compiler (jvc.exe) options are available in the Visual J# compiler (vjc.exe). 
This table should help you upgrade your makefiles to use the Visual J# compiler. 


Visual J# compiler options are case-insensitive. Several of the options have a short form. For a complete list of Visual J# 
compiler options, see Visual J# Compiler Options Listed Alphabetically. 





Visual J++ comp 


Visual J# compi |Comments 





/d < directory > 


Not supported 


iler option ler option 
?? /? or /help Displays usage information. 
/cp < classpath > |/libpath Was used to specify class path for compilation. 
Use /libpath and/or the LIB environment variable to specify this. 
At compilation time, you must also refer to the assembly containing the class using the / 
reference option. 
/libpath prepends to the LIB environment variable. 
/cp:p[-] /libpath Was used to prepend path to class path. 
Use /libpath to prepend to the path specified in the LIB environment variable. 
/cp:o[-] Not applicable. |Was used to print the class path. 


Was used to specify the root directory for class file output. 


Use /out to specify the output directory and file name. 





/D < symbol > 


/define:<symbo|Was used to define a preprocessor symbol. 











I> 
You can use /define: or its short form /d: (or /D:, as Visual J# options are not case-sensi 
tive). 
/g /debug Was used to tell the compiler to generate full debug information. 
Use the /debug option instead. 
/g:| or /g:t /debug;:{full|pd |Was used to specify what kind of debug information to emit. 
bonl 
y} You can specify the debugging information to be generated. Specifying /debug:full ena 
bles attaching a debugger to the running program. 
/nologo /nologo No change. 
/nowarn /warn:0 Was used to disable warnings. 
You can specify a warning level of 0 to disable all warnings (short form is /w:0). 
/nowrite Not supported |Was used to do only compilation without generating any output. 
/O /optimize Was used to enable optimization. 


Use the /optimize option instead. 
































/0:J and /O:1 Not supported |Was used to specify the type of optimization. 
/ref Not supported _|Was used to recompile referenced classes, if out-of-date. 
/verbose Not supported |Was used to print information about compilation progress. 
/w{0-4} /warn:{0-4} Was used to set warning levels. 

You can now use the /warn: option (short form is /w:{0-4}). 
/wx /warnaserror _ |Was used to treat warnings as errors. 

Use the /warnaserror option instead. 
/x /x:all Was used to disable extensions. 

/x:net You can now use /x:all to disable all language extensions. /x:net only disables .NET Fra 

mework-specific language extensions. 

See Also 


Other Resources 
Visual J# Compiler 
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Compiler Errors VJSO001 Through VJS9999 


This section is a reference to the errors generated by the vjprvj compiler. To get help on a particular error message, either click 
the mouse on an error number in the Output window and press F1, or type the error number in the Look for box in the Index. 


See Also 
Other Resources 


Visual J# Compiler 
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Compiler Error VJS1001 


Error Message 
No source file supplied 


The Visual J# compiler was invoked at the command line and one or more compiler options were specified, but no source code 
files were specified. Specify one or more source code files. 


Visual J# Reference 


Compiler Error VJS1002 


Error Message 
Unrecognized option ‘option’ 


A value was passed to the Visual J# compiler that began with a forward slash (/) but was not a recognized compiler option. For 
information about compiler options, see Visual J# Compiler Options. 


The following sample generates VJS1002: 


// VIS1002.js1 

// compile with: /nolog 

// \N'JS1002 expected 

public class MyClass 

{ 
public static void main() 
{ 
} 


Visual J# Reference 


Compiler Error VJS1003 


Error Message 
Option ‘option’ must be followed by 


+','-", or nothing 
A compiler option that is designed to accept a Boolean value (or no value) was passed an invalid value. 


The following sample generates VJS1003: 


// VIS1003.js1 
// compile with: /optimize:@ 
// \'JS1003 expected 
// to resolve, use /optimize (not /optimize:@) 
public class MyClass 
{ 
public static void main() 
uf 
} 
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Compiler Error VJS1004 


Error Message 
Option ‘option’ must be followed by ':' and a value 


A compiler option was specified but was ill-formed. See Visual J# Compiler Options for information about the syntax of 
compiler options. 


The following sample generates VJS1004: 


// VIS1004.js1 
// compile with: /define+ 
// N'JS1004 expected 
public class MyClass 
{ 
public static void main() 
{ 
} 
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Compiler Error VJS1005 


Error Message 
File ‘file’ not found 


A file name was passed to the compiler, but the compiler was unable to find the file. The compiler searches for files in the 
current directory. Use the /recurse compiler option to have the compiler look for files in subdirectories. 
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Compiler Error VJS1006 


Error Message 
Cannot read source file ‘file’ 


A source code file passed to the Visual J# compiler did not have read access. 
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Compiler Error VJS1009 


Error Message 
/reference file ‘file’ not found 


A file was passed to the /reference compiler option, but the compiler did not find the file. 


The following sample generates VJS1009: 


// VIS1009.js1 
// compile with: /reference:a_file_you_do_not_have.d1ll 
// \N'JS1009 expected 
public class MyClass 
{ 
public static void main() 
{ 
} 
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Compiler Error VJS1010 


Error Message 
/reference file ‘file’ is not an assembly 


A file was passed to the /reference compiler option, but the file did not contain an assembly manifest. 


Example a 


// \V'JS1010a.cpp 

// compile with: /LD 
// C++ source code 
class SomeClass {}; 





// VIJS101@b.js1 

// compile with: /reference:VJS1010a.d11 /target: library 
// \'JS1010 expected 

public class MyClass {} 
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Compiler Error VJS1011 


Error Message 
'@' must be followed by the response file name 


The command line option to specify a response file did not include the name of the file. For more information, see 
@ (Specify Response File). 


The following sample generates VJS1011: 


// VIJS1011.js1 

// compile with: @ 

// \“'JS1011 expected 

public class MyClass 

{ 
public static void main() 
{ 
} 
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Compiler Error VJS1012 


Error Message 
Cannot read response file ‘file’ 


A response file passed to the Visual J# compiler did not have read access. 
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Compiler Error VJS1013 


Error Message 
Found response file ‘file’ more than once 


A response file was specified twice in the same compilation. A response file can only be specified once in a compilation. For 
more information, see @ (Specify Response File). 


The following sample generates VJS1013: 


// VIS1013.jsl 
// compile with: @x.rsp @x.rsp 
// \V'JS1013 expected 
public class MyClass 
{ 
public static void main() 
{ 
} 
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Compiler Error VJS1014 


Error Message 
Unclosed quote in response file 


A response file had an opening quotation mark, but did not have a closing quotation mark. For the sample below, assume a 
response file with the following contents is on disk: 


/target: library 


The following sample generates VJS1014: 


// VIS1014.js1 

// compile with: @VIJS1014.rsp 
// \VJS1014 expected 

public class MyClass 

{ 

} 
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Compiler Error VJS1016 


Error Message 
‘string’ is not a valid value for /target 


An invalid parameter was passed to the /target compiler option. 


The following sample generates VJS1016: 


// VIS1016.js1 
// compile with: /target:exec 
// \“'JS1016 expected 
public class MyClass 
{ 
public static void main() 
{ 
} 
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Compiler Error VJS1017 


Error Message 
‘string’ is not a valid value for /x 


An invalid parameter was passed to the /x compiler option. 


The following sample generates VJS1017: 


// NVIS1017.js1 
// compile with: /x:module 
// \'JS1017 expected 
public class MyClass 
{ 
public static void main() 
{ 
} 
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Compiler Error VJS1019 


Error Message 
Bad /baseaddress value ‘value’ 


An invalid value was passed to the /baseaddress compiler option. 


The following sample generates VJS1019: 


// VIS1019.js1 
// compile with: /target:library /baseaddress:r 
// \'JS1019 expected 
public class MyClass 
{ 
public static void main() 
{ 
} 
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Compiler Error VJS1020 


Error Message 
The value of /warn must be in the range 0-4 


An invalid value was passed to the /warn compiler option. 


The following sample generates VJS1020: 


// NVIS1020.js1 

// compile with: /warn:5 

// \N'JS1020 expected 

public class MyClass 

{ 
public static void main() 
J 
} 
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Compiler Error VJS1022 


Error Message 
Cannot write to file ‘file’ 


An output file specified by a compilation could not be created because a file with the same name is in use on your machine. 
Either rename your output file or close the file with the same name. 
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Compiler Warning (level 1) VJS1023 


Error Message 
Ignoring the duplicate main in ‘class’; use /main:<classname> to specify entry point 


The compiler found more than one main method. The first main method is used as the program's entry point, and subsequent 
main methods are ignored. 


The following sample generates VJS1023: 
// VIS1023.js1 


// compile with: /W:1 
public class MyClass 


{ 
public static void main() 
{ 
} 
} 
public class MyClass2 // VIS1023 
{ 


// this main method is ignored 
public static void main() 

{ 

} 
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Compiler Error VJS1024 


Error Message 
Bad /main option: class ‘class’ does not contain a suitable main method 


A class that was specified with the /main compiler option did not contain a main method that could be used as an entry point 
to the program. Specify a class that has a main method. 


The following sample generates VJS1024: 
// VIS1024.js1 


// compile with: /main:MyClass 
public class MyClass // VJS1024, specify /main:MyClass2 instead 


{ 

} 

public class MyClass2 

{ 
public static void main() 
{ 
} 
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Compiler Error VJS1025 


Error Message 
Class 'class' named in /main option not found in compilation 


A class that was specified with the /main compiler option was not found by the compiler in source code. Specify a class that 
does exist in one of the source code files you are compiling. 


The following sample generates VJS1025: 


// VIS1025.jsl1 
// compile with: /main:MyClass2 
// \'JS1025 expected 
public class MyClass 
{ 
public static void main() 
{ 
} 
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Compiler Error VJS1026 


Error Message 
/target is ‘exe’ but no suitable main method was found in compilation 


The compiler did not find a main method, which acts as an entry point when the program is run. 


The following sample generates VJS1026: 


// VIS1026.js1 
// compile with: /target:exe 
// \N'JS1026 expected 
public class MyClass 
{ 
// uncomment the following lines to resolve 
// public static void main() 
// 
eae 
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Compiler Error VJS1027 


Error Message 
/target is 'winexe' but no suitable main method was found in compilation 


The compiler did not find a main method, which acts as an entry point when the program is run. 


The following sample generates VJS1027: 


// NIJS1027.js1 
// compile with: /target:winexe 
// N'JS1027 expected 
public class MyClass 
{ 
// uncomment the following lines to resolve 
// public static void main() 
// 
eae 
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Compiler Error VJS1028 


Error Message 
/target must be ‘exe’ or 'winexe' if /main is specified 


The /targetilibrary compiler option is not compatible with the /main compiler option. 
Specify /target:exe or /target:winexe to generate executable or remove the /main option to generate library. 


The following sample generates VJS1028: 


// VIS1028.js1 
// compile with: /target:library /main:MyClass 
// \'JS1028 expected 
public class MyClass 
{ 
public static void main() 
{ 
} 
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Compiler Error VJS1029 


Only one resource identifier can be specified in the /resource or /linkresource command line option 


Both the /linkresource and /resource compiler options allow you to specify more than one resource identifier name per 
assembly. However, you must specify a separate /resource flag for each identifier. 


The following sample generates VJS1029: 


// VIS1029.js1 
// compile with: /res:VJS1029.resource,name1,name2 
// \V'JS1029 expected 
// try /res:VJS1029.resource /res:name1.resource /res:Name2.resource 
public class MyClass 
{ 
public static void main() 
{ 
} 


Visual J# Reference 


Compiler Error VJS1031 


Error Message 
Warnings treated as errors 


The /warnaserror option was used in the compilation and any warnings will be promoted to errors. 


The following sample generates VJS1031: 


// VIS1031.js1 

// compile with: /warnaserror /W:3 
// \'JS1031 expected 

class MyClass 


{ 
public static void main() 
t 
int i; // warning 
} 
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Compiler Error VJS1032 


Error Message 
‘value’ is not valid value for /debug: Only values allowed are full or pdbonly 


The /debug compiler option was specified incorrectly. 


The following sample generates VJS1032: 


// VIS1032.js1 

// compile with: /debug:@ 

// \'JS1032 expected 

// to resolve, use /debug (not /debug:@) 
public class MyClass 

{ 

} 
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Compiler Error VJS1033 


Error Message 
Must specify a resource filename with /resource or /linkresource command line option 


The /resource or /linkresource compiler option was specified incorrectly. 


The following sample generates VJS1033: 


// VIS1033.jsl 
// compile with: /resource: 
// \'JS1033 expected 
public class MyClass 
{ 
public static void main() 
{ 
} 
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Compiler Error VJS1034 


Error Message 
‘number’ is not a valid warning number for /nowarn command line option. 


A value was passed to the /nowarn compiler option that was not a valid warning number. 


The following sample generates VJS1034: 


// VIS1034.js1 

// compile with: /nowarn:0000 /target: library 
// \V'JS1034 expected 

public class MyClass 

{ 

} 
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Compiler Error VJS1035 


Error Message 
Missing file specification for ‘option’ command-line option 


The compiler option expects a file specification. 


The following sample generates VJS1035: 


// VIS1035.jsl 

// compile with: /recurse: /target:library 
// VJS1035 expected 

// try the following compiler options instead 
// /recurse:*.jsl /target:library 

public class MyClass 

{ 

} 
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Compiler Error VJS1036 


Error Message 
Resource identifier ‘name’ has already been used in this assembly 


A user-defined name for a resource file has already been used in the assembly. 


The following sample generates VJS1036: 


// VIS1036.js1 
// compile with: /res:VJS1036A.resources,a /res:VJS1036B.resources,a 
// N'JS1036 expected 
public class MyClass 
{ 
} 
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Compiler Error VJS1037 


Error Message 
Conflicting options specified: Treat warnings as errors and warning level 0 


It is not valid to specify both /warnaserror and /warn:0 in the same compilation. 


The following sample generates VJS1037: 


// VIS1037.js1 
// compile with: /W:@ /warnaserror 
// \'JS1037 expected 
public class MyClass 
{ 
public static void main() 
{ 
} 
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Compiler Error VJS1038 


Error Message 
Codepage 'codepage' is invalid or not installed on your machine 


An incorrect value was specified for the /codepage option when invoking the Visual J# compiler. 


Visual J# Reference 


Compiler Error VJS1039 


Error Message 
Cannot link resource file when building a module 


It is not valid to specify both /target:module (Create Module to Add to Assembly): and 
/linkresource (Link to .NET Framework Resource) in the same compilation. 
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Compiler Error VJS1040 


Error Message 
Cannot write to file ‘filename’ -- ‘reason’ 


The compiler cannot write to the file for the reason given. For example, if a file is open in MSIL Disassembler (Ildasm.exe) and 
you try to rebuild the file with vjc.exe, this error occurs. 
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Compiler Error VJS1041 


Error Message 
Must specify a value for ‘option’ command-line option 


A compiler option was specified but was ill-formed. See Visual J# Compiler Options for information about the syntax of 
compiler options. 


The following sample generates VJS1041: 


// VIS1041.js1 
// compile with: /define: 
// \'JS1041 expected 
public class MyClass 
{ 
public static void main() 
{ 
} 
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Compiler Error VJS1042 


Error Message 
Incremental build requires a target name specified with /out. 


When you are performing an incremental build, you must specify an output file using the /out option. 


To correct this error 


e Provide the name of an output file. 


Example 
The following sample generates VJS1042. 


public class MyClass 


{ 
public static void main() 
{ 
} 
} 
See Also 


Other Resources 
Visual J# Compiler 
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Compiler Error VJS1044 


Error Message 
Cannot read from file file 


The file name might not be a valid file on the hard disk. It could map to either a device or the console. 
Sample: 
vjc /res:con.res MyClass,jsl 


where con.res is not a file that exists on the disk and MyClass,jsl is a valid J# file. 
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Compiler Error VJS1076 


Error Message 
Unexpected end of file 


The file ended during the parsing of a construct. Check the code near the end of file to make sure all constructs were 
completed. For example, check for missing closing braces (}). 


This error may be reported as Compiler Error VJS1118. 
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Compiler Error VJS1077 


Error Message 
Unterminated comment 


A multiline comment was not terminated. 


The following sample generates VJS1077: 


// NIJS1077.js1 
class MyClass 


{ 
fe // \NJS1077, no end to comment 


public static void main() 


{ 
System.out.println("test"); 


} 
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Compiler Error VJS1078 


Error Message 
Unexpected char ‘char’ 


The compiler detected a syntax error due to an unexpected character. 


The following sample generates VJS1078: 


// NIJS1078.js1 
class MyClass 


@ // vIS1e78 
} 


Visual J# Reference 


Compiler Error VJS1079 


Error Message 
‘token’ is not a valid keyword or identifier 


Visual J# does not recognize const and goto as valid identifiers. 


The following sample generates VJS1079: 


// \IS1079.js1 
class MyClass 


{ 
} 


int goto; // \N}JS1079 
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Compiler Error VJS1080 


Error Message 
#error ‘user defined error’ 


This error is generated when a #error directive is executed. 


The following sample generates VJS1080: 


// VIS1080.js1 
public class MyClass 


{ 
public static void main() 
{ 
#error A user-defined error // VJS1080 
} 
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Compiler Warning (level 1) VJS1081 


Error Message 
#warning ‘user defined warning’ 


This warning Is generated when a #warning directive is executed. 
The following sample generates VJS1081: 
// VIS1081.js1 


// compile with: /W:1 
public class MyClass 


{ 
public static void main() 
{ 
#warning A user-defined warning // VJS1081 
} 
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Compiler Error VJS1082 


Error Message 
Conditional directives must be first non-whitespace on line 


A conditional directive followed other text on a line. Always specify conditional directives as first tokens in a line. 


The following sample generates VJS1082: 


// VIS1082.js1 


#define Xc 
public class MyClass 
{ 
public static void main() 
{ 
int i; #if X // VIS1082 
int i; 
#endif 
} 
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Compiler Error VJS1083 


Error Message 
Expected conditional identifier, found ‘string’ 


The compiler detected an ill-formed symbol in a conditional directive. 


The following sample generates VJS1083: 


// VIS1083.js1 

#define -X // NJS1083 
#define VALID_ID // OK 
class MyClass 

{ 

} 
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Compiler Error VJS1084 


Error Message 
Expected conditional directive, found ‘string’ 


The compiler detected an ill-formed conditional directive. 


The following sample generates VJS1084: 


// VIS1084.js1 
#-define X // \VIS1084 
class MyClass 

{ 

} 
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Compiler Error VJS1085 


Error Message 
Expected conditional identifier 


The compiler detected an ill-formed conditional directive. 


The following sample generates VJS1085: 


// VIJS1085.js1 
#define // VIS1085 
class MyClass 

{ 

} 
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Compiler Error VJS1086 


Error Message 
Expected conditional directive, found end of line 


The end of line, and not an identifier, was found. 
The following sample generates VJS1086: 


// VIS1086.js1 
class MyClass 


# // VIS1086 
#if DIRECTIVE // OK 
#endif 
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Compiler Error VJS1087 


Error Message 
#line directive must be followed by a line number or ‘default’ 


The compiler found an incomplete #line directive. 


The following sample generates VJS1087: 


// NIJS1087.js1 
public class MyClass 
1 
public static void main() 
{ 
#line testing // VIJS1087 
// try the following line instead 
// #line 21 
} 
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Compiler Error VJS1088 


Error Message 
'#text' is not a conditional directive 


The compiler encountered a token that began with a # symbol but was not a valid conditional directive. 


The following sample generates VJS1088: 


// VIS1088.js1 
public class MyClass 


{ 
public static void main() 
{ 
#linee 22 // VIJS1088 
// try the following line instead 
// #line 22 
} 
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Compiler Error VJS1089 


Error Message 
Extra text after conditional directive 


Additional text was found following an otherwise well-formed conditional directive. 


The following sample generates VJS1089: 


// VIS1089.js1 
public class MyClass 


{ 
public static void main() 
{ 
#line 22 77 // \VIS1089 
} 
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Compiler Error VJS1090 


Error Message 
Cannot have #define or #undef after source 


The compiler found a #define or #undef directive after the start of the source code in the file. The #define and #undef 
directives must be specified before the first token of the source. 


The following sample generates VJS1090: 


// VIJS1090.js1 
import System.*; 
#define DEBUG // VIJS1090, try moving this line before import statement 
public class MyClass 
{ 
public static void main() 
{ 
} 
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Compiler Error VJS1091 


Error Message 
No matching #if for ‘directive’ 


A conditional directive, #endif or #else, was found without a matching #if directive. 
The following sample generates VJS1091: 


// VJS1091.js1 
public class MyClass 


{ 


public static void main() 


// #if DEBUG 
#endif // VJS1091, uncomment the #if statement to resolve 
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Compiler Error VJS1092 


Error Message 
No matching #endif for this #if 


A #if directive was found without a matching #endif directive. 


The following sample generates VJS1092: 


// VIJS1092.js1 
public class MyClass 


{ 


public static void main() 


#if DEBUG // \IS1092 
// uncomment the following line to resolve 
// #endif 
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Compiler Error VJS1093 


Error Message 
'#if' has multiple ‘#else' 


A #if statement can have at most one #else directive. 


The following sample generates VJS1093: 


// VIS1093.js1 
public class MyClass 
{ 


public static void main() 
{ 
#if DEBUG 
// DEBUG defined 
#else 
// DEBUG not defined 
#else // VJS1093, second #else not valid 
// something wrong 
#endif 
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Compiler Error VJS1094 


Error Message 
Unexpected end of line in conditional expression 


A conditional directive was ill-formed. 


The following sample generates VJS1094: 


// VIS1094.js1 
public class MyClass 


{ 

public static void main() 

{ 
#if  // VIS1094, add an expression to evaluate 
// try the following line instead 
// #if DEBUG 
#endif 

} 
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Compiler Error VJS1095 


Error Message 
Unmatched '(' in conditional expression 


A conditional expression was ill-formed due to an unmatched opening parenthesis. 


The following sample generates VJS1095: 


// VIS1095.jsl 
public class MyClass 
{ 
public static void main() 
{ 
#if (DEBUG // \VIS1095 
// try the following line instead 
// #if (DEBUG) 
#endif 
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Compiler Error VJS1096 


Error Message 
Predefined symbol ‘true’ or ‘false’ cannot be changed 


The compiler detected an attempt to define a symbol using one of the Boolean constants: true or false. It is not possible to 
modify the meaning of true or false. 


The following sample generates VJS1096: 


// VIS1096.js1 
#define true // VIJS1096, don't use true as a user-defined symbol 
public class MyClass 
{ 
public static void main() 
{ 
} 
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Compiler Error VJS1097 


Error Message 
The directive '#directive’ is not supported when .NET extensions are disabled 


Some processing directives are not valid when .NET Framework extensions are disabled. For more information, see the /x 
compiler option. 


The following sample generates VJS1097: 
// VIS1097.js1 


// compile with: /x:net 
public class MyClass 


{ 
public static void main() 
{ 
#line 32 // \N}JS1097 
} 
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Compiler Error VJS1118 


Error Message 
Unexpected ‘token’ 


An unexpected token was found. For some special tokens, a more specific error may be emitted and reported as VJS1118. For 
example, omitting a closing brace will cause the compiler to report an unexpected EOF token, and the error reported as 
VJS1118 is actually Compiler Error VJS1076. 


The following sample generates VJS1118: 


// VIS1118.js1 
public class MyClass 


{ 
public static void main(String[] args) 
{ 
) // \IJS1118 
} 
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Compiler Error VJS1119 


Error Message 
‘token’ expected 


The compiler was unable to parse the source code. 


The following sample generates VJS1119: 


// VIJS1119.jsl1 
package test 
public class MyClass // VJS1119, end previous line with semicolon 
{ 
public static void main() 
{ 
} 
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Compiler Error VJS1120 


Error Message 
Expected ‘class’, ‘interface’, or ‘delegate’, found token. 


The compiler detected an invalid declaration. 
To correct this error 
1. Find the invalid declaration. 


2. Correct the declaration. 


Example 
The following sample generates VJS1120: 


public class Program 


public static void main(String[] args) 


{ 

} 

class MyClass 

{ 

public void Test() 
abstract int t; // \IS1120 
int x = 10; // OK 
} 
} 
} 
See Also 


Other Resources 
Visual J# Compiler 
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Compiler Error VJS1122 


Error Message 


Expected type, found '‘void' 


For a parameter in a method definition or declaration, void is not a valid type. 


The following sample generates VJS1122: 


// VIJS1122.js1 
class MyClass 
{ 
public void Test(void t) // VIS1122 
// try the following line instead 
// public void Test(int t) 
{ 
} 
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Compiler Error VJS1123 


Error Message 
Bad member declaration 


A class member was not declared properly. 


The following sample generates VJS1123: 


// VIS1123.js1 

public class MyClass 

{ 
public static void main() 
{ 
J 


xxx class MyClass2 // VJS1123, xxx is not a valid access modifer 
// try the following line instead 

// public class MyClass2 

{ 

} 
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Compiler Error VJS1124 


Error Message 
@attribute.return is valid only on method declarations 


The @attribute.return attribute was applied to a construct for which it was not designed; it can only be applied to methods. 


The following sample generates VJS1124: 


// VIS1124.js1 
import System.Runtime.InteropServices.*; 
/** @attribute.return MarshalAs(UnmanagedType.Error) */ // NIS1124 
public class MyClass 
{ 
// OK 
/** @attribute.return MarshalAs(UnmanagedType.Error) */ 
public int Test() 
{ 


} 


return -1; 
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Compiler Error VJS1125 


Error Message 
Unexpected end of attribute declaration 


An attribute declaration is not complete. 


The following sample generates VJS1125: 


// VIS1125.jsl 

/** @attribute System.CLSCompliant */ // “IS1125 
// try the following line instead 

// /** @attribute System.CLSCompliant(true) */ 
class MyClass 

{ 

} 
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Compiler Error VJS1126 


Error Message 
@attribute.method is valid only on method declarations 


The @attribute.method attribute was applied to a construct for which it was not designed; it can only be applied to methods. 


The following sample generates VJS1126: 


// VIS1126.js1 
/** @attribute.method System.ObsoleteAttribute("Hello") */ // VIJS1126 
public class MyClass 
{ 
// following line is OK 
/** @attribute.method System.ObsoleteAttribute("Hello") */ 
public static void main() 
if 
} 
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Compiler Error VJS1127 


Error Message 
User defined constructor is not allowed on a class marked with ComImportAttribute 


A user-defined constructor cannot be specified on a class marked with ComImportAttribute. The COM interop layer in the 
common language runtime supplies the constructor for ComImport classes. This constructor is required to make a COM 
object look like a managed object in the runtime. 


The following sample generates VJS1127: 


// VIS1127.js1 

import System.Runtime.InteropServices.*; 

/** @attribute ComImport() */ 

/** @attribute Guid("fb6363f0-721b-478e-bfc6-bc30Ff7be6be5") */ 

public class MyClass // \NJS1127 

{ 
// To solve the problem, remove the constructor below. 
public MyClass(){} 
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Compiler Error VJS1128 


Error Message 
A class marked with ComImportAttribute must have a GuidAttribute 


The GuidAttribute must be preset on a class marked with ComImportAttribute. Otherwise, the NET COM interop layer in 
the .NET Framework cannot create a COM class. 


The following sample generates VJS1128: 


// VIS1128.js1 

// compile with: /target:library 

import System.Runtime.InteropServices.*; 

/** @attribute ComImport() */ 

// add the following line to resolve 

// /** @attribute Guid("00000000-29000-9000-29000-900000000001") */ 
public class MyClass // NIS1128 

{ 

} 
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Compiler Error VJS1129 


Error Message 
Instance field ‘field’ of a class marked with StructLayoutAttribute(LayoutKind.Explicit) must have a FieldOffsetAttribute 


When StructLayout Explicit is in effect, fields must be marked with FieldOffset. 


The following sample generates VJS1129: 


// VIS1129.js1 
// compile with: /target:library 
import System.Runtime. InteropServices. *; 


/** @attribute StructLayout(LayoutKind.Explicit, Size = 4)*/ 
class Myclass 


{ 
} 


int a; // VIS1129 
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Compiler Error VJS1153 


Error Message 
The class ‘class’ inherits from itself (circularity) 


It is not valid for a class to use itself as a base class. 


The following sample generates VJS1153: 


// VIS1153.jsl 
public class MyClass extends MyClass // VIS1153 
{ 

public static void main() 

{ 

} 
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Compiler Error VJS1156 


Error Message 
The superclass ‘class’ is final and cannot be extended 


A class marked final cannot be used as a base class. 


The following sample generates VJS1156: 


// VIS1156.jsl 
final class MyClass2 


{ 
public static void main() 
{ 
} 

i 


public class MyClass extends MyClass2 


4 
} 


// VIS1156 
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Compiler Error VJS1157 


Error Message 
Cannot extend interface ‘interface’ (use ‘implements’ instead) 


An interface cannot be extended by a class, but it can be implemented. 


The following sample generates VJS1157: 


// VIS1157.js1 
interface Point 
{ 

ij 


public class MyClass extends Point // NIJS1157 
// try the following line instead 
// public class MyClass implements Point 
{ 
public static void main() 
{ 
} 
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Compiler Error VJS1158 


Error Message 
An interface cannot implement an interface (use ‘extends’ instead) 


An interface cannot be implemented by another interface, but it can be extended. 


The following sample generates VJS1158: 


// VIS1158.jsl1 
interface Point 
{ 

ij 


interface Point2 implements Point // NIJS1158 
// try the following line instead 
// interface Point2 extends Point 


{ 

} 

public class MyClass 

{ 
public static void main() 
{ 
} 
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Compiler Error VJS1159 


Error Message 
Interface ‘interface’ is implemented twice 


An interface can only be implemented once per type. 


The following sample generates VJS1159: 


// VIS1159.jsl 
interface Point 
{ 

ij 


interface Point2 extends Point, Point // VIJS1159, Point listed twice 
// try the following line instead 
// interface Point2 extends Point 


{ 

} 

public class MyClass 

{ 
public static void main() 
{ 
} 
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Compiler Error VJS1161 


Error Message 
Cannot find class ‘class’ 


A type was imported, but the type was not in the compilation. To fix this problem, add the source file with the code for the class 
to the command line or project, or add the appropriate reference. 


Example 


// VIS1161a.jsl 
// compile with: /target:library 
public class Class1 {} 


// \VIS1161b.js1 

// compile with: /target:library 

import Class1; // VIS1161 add VJS1161a.jsl to compilation 
class MyClass {} 
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Compiler Error VJS1163 


Error Message 
‘class' is not an interface 


A class cannot be implemented, but it can be extended. 


The following sample generates VJS1163: 


// VIS1163.js1 
interface Point 
{ 

ij 


public class MyClass 


A 
} 


public class MyClass2 implements MyClass // VIS1163 
// try the following line instead 
// public class MyClass2 extends MyClass 
{ 
public static void main() 
{ 
} 
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Compiler Error VJS1164 


Error Message 
Interface declarations are not allowed in blocks 


An interface was declared in a location that was not valid. 


The following sample generates VJS1164: 


// VIS1164.js1 

// compile with: /target:library 

class MyClass 

{ 

{ 

interface I // VJS1164, interface declaration not allowed here 
if 
} 


class C // type declarations allowed 


{ 
} 
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Compiler Error VJS1166 


Error Message 


Static and instance initializers are not allowed in interfaces 


An interface cannot contain static or instance initializer blocks, but can contain member initializations. 


The following sample generates VJS1166: 


// VIS1166.js1 
// compile with: /target:library 


interface 
{ 
static 
{ 
int 
} 
static 
} 
interface 
{ 
{ // 
int 
} 
int x 


I1 


// VIS1166 static initializer block in interface 


int x = @; // OK: static member initializer 


I2 


VIS1166 instance initalizer block in interface 
i = 10; 


20; // OK: instance member initializer 
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Compiler Error VJS1167 


Error Message 
Constructors are not allowed in interfaces 


An interface cannot contain the declaration or definition of a constructor. 


The following sample generates VJS1167: 


// \“'IS1167 
public interface Point 


Point() // VIS1167, constructor not allowed 
{ 
} 

} 


public class MyClass 

{ 
public MyClass () // OK, Ctors allowed in class declarations 
{ 
} 


public static void main() 


{ 
i 
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Compiler Error VJS1169 


Error Message 
‘class' must be declared ‘abstract’ or 'baseclass.member' must be implemented 


A class (class) must implement the abstract members in an inherited class (baseclass), unless class is declared abstract. 


The following sample generates VJS1169: 


// VIS1169.js1 
public interface Point 


{ 
void SetPoint(); 
} 
public class MyClass implements Point // \VIS1169 
{ 


// uncomment member definition to resolve, or declare MyClass abstract 
// public void SetPoint() 

// 

re 

public static void main() 

{ 

} 
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Compiler Error VJS1170 


Error Message 
‘class' must be declared abstract or these methods must be implemented: methods 


A class (class) must implement all the abstract members in an inherited class, unless class is declared abstract. 


The following sample generates VJS1170: 


// VIS1170.js1 
public interface Point 
{ 
void SetPoint(); 
int GetPoint(); 


} 


public class MyClass implements Point // \JS1170 
// to resolve, either implement methods in Point or 
// declare MyClass as abstract 
{ 

public static void main() 

{ 

} 
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Compiler Error VJS1172 


Error Message 
An explicit enclosing instance of class ‘class’ is needed to instantiate inner class ‘inner class’ 


An enclosing class object instance is required to create an instance of a non-static inner class member. 


The following sample generates VJS1172: 


// VIJS1172.js1 
class MyClass 


{ 
public static void main (String [] args) 
{ 
new Class1.InnerClass(); // VIS1172 
// to resolve, define InnerClass as static 
// or try the following line instead 
// new Classi (). new InnerClass (); 
} 
} 
class Classi 
{ 
public class InnerClass 
if 
} 
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Compiler Error VJS1173 


Error Message 
An explicit enclosing instance of class ‘class’ is needed to call constructor of inner class ‘inner class’ 


An attempt was made to create an inner class from static context; an instance is required to create the inner class. 
The following sample generates VJS1173: 
// VIS1173a.jsl 


// compile with: /target:library 
class MyClass 


{ 
public class InnerClass 
{ 
} 
public static class Inner2 extends InnerClass 
{ 
Inner2 () 
{ 
super(); // VJS1173, make Inner2 an instance class 
} 
} 
} 


Every class constructor has a call to its super class, so an instance is needed. 
The following sample generates VJS1173: 
// VIS1173b.js1 


// compile with: /target:library 
public class MyClass extends Classi.Inner 


{ 
public MyClass() // VIS1173, Class1.Inner needs to be static 
{ 
} 
} 
public class Class1 
{ 
public class Inner 
{ 
} 
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Compiler Error VJS1174 


Error Message 
Type has the same simple name as enclosing class ‘class’ 


An inner type has the same name as its outer class. To avoid this error, rename one of the types. 


The following sample generates VJS1174: 


// \IS1174.js1 

public class MyClass 

{ 
public static void main() 
{ 


} 
public class MyClass // N3S1174 


// try the following line instead 
// public class InnerClass 

{ 

} 
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Compiler Error VJS1175 


Error Message 
Inner class 'class' contains a static initializer 


An instance inner class cannot contain a static initializer, whereas a static inner class can contain static initializer. 


The following sample generates VJS1175: 


// VIS1175.jsl 
public class MyClass 


{ 

public static void main() 

{ 

} 

public class InnerClass // NIS1175 

{ 
static int i = Q; 
// try the following line instead 
// int i = @; 

} 
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Compiler Error VJS1176 


Error Message 
Cannot declare field ‘field’ static in an inner class 


An instance inner class cannot contain a static field, whereas a static inner class can contain static field declarations. 


The following sample generates VJS1176: 


// VIS1176.js1 
public class MyClass 


{ 

public static void main() 

if 

} 

public class InnerClass 

{ 
static int i = Q; // \IS1176 
// try the following line instead 
// int i = @; 

} 
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Compiler Error VJS1177 


Error Message 
Cannot declare method 'method' static in an inner class 


An instance inner class cannot contain a static method, whereas a static inner class can contain static method declarations. 


The following sample generates VJS1177: 


// \IJS1177.js1 
public class MyClass 


{ 

public static void main() 

{ 

} 

public class InnerClass 

{ 
public static int Test() // “JS1177, delete static modifier 
{ 
} 

} 
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Compiler Error VJS1179 


Error Message 
Cannot declare interface ‘interface’ in an inner class 


A non-static inner class cannot contain interfaces. 


The following sample generates VJS1179: 


// VIS1179.js1 
class MyClass 


{ 

public class Inner 

{ 
public interface InnerInterface // VJS1179, to resolve, declare Inner as static 
{ 
} 

} 

public static void main (String [] args) 

{ 

} 
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Compiler Error VJS1180 


Error Message 
Qualified 'new' must use a simple type name, not 'name’ 


When creating an object from an inner class, the inner type should be a simple type name. 


The following samples generate VJS1180: 


// VIS1180.js1 
class MyClass 


{ 
public static void main(String [] args) 
{ 
new Classi ().new Class1.Inner(); // VIS1180 
// try the following line instead 
// new Class1 (). new Inner(); 
} 
} 
class Classi 
{ 
public class Inner 
{ 
} 
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Compiler Error VJS1182 


Error Message 
Cannot assign ‘this’ to 'class' for enclosing instance for ‘inner class' 


Before an instance of an inner class can be created, an instance of the inner class's enclosing class is needed. 


The following samples generate VJS1182: 


// VIS1182.js1 
class MyClass 


{ 
public void Test() 
{ 
new Class1.Inner(); // VIS1182 
// try the following line instead 
// new Classi (). new Inner (); 
} 
public static void main (String [] args) 
uf 
} 
} 


class Classi 


public class Inner 


t 
} 
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Compiler Error VJS1183 


Error Message 
Redeclaration of type ‘type’ declared in another source file 


A type with the same name was declared in two source code files of the same compilation. 


The following samples generate VJS1183: 


// VIS1183a.jsl 

// compile with: /target:library 
public class MyClass 

{ 


} 
// VIS1183b.js1 
// compile with: VJS1183a.jsl 
public class MyClass // \VJS1183, MyClass also declared in VJS1183a.jsl 
af 
public static void main() 
{ 
} 
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Compiler Error VJS1184 


Error Message 
Redeclaration of type ‘type’ declared in the same source file 


A type with the same name was declared twice in a source code file. 


The following sample generates VJS1184: 


// VIS1184.js1 
public class MyClass 


{ 
public static void main() 
{ 
} 
} 
class MyClass // VIS1184 
{ 


} 
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Compiler Error VJS1185 


Error Message 
Type ‘type’ is imported by at least two ‘import on demand’ statements 


The compiler detected a single type name, which is in two different packages, that was imported by two import statements. 


Example a 


// VIS1185a.jsl 

// compile with: /target:library 
package pkg1; 

public class MyType {} 





// VIS1185b.js1 

// compile with: /target:library 
package pkg2; 

public class MyType {} 








The following samples generate VJS1185: 





// VIS1185c.jsl 

// compile with: VJS1185a.jsl VIJS1185b.js1l 
// \“'JS1185 expected 

import pkg1.*; 

import pkg2.*; 


class MyClass 


i 
MyType t; 
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Compiler Warning (level 1) VJS1186 


Error Message 
Type ‘type’ is imported by ‘import’ and java.lang. Using the java.lang type. 


The java.lang package is imported by default. This warning indicates that a class in java.lang package is defined in another 
package and imported using the import statement. 


The following sample generates VJS1186: 


// VIS1186.js1 

// compile with: /W:1 
// \V'JS1186 expected 
import System.*; 
class MyClass 


{ 
public static void main (String [] args) 
{ 
Exception e; // VJS1186: Exception is in java.lang package and .NET framework System 
package 
} 


} 
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Compiler Error VJS1190 


Error Message 
Field ‘field’ is ambiguous, it is inherited from several super-classes or -interfaces 


The use of a field in a derived class needs to be qualified. 


The following sample generates VJS1190: 


// VIS1190.jsl1 
interface I1 


{ 
int i = @; 
} 
interface I2 
{ 
int i = @; 
} 
public class MyClass implements I1, I2 
{ 
public static void main() 
{ 
int j = i; // \IS1190 
// try the following line instead 
// int j = 11.1; 
; 
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Compiler Error VJS1191 


Error Message 
Field ‘field’ is already defined in current class 


A field was defined more than once in a class. 


The following sample generates VJS1191: 


// VIS1191.js1 
public class MyClass 
{ 
int i; 
int i; // VJS1191, delete line or rename identifier 
public static void main() 
{ 
} 
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Compiler Error VJS1192 


Error Message 
The blank final field ‘field’ is not initialized at declaration or in constructor 


A field marked final should be initialized, either when declared or in the constructor. 


The following sample generates VJS1192: 


// VIS1192.js1 
public class MyClass // \NIS1192 
{ 
final int i; 
// try the following line instead 
// final int i = @; 
public static void main() 
uf 
} 
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Compiler Error VJS1193 


Error Message 
The final field ‘field' was initialized more than once 


A final field cannot be initialized more than once. The compiler detected that a final field was initialized in the instance 
initialization block and in the constructor. 


The following sample generates VJS1193: 
// VIS1193.js1 


class MyClass // VJS1193, delete one of the initializations 
{ 


final int i; 


} 
MyClass () 


i = 20; 
} 
public static void main() 
{ 
} 
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Compiler Error VJS1194 


Error Message 
Cannot assign ‘final’ variable or field ‘field’ 


A final field was initialized in the constructor after being initialized in the declaration. 


The following sample generates VJS1194: 


// VIS1194.js1 
class MyClass 


{ 
final int i = 20; 
MyClass () 


i= 10; // VIS1194 
public static void main (String [] args) 


{ 
} 
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Compiler Error VJS1195 


Error Message 
The blank final field ‘field’ was already initialized 


A final field was initialized twice in the constructor. 


The following sample generates VJS1195: 


// VIJS1195.jsl 
class MyClass 


{ 
final int i; 
MyClass () 
i = 10; 
i = 20; // VJS1195, delete one of the initializations 
} 
public static void main() 
{ 
} 
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Compiler Error VJS1196 


Error Message 
The blank final field ‘field’ cannot be initialized inside a loop statement 


A final field initialization appeared in a loop. A final field can only be initialized once. 


The following sample generates VJS1196: 


// VIS1196.js1 
class MyClass 


: final int i; 
{ 
int k = 1; 
while (k == 1) 
: i = 10; // VIS1196, in a loop 
} 
i = 10; 
} 
public static void main (String [] args) 
{ 
} 
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Compiler Error VJS1197 


Error Message 
The left-hand side of an assignment must be an I-value 


An assignment was ill-formed. 


The following sample generates VJS1197: 


// VIJS1197.js1 
public class MyClass 


{ 

public static void main() 

{ 
int i = 9; 
@ = i; // \“3S1197 
// try the following line instead 
// i = @; 

} 
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Compiler Error VJS1200 


Error Message 
Type ‘type’ is already a known type in the current context 


Two types with the same name were declared in the same scope. 


The following sample generates VJS1200: 


// VIS1200.js1 
class MyClass 
{ 
public class Type1 
{ 
} 
public class Type1 // \V'JS1200, second type with same name 
ic 
} 
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Compiler Error VJS1201 


Error Message 
Name ‘identifier’ is not defined in current context 


An identifier was used but not defined in the current scope. 


The following sample generates VJS1201: 


// VIS1201.js1 
public class MyClass 


{ 


public static void main() 


{ 
// int ii = 9; 
Litt; // VJS1201, uncomment previous line to resolve 
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Compiler Error VJS1202 


Error Message 
Variable ‘variable’ is already defined in current block 


A variable with the same name was declared twice. 


The following sample generates VJS1202: 


// VIS1202.js1 
public class MyClass 


{ 
public static void main() 
{ 
int i; 
int i; // \}JS1202, delete or rename 
} 


Visual J# Reference 


Compiler Error VJS1203 


Error Message 
The local variable ‘variable’ was not initialized before use 


Variables must be initialized before they are used. 


The following sample generates VJS1204: 


// VIS1203.js1 
public class MyClass 


{ 

public static void main() 

{ 
char c; 
// try the following line instead 
// char c = ‘a'; 
if (c == 'a') // VIS1203 

} 
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Compiler Error VJS1204 


Error Message 
if condition must be boolean and not ‘type’ 


The conditional portion of an if statement was not a Boolean expression. 


The following sample generates VJS1204: 


// VIS1204.js1 
public class MyClass 


{ 

public static void main() 

{ 
char c = ‘a’; 
if ('a') // VIS1204 
// try the following line instead 
// if (c == 'a') 

} 
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Compiler Error VJS1205 


Error Message 
for condition must be boolean and not ‘type’ 


The conditional portion of a for statement was not a Boolean expression. 


The following sample generates VJS1205: 


// VIS1205.js1 
public class MyClass 


{ 


public static void main() 


{ 
for (int i = @ 3 'c' 3; i++) // VIS1205 
// try the following line instead 
// for (int i =@ 35; i < 10 5 i++) 


I 
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Compiler Error VJS1206 


Error Message 
while condition must be boolean and not ‘type’ 


The conditional portion of a while statement was not a Boolean expression. 


The following sample generates VJS1206: 


// VIS1206.js1 
public class MyClass 


{ 


public static void main() 


{ 
char c = ‘a'; 
while ('c') // VIS1206 
// try the following line instead 
// while (c != 'c') 


I 
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Compiler Error VJS1207 


Error Message 
do condition must be boolean and not ‘type’ 


The conditional statement in a do loop must evaluate to type boolean. 


The following sample generates VJS1207: 


// NIJS1207.js1 
public class MyClass 


{ 

public static void main() 

{ 
int i = @; 
do 
{ : 

i++; 

} while ('c'); // VIS1207 
// try the following line instead 
// } while (i < 10); 

} 
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Compiler Error VJS1208 


Error Message 
Label ‘label’ is already defined in current statement hierarchy 


A label name was declared in the scope of a label with the same name. 


The following sample generates VJS1208: 


// VIS1208.js1 
class MyClass 


{ 
public static void main() 
{ 
int i = @; 
label1: 
af 
1 = 1; 
label1: // \VJS1208, already in label1 scope 
{ 
1= 1; 
} 
} 
} 
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Compiler Error VJS1209 


Error Message 
Label ‘label’ is not defined in current statement hierarchy 


A label was called but not declared. 


The following sample generates VJS1209: 


// VIJS1209.js1 
class MyClass 


{ 

public static void main (String [] args) 

{ 
for ( int i=0 3; i < 10 3 i++ ) 
{ 

continue MyLabel; // VJS1209, no such label declared 

} 

} 
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Compiler Error VJS1210 


Error Message 
This default selector must be unique in switch 


More than one default condition was found in a switch statement. 


The following sample generates VJS1210: 


// VIS1210.js1 
public class MyClass 


{ 
public static void main() 
{ 
int i = Q; 
switch (i) 
case @: 
default: 
default: // VIS1210 
} 
} 
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Compiler Error VJS1211 


Error Message 
Label ‘label’ is already defined in current switch 


The compiler found two case statements with duplicate values. 


The following sample generates VJS1211: 


// VIJS1211.js1 
public class MyClass 


{ 
public static void main() 
{ 
int i = Q; 
switch (i) 
case @: 
case @: // NIS1211 
// try the following line instead 
// case 1: 
is 
} 
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Compiler Error VJS1212 


Error Message 
switch label must be ordinal and not ‘type’ 


The value specified to a case statement was not an ordinal. 


The following sample generates VJS1212: 


// VIJS1212.js1 
public class MyClass 


{ 
public static void main() 
{ 
int i = @; 
switch (i) 
case "abc": // \VJS1212, string not an ordinal 
// try the following line instead 
// case @: 
default: 
} 
} 
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Compiler Error VJS1213 


Error Message 
switch label must be constant value 


The value passed to a case statement was not a constant. 


The following sample generates VJS1213: 


// VIS1213.jsl 
public class MyClass 


{ 
public static void main() 
{ 
int i = Q; 
switch (i) 
case i: // NIS1213 
// try the following line instead 
// case @: 
default: 
} 
} 
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Compiler Error VJS1214 


Error Message 
switch expression must be ordinal 


The value passed to a switch statement was not an ordinal. 


The following sample generates VJS1214: 


// VIS1214.js1 
public class MyClass 
{ 


public static void main() 
{ 
int i = @; 
switch ("abc") // VIS1214, string not an ordinal 
// try the following line instead 
// switch (i) 
{ 
case @: 
default: 
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Compiler Error VJS1215 


Error Message 
Synchronized expression must be reference type 


The value passed to a synchronized expression must be a reference type. 


The following sample generates VJS1215: 


// VIJS1215.jsl 
class Test 


a 


public static void main() 


{ 


boolean tf = true; 
Test t = new Test(); 
synchronized(tf) // VJS1215, to resolve, pass t to synchronized 


synchronized(tFf) 
{ 
} 
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Compiler Error VJS1216 


Error Message 
Statement is unreachable 


The compiler found a statement that will never be executed. 


The following sample generates VJS1216: 


// VIS1216.js1 
class Test 


{ 
public static void main() 
{ 
int i = 1; 
do 
break; 
i++; // \VJS1216, break statement makes this unreachable 
} while (i != @); 
} 
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Compiler Error VJS1217 


Error Message 
This statement does not perform any action 


The compiler found a statement that has no effect. 


The following sample generates VJS1217: 


// VIS1217.js1 
class Test 


{ 
public static void main() 
{ 
int i = 1; 
i; // VIS1217, no effect 
} 
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Compiler Error VJS1219 


Error Message 
An expression is required in this context, not type name ‘type’ 


A type name was found where an expression was expected. 


The following sample generates VJS1219: 


// VIS1219.js1 
public class MyClass 
{ 


public static void main() 
{ 
int i = Q; 
switch (MyClass) // VIS1219 
// try the following line instead 
// switch (i) 
{ 
case @: 
default: 
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Compiler Error VJS1220 


Error Message 
Cannot resolve name 'name' 


The compiler found a reference to a member, but the referenced member does not exist in this type. A common cause of this 
error is when incorrect syntax is used to reference a property. In J#, unlike some other .NET languages, you must use the "get_ 
and "set_" versions of property accessors. 


The following two examples generate VJS1220 


// NIS1220.vjs 
class MyClass { 
public static void main() { 
System.Console.WriteLine(System.IntPtr.Size) ; // VIS1220 
System.Console.WriteLine(System.IntPtr.get_Size()); // OK 


// VIS1220.js1 
public class MyClass 


{ 
/* 
public static class InnerClass 
{ 
public static void Test() 
{ 
} 
} 
*/ 
public static void main (String [] args) 
{ 
MyClass.InnerClass.Test(); // \N}JS1226, uncomment InnerClass to resolve 
} 
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Compiler Error VJS1222 


Error Message 
Cannot execute continue statement outside a loop context 


A continue statement was found outside of a loop. 


The following sample generates VJS1222: 


// VIS1222.js1 
public class MyClass 


{ 
public static void main() 
{ 
continue; // NIS1222 
} 
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Compiler Error VJS1223 


Error Message 
Cannot find method 'method' in 'type' 


The signature of a method did not match a call to the method. 


The following sample generates VJS1223: 


// VIS1223.js1 
public class MyClass 
{ 

public void Test() 

if 

} 


public static void main() 

{ 
MyClass x = new MyClass(); 
x.Test(1);  // VIS1223 
// try the following line instead 
// x.Test()3 
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Compiler Error VJS1224 


Error Message 
Cannot qualify call to super in class ‘class’. The super class is not an inner class 


The compiler could not resolve a super call because the super class is not an inner class. 


The following sample generates VJS1224: 


// VIS1224.js1 
public class MyClass 


{ 
public MyClass () 
{ 
new Classi ().super (); // VIS1224, delete this line to resolve 
public static void main (String [] args) 
{ 
} 
} 


public class Class1 


{ 
} 
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Compiler Error VJS1225 


Error Message 
Must qualify call to super in class ‘class’. The super class is an inner class 


If a type extends a non-static inner class, it is not valid to call the super constructor directly; an instance of the enclosing class of 
that inner class is needed. 


The following sample generates VJS1225: 


// VIS1225.jsl1 
public class MyClass extends Classi.Inner 


{ 
MyClass() 
super();  // VIS1225 
// try the following line to resolve 
// new Classi(). super(); 
public static void main (String [] args) 
{ 
} 
} 


public class Class1 

{ 
public class Inner 
// or, make the inner class static 
// public static class Inner 


{ 
} 
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Compiler Error VJS1227 


Error Message 
Cannot find constructor ‘constructor’ 


The signature of a constructor did not match a call to the constructor. 


The following sample generates VJS1227: 


// NIS1227.js1 
public class MyClass 
{ 
// Uncomment this constructor to fix the error. 
// MyClass(int i) 
fit 
/f 4 
public static void main() 
{ 
MyClass x = new MyClass(9); // NIS1227 
x.Test(); 


public void Test() 


{ 
} 
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Compiler Error VJS1228 


Error Message 
Method 'method' is already defined in current class 


A method was defined twice. 


The following sample generates VJS1228: 


// VIS1228.js1 
public class MyClass 
{ 
public void Test() 
{ 
} 
public static void main() 
< 
} 
public void Test() // VIS1228, duplicate method definition 
{ 
} 
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Compiler Error VJS1231 


Error Message 
The call of method 'method' is ambiguous 


The compiler was unable to determine which method to call. 


The following sample generates VJS1231: 


// VIS1231.js1 


public class MyClass1 


{ 
} 
public class MyClass2 extends MyClass1 
{ 
} 
class MyClass3 
{ 
public void Test(MyClass2 mc2, MyClassi1 mc1) 
{ 
} 
public void Test(MyClass1 mc1, MyClass2 mc2) 
{ 
} 
public static void main() 
t 


MyClass2 mc2 = new MyClass2(); 
Test(mc2, mc2); // VIS1231 
} 
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Compiler Error VJS1232 


Error Message 
Cannot have an explicit call to method 'method' 


The compiler produces some internal methods on which users are not allowed to do explicit calls. 
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Compiler Error VJS1233 


Error Message 
Bad method name 


A method name was not valid. Valid characters for an identifier are: 
e Letters A-Z and a-z, 
e Characters '_' and '$' 
e Digits 0-9 


The following sample generates VJS1233: 


// VIS1233.jsl1 
public class MyClass 


{ 


public static void main (String [] args) 


1234(); // VIS1233, invalid method name 
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Compiler Error VJS1234 


Error Message 
Explicit 'this' or ‘super’ invocation only allowed as first statement of constructor 


The use of this and super is restricted to the first line, when used in a constructor. 


The following sample generates VJS1234: 


// VIS1234.js1 
public class MyClass1 


MyClass1() 

{ 

} 
} 
public class MyClass2 extends MyClass1 
{ 

int i; 

MyClass2() 

i = Q; 


super(); // VIJS1234, make this the first line 


public static void main() 


t 
} 
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Compiler Error VJS1237 


Error Message 
Exception ‘exception’ is not caught and does not appear in throws clause 


A throws clause must specify the exceptions thrown from a method or the exception should be caught using try-catch clause. 


The following sample generates VJS1237: 


// VIS1237.js1 

// compile with: /target:library 

public class MyClass 

{ 
// Try the following line instead: 
// void method() throws Exception 
void method () 


throw new Exception (); // NIS1237 
// Exception should be caught or declared using throws clause 
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Compiler Error VJS1238 


Error Message 
Exception ‘exception’ cannot be thrown by static initializer or static field initializer 


Checked (non-runtime) exceptions cannot be thrown in the static initializer blocks. 


The following sample generates VJS1238: 


// VIS1238.js1 
class MyClass 
{ 
static 
{ 
throw new java.io. IOException(); // VIS1238 
// OK to throw run-time exceptions 
// throw new NullPointerException(); 
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Compiler Error VJS1239 


Error Message 
Exception ‘exception’ thrown by the field initializer or the constructor is not caught and does not appear in throws clause of the 
constructor 


A constructor threw an exception, but the exception was not declared in the declaration. 
The following samples generate VJS1239: 


If a method throws any exception using a throw statement, it should be declared in the method declaration using a throws 
clause. 


// VIS1239a.jsl 
public class MyClass 


MyClass() // throws Exception 
throw new Exception(); // \V}JS1239, uncomment throws clause in declaration 


public static void main (String [] args) throws Exception 


t 
} 


new MyClass (); 


If a method throws any exception using a throws statement, it should be caught using a try-catch block. 


// VIS1239b.js1 
public class MyClass // \VJS1239, uncomment the following lines to resolve 


// 
// try 
// { 
int x = Test(); 
// } catch (Exception e) { 
// } 
// 


int Test() throws Exception 


return 10; 


} 
public static void main (String [] args) 
{ 
new MyClass (); 
} 
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Compiler Error VJS1240 


Error Message 
Instance method cannot override static method 'method' 


An overriding method must use the same instance/static status as the method being overridden. 


The following sample generates VJS1240: 


// VIS1240.js1 
class MyClass1 


4 
public static void Test() 
{ 
} 

i 


class MyClass2 extends MyClass1 

{ 
public void Test() // VIS1240, static/instance must agree with MyClassi1 Test 
// try the following line instead 
// public static void Test() 


{ 

} 

public static void main() 

{ 
MyClass2 x = new MyClass2(); 
x.Test(); 

b: 
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Compiler Error VJS1241 


Error Message 
Static method cannot override instance method 'method' 


An overriding method must use the same instance/static status as the method being overridden. 


The following sample generates VJS1241: 


// VIS1241.js1 
class MyClass1 


af 
public void Test() 
{ 
} 

} 


class MyClass2 extends MyClass1 

{ 
public static void Test() // \VIJS1241, static/instance must agree with MyClass1 Test 
// try the following line instead 
// public void Test() 


{ 

public static void main() 

{ 
MyClass2 x = new MyClass2(); 
x.Test(); 

} 
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Compiler Error VJS1242 


Error Message 
Cannot override final method 'method' 


You cannot override the final method of a base class. 
The following sample generates VJS1242: 
// VIS1242.js1 


// compile with: /target:library 
public class Base 


‘ public static final int Test() 
{ 
return @; 
} 
} 
public class Derived extends Base 
: public static int Test() // VIS1242, hides Base.Test 
{ 
return 1; 
} 


Visual J# Reference 


Compiler Error VJS1243 


Error Message 
Cannot override final method 'method' 


A final method cannot be overridden. 


The following sample generates VJS1243: 


// VIS1243.js1 
class MyClass1 


public final void Test() 


{ 
} 
} 
class MyClass2 extends MyClass1 
{ 
public void Test() // VIS1243, MyClass1.Test is final 
{ 
} 
public static void main() 
{ 
MyClass2 x = new MyClass2(); 
x.Test(); 
} 


Visual J# Reference 


Compiler Error VJS1245 


Error Message 
Methods 'method1' and 'method2' differ in return types only 


An overriding method must have the same return type as the method being overridden. 


The following sample generates VJS1245: 


// VIS1245.jsl 

class MyClass1 

af 
public void Test() 
{ 
} 

} 


class MyClass2 extends MyClass1 
: public int Test() // VIS1245, MyClass1.Test returns void 
uf 
} 
public static void main() 
{ 
} 
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Compiler Error VJS1246 


Error Message 
Method 'method' throws ‘exception’ not in throws clause of 'super' method 


An overriding method did not have the same exception specification as the method it is overriding. 


The following sample generates VJS1244: 


// VIS1246.js1 
public class MyClass extends Base 
{ 
public void Method() throws Exception // VIJS1246 
// uncomment exception specification in base method to resolve 
{ 
} 
public static void main (String [] args) 
{ 
} 
} 


class Base 
{ 
public void Method() // throws Exception 


{ 
i 
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Compiler Error VJS1247 


Error Message 
Method 'method' redefines 'super' method with more restrictive access 


An overriding method cannot have more restrictive access than the method it is overriding. 


The following sample generates VJS1247: 


// NIS1247.js1 
public class MyClass1 
{ 
public void Text() 
{ 
} 
} 


public class MyClass2 extends MyClass1 
: private void Text() // VIS1247, base class Text is public 
{ 
} 
public static void main() 
{ 
} 
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Compiler Error VJS1248 


Error Message 
Cannot access method 'method' 


A method was not accessible. 


The following sample generates VJS1248: 


// VIS1248.js1 
public class MyClass1 


{ 
private void Test() 
{ 
} 

} 


class MyClass2 extends MyClass1 
{ 


public static void main() 


t 
MyClass1 x = new MyClass1(); 


x.Test(); // VIS1248, Test is private 
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Compiler Error VJS1249 


Error Message 
Cannot access inherited member ‘member’ through this object 


You cannot access member because of its accessibility level. 


Example 


// VIS1249a.jsl 
// compile with: /target:library 


package p; 
public class MyClass 
{ 


protected void m() {} 
public void n() {} 


The following sample generates VJS1249. 


// VIS1249b.js1 
// compile with: VJS1249a.jsl 
public class MyClass2 extends p.MyClass 
{ 
public static void main(String[] args) 
{ 
new p.MyClass().m(); // NIS1249 
new p.MyClass().n()3 // OK 
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Compiler Error VJS1250 


Error Message 
The prefix of method 'method' must be a reference, not ‘type’ 


A method call needs to be qualified by a reference to the type that contains the method. 


The following sample generates VJS1250: 


// VIS1250.jsl1 
public class MyClass 


{ 
public static void main (String [] args) 
{ 
MyClass x = new MyClass(); 
int i; 
i = 10; 


i.Test();  // VIS1250 
// try the following line instead 
// x.Test()3 


public void Test() 
{ 
} 
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Compiler Error VJS1251 


Error Message 
Missing return type for method 'method' 


A method was missing a return type specification. 


The following sample generates VJS1251: 


// VIS1251.jsl 

public class MyClass 

{ 
public static main() // VIS1251 
// try the following line instead 
// public static void main() 
{ 
} 
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Compiler Error VJS1252 


Error Message 
Actual parameter for byref ‘parameter’ must be assignable 


A method that takes a parameter by reference was called, but the parameter passed is not assignable as a literal; pass a 
variable. 


Example 


// VIS1252a.cs 

// compile with: /target:library 
// a C# program 

public class RefClass 


{ 
} 


public void method (ref int x) {} 


// VIS1252b.js1 

// compile with: /reference:VJS1252a.d11 
public class MyClass 

{ 


public static void main (String [] args) 


{ 
int x = 10; 
new RefClass ().method (10); // VIS1252 
new RefClass ().method (x); // OK 
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Compiler Error VJS1253 


Error Message 
Cannot pass object of type 'type1' as parameter of type ‘type2' 


A reference parameter was passed, but the type did not match the type declared in the method. 


Example 


// VIS1253a.cs 

// compile with: /target:library 
// a C# program 

public class RefClass 


{ 
} 


public void Test(ref int x) {} 


The following samples generate VJS1253. 


// VIS1253b.js1 
// compile with: /reference:VJS1253a.d11 
class MyClass 


{ 
public static void main (String [] args) 
{ 
short x = @; 
new RefClass ().Test(x); // VIS1253 
int y = Q; 
new RefClass ().Test(y); // OK 
} 
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Compiler Error VJS1254 


Error Message 
Method 'method' defined in an interface cannot have a body 


Methods in an interface can be declared, but not defined. 
The following sample generates VJS1254: 


// VIS1254.js1 
interface MyInterface 


void Test() {} // VIJS1254 
// try the following line instead 
// void Test(); 


} 

public class MyClass1 

{ 
public static void main() 
{ 
} 
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Compiler Error VJS1255 


Error Message 
Abstract method ‘method’ cannot have a body 


Methods marked as abstract can be declared, but not defined. 


The following sample generates VJS1255: 


// VIS1255.jsl 
abstract public class MyClass 
{ 
public abstract void Test(){}  // VIS1255 
// try the following line instead 
// public abstract void Test(); 
// or delete the abstract keyword and keep the method body 
public static void main() 
{ 
} 
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Compiler Error VJS1256 


Error Message 
Native method 'method' cannot have a body 


Methods marked as native can be declared, but not defined. 


The following sample generates VJS1256: 


// VIS1256.jsl 
// 
public class MyClass 
{ 
public native void Test(){} // VIS1256 
// try the following line instead 
// public native void Test(); 
// or delete the native keyword and keep the method body 
public static void main() 
{ 
} 
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Compiler Error VJS1257 


Error Message 
Method 'method' is not abstract and does not have a body 


A method in a class was not defined. 


The following sample generates VJS1257: 


// NIJS1257.js1 

// 

public class MyClass 

{ 
public void Test();  // VJS1257 
// try the following line instead 
// public void Test(){} 
public static void main() 
{ 
} 
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Compiler Error VJS1259 


Error Message 
Method 'method' must return a value 


A method signature specified a return value, but no return statement was found in the body of the method implementation. 


The following sample generates VJS1259: 


// VIS1259.jsl 
public class MyClass 
{ 


public int Test() // \V}JS1259, uncomment return statement to resolve 


{ 
// return @; 


public static void main() 


{ 
} 
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Compiler Error VJS1265 


Error Message 
return statement is not allowed in initializer 


The compiler found a return statement in an initializer block. 


The following sample generates VJS1265: 


// VIS1265.jsl 
public class MyClass // \VIS1265 
{ 

{ 


return; // return not allowed in initializer block 


public static void main (String [] args) 


x 
} 


Visual J# Reference 


Compiler Error VJS1271 


Error Message 
Only one access modifier is allowed 


An access modifier was repeated. 


The following sample generates VJS1271: 


// VIS1271.js1 
public class MyClass 
{ 
public private void Test() // VIJS1271, delete one public 
{ 
} 
public static void main() 
{ 
} 
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Compiler Error VJS1275 


Error Message 
Class name 'name' conflicts with package name 


The name of a class in one module was the same as a package in another module. 


Example 


// NVIS1275a.jsl 

// compile with: /target:library 
package Test; 

public class MyClass {} 


The following samples generate VJS1275. 


// VIS1275b.js1 
// compile with: VJS1275a.jsl /target:library 
public class Test {} // VIS1275 
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Compiler Error VJS1276 


Error Message 
The label ‘label’ used in the continue statement must point to a loop statement 


A label in a continue statement did not point to a loop. 


The following sample generates VJS1276: 


// VIS1276.js1 
public class MyClass 


{ 


public static void main() 
label1: for (int i = @; i < 100; ++i) 


label2: 

{ 
continue label2; // \'JS1276 
// try the following line instead 
// continue label1; 
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Compiler Error VJS1277 


Error Message 
‘member’ is not supported 


You cannot access a member that is no longer supported. 


Example 


// NIS1277a.cs 

// compile with: /target:library 
// a C# program 

public class MyClass 


[System.ObsoleteAttribute("", true) ] 
public static void m() {} 


The following samples generate VJS1277. 


// NIJS1277.js1 

// compile with: /reference:vjs1277a.d1l 
public class MyClass2 

{ 


public static void main(String[] args) 


MyClass.m(); = // VJS1277 
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Compiler Error VJS1278 


Error Message 
Cannot define methods 'method1' and 'method2' in the same class 


The following set of methods can not be used in the same class: 


® String toString () and String ToString () 





® Boolean equals (Object) and Boolean Equals (Object) 


The following sample generates VJS1278: 


// VIS1278.js1 
public class MyClass // NIS1278 


{ 


public String toString() {} 
public String ToString() {} 
public static void main(String[] args) 


{ 
} 


new MyClass() { }3 
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Compiler Error VJS1279 


Error Message 
‘member’ must be implemented by the anonymous class 


An anonymous class is never abstract, and must implement all abstract methods it contains. 


The following sample generates VJS1279: 


// VIS1279.js1 
public abstract class MyClass 


{ 


abstract void m(); 
public static void main(String[] args) 


{ 
} 


new MyClass() { }3 // NIS1279 
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Compiler Error VJS1280 


Error Message 
‘type’ is not a nested class or interface in class ‘class’ 


The compiler detected an attempt to instantiate a type that is not a nested class or interface in the class. 


The following sample generates VJS1280: 


// VIS1280.js1 
public class MyClass 


{ 
public static void main(String[] args) 
{ 
new MyClass().new Inner(); // VIS1280 
} 
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Compiler Error VJS1281 


Error Message 
Ambiguous member: inherited ‘member1' and outer scope ‘member2’. An explicit 'this' qualifier is required 


The compiler cannot determine which member you are trying to access. 


The following sample generates VJS1281: 


// VIS1281.js1 
// compile with: /target:library 
class Base { 

int i; 


} 


class Outer { 
int i; 
class Derived extends Base { 
int j = i; 


} 
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Compiler Error VJS1282 


Error Message 
Cannot declare type ‘type’ 


The System.Object and System.String types cannot be declared in a source file. 


The following sample generates VJS1282: 


// VIS1282.js1 

// compile with: /target:library /nowarn:1513 
package System; // VIS1282 

class Object { 


} 
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Compiler Error VJS1284 


Error Message 
Cannot have inner classes as attributes, value-types or enumeration types. 


This error results from declaring an inner class as an attribute, a value type, or an enumeration type. 


To correct this error 


e Check your code to determine which inner class is an attribute, value-type or enumeration type. 


Example 
The following sample generates VJS1284 


public class MyClass 


{ 
public final class Point extends System.ValueType 
: 
public int x; 
public int y; 
} 
} 
See Also 


Other Resources 
Visual J# Compiler 
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Compiler Error VJS1300 


Error Message 
‘value’ is not in range of ‘type’ 


A value was assigned to a type, but the value is out of the range of those supported for that type. 


The following sample generates VJS1301: 


// VIS1300.js1 
class MyClass 
{ 
public static void main (String [] args) 
{ 
byte i = 256; // VIS1300, 256 out of range for byte 
// try the following line instead 
// byte i = 127; 
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Compiler Error VJS1301 


Error Message 


Type 'type1' is not assignable to 'type2' 
An invalid assignment was attempted. 


The following sample generates VJS1301: 


// VIS1301.js1 
public class MyClass 


{ 


public static void main() 


{ 
int i = 2.2; // VIS1301 


// try the following lines instead 
// int i = 2; 
// i++; 
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Compiler Error VJS1302 


Error Message 
Cannot access non-static field ‘field’ from a static context 


An attempt was made to access an instance field as if it were a static field. 
The following sample generates VJS1302: 
// VIS1302.js1 


// compile with: /target:library 
class MyClass 


{ 
public void MyMethod() 
{ 
Test.x = 10; // \VJS1302 x is not static in class Test 
int local = new Test ().x;3 // OK, accessing instance field 
Test.y = 20; // OK, accessing static field 
} 
} 


class Test 


4 


public int x; // instance field 
public static int y; // static field 
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Compiler Error VJS1303 


Error Message 
Cannot access non-static method 'method' from a static context 


An instance method has to be accessed by means of an instance of its enclosing type. 


The following sample generates VJS1303: 


// VIS1303.js1 
class MyClass 


{ 
public void Test() 
{ 
} 
public static void main (String [] args) 
if 
MyClass.Test();  // VJS13@3 
// try the following lines instead 
// MyClass x = new MyClass(); 
// x.Test()3 
} 
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Compiler Error VJS1304 


Error Message 
Cannot access constructor of class 'class' 


A constructor was inaccessible. 


The following sample generates VJS1304: 


// VIS1304.js1 
class MyClass 


{ 
public static void main (String [] args) 
{ 
new Class1(); // VIS1304 constructor is private 
new Class1(10@); // OK, constructor is public 
} 
} 
class Classi 
{ 
private Classi() 
{ 
public Classi(int x) 
{ 
} 
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Compiler Error VJS1305 


Error Message 
Condition in conditional expression must be boolean 


The expression that is evaluated in a conditional expression must be a Boolean expression. 


The following sample generates VJS1305: 


// VIS1305.jsl 
class Test 


{ 

public static void main(String[] args) 

{ 
int i = Q; 
boolean j = (i) ? true : false; // VIS1305 
// try the following line instead 
// boolean j = (i == 0) ? true : false; 

} 
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Compiler Error VJS1306 


Error Message 
Types 'type1' and 'type2' are incompatible for conditional expression 


A conditional expression contained incompatible types. 


The following sample generates VJS1306: 


// VIS1306.js1 
class MyClass 


{ 
public static void main (String [] args) 
{ 
int j = 3 < 10 ? 1 : new Object(); // VIS1306 object not int 
intk=3<10?1: 3; 4// OK 
} 
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Compiler Error VJS1307 


Error Message 
Cannot create a new object of type ‘type’ because it is an ‘abstract’ class 


An abstract class cannot be instantiated. 


The following sample generates VJS1307: 


// NVIS1307.js1 
abstract public class MyClass1 
{ 


} 


public abstract void Test(); 


public class MyClass2 


public static void main() 


{ 
} 


MyClass1 x = new MyClass1(); // VIS1307 
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Compiler Error VJS1308 


Error Message 
Cannot create a new object of type ‘type’ because it is an interface 


An object cannot be instantiated from an interface. 
The following sample generates VJS1308: 


// VIS1308.js1 
class MyClass 


{ 


public static void main (String [] args) 
MyInterface i = new MyInterface(); // VIS138 


} 


interface MyInterface 
{ 
} 
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Compiler Error VJS1309 


Error Message 
Cannot create an instance of a primitive type with ‘new’ 


The new operator cannot be used to create an instance object of a primitive type. 


The following sample generates VJS1309: 


// VIS1309.js1 
class Test 
{ 
public static void main(String[] args) 
{ 
int i = new int(); // VIS1309 
// try the following line instead 
// int i; 


Visual J# Reference 


Compiler Error VJS1312 


Error Message 
Cannot apply postfix operator to ‘type’ 


The postfix increment operator (++) was applied to a variable, the type of which does not support the postfix operator. 


The following sample generates VJS1312: 


// VIS1312.js1 
class Test 


{ 
public static void main(String[] args) 
{ 
Test x = new Test(); 
X++5 // \IJS1312 
} 
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Compiler Error VJS1313 


Error Message 
Cannot apply postfix operator to something that is not assignable 


The postfix operator was applied to a token that could not be performed. 


The following sample generates VJS1313: 


// VIS1313.jsl 
class Test 


{ 
public static void main(String[] args) 
{ 
int i = Q; 
O++5 // VIS1313 
// try the following line instead 
// itt; 
} 


Visual J# Reference 


Compiler Error VJS1314 


Error Message 
Cannot apply postfix operator to a variable that is not initialized 


The postfix increment operator (++) was applied to a variable that may not have yet been initialized. 


The following sample generates VJS1314: 


// VIS1314.js1 
class Test 


{ 
public static void main(String[] args) 
{ 
int i; 
i++; // VIS1314, initialize i first 
} 
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Compiler Error VJS1315 


Error Message 
Cannot apply prefix operator to ‘type’ 


The prefix increment operator (++) was applied to a variable, the type of which does not support the prefix operator. 


The following sample generates VJS1315: 


// VIS1315.jsl 
class Test 


{ 
public static void main(String[] args) 
{ 
Test x = new Test(); 
--X; // \“IS1315 
} 


Visual J# Reference 


Compiler Error VJS1316 


Error Message 
Cannot apply prefix operator to something that is not assignable 


The prefix operator was applied to a token that could not be performed. 


The following sample generates VJS1316: 


// VIS1316.jsl 
class Test 
{ 
public static void main(String[] args) 
{ 
int i = @; 
--@; // \VJS1316 
// try the following line instead 
// --i; 
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Compiler Error VJS1317 


Error Message 
Cannot apply prefix operator to a variable that is not initialized 


The prefix operator was applied to a variable that may not have yet been initialized. 


The following sample generates VJS1317: 


// VIJS1317.js1 
class Test 


{ 
public static void main(String[] args) 
{ 
int i; 
--i; // VIJS1317, initialize i first 
} 
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Compiler Error VJS1318 


Error Message 
Cannot apply unary operator + / - to ‘type’ 


Unary operators only can be used on numeric types. 


The following sample generates VJS1318: 


// VIS1318.js1 
class MyClass 


{ 
public static void main (String [] args) 
{ 
Object obj =- (new Object()); // VIS1318 
} 
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Compiler Error VJS1319 


Error Message 
Cannot apply unary operator ~ to ‘operand’ 


The unary ~ operator is not valid on the operand. 


The following sample generates VJS1319: 


// VIS1319.jsl 
class Test 


{ 


public static void main(String[] args) 


{ 


Test x = new Test(); 

x = ~x;  // VIS1319 

// try the following lines instead 
// byte i = 25; 

// byte j = ~25; 
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Compiler Error VJS1320 


Error Message 
Cannot apply unary operator ! to ‘type’ 


The unary operator ! was applied to a type that does not support negation. 


The following sample generates VJS1320: 


// VIS1320.js1 
class Test 


{ 
public static void main(String[] args) 
{ 
int i; 
boolean j = true; 
i = Q; 
if (!i)  // VIS1320 
// try the following line instead 
// if (!95) 
{ 
} 
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Compiler Error VJS1321 


Error Message 
Cannot apply '==' operator to 'type1' and 'type2' 


A comparison was attempted between types for which comparisons are not supported. 


The following sample generates VJS1321: 


// VIS1321.js1 
class Test 


{ 
public static void main(String[] args) 
{ 
Test x = new Test(); 
if (x == 1)  // VJS1321 
} 
} 
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Compiler Error VJS1322 


Error Message 
Cannot apply relational operator to 'type1' and ‘type2' 


A relational operation was attempted between types for which relational operations are not supported. 


The following sample generates VJS1322: 


// VIS1322.js1 
class Test 


a 


public static void main(String[] args) 


{ 


Test x = new Test(); 
if (x <1) // VJS1322 


} 
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Compiler Error VJS1323 


Error Message 
Cannot apply '+' operator to 'type1' and 'type2' 


An additive operation was attempted between types for which additive operations are not supported. 


The following sample generates VJS1323: 


// VIS1323.jsl 
class Test 


{ 
public static void main(String[] args) 
{ 
Test x = new Test(); 
if (x +1)  // VIS1323 
} 
} 
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Compiler Error VJS1324 


Error Message 
Cannot apply '*' operator to ‘type’ and ‘type2' 


A multiplicative operation was attempted between types for which multiplicative operations are not supported. 


The following sample generates VJS1324: 


// VIS1324.js1 
class Test 


{ 
public static void main(String[] args) 
{ 
Test x = new Test(); 
if (x * 1) // VIS1324 
} 
} 
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Compiler Error VJS1325 


Error Message 
Cannot apply '/' operator to 'type1' and ‘type2' 


A division operation was attempted between types for which division operations are not supported. 


The following sample generates VJS1325: 


// VIS1325.jsl 
class Test 


{ 
public static void main(String[] args) 
{ 
Test x = new Test(); 
if (x / 1) // VIS1325 
} 
} 
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Compiler Error VJS1326 


Error Message 
Cannot apply '-' operator to 'type1' and ‘type2' 


A subtraction operation was attempted between types for which subtraction operations are not supported. 


The following sample generates VJS1326: 


// VIS1326.js1 
class Test 


{ 
public static void main(String[] args) 
{ 
Test x = new Test(); 
if (x - 1)  // VIS1326 
} 
} 
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Compiler Error VJS1327 


Error Message 
Cannot apply '%' operator to ‘type’ and 'type2' 


A modulus operation was attempted between types for which modulus operations are not supported. 


The following sample generates VJS1327: 


// VIS1327.js1 
class Test 


{ 
public static void main(String[] args) 
{ 
Test x = new Test(); 
if (x %1)  // VIS1327 
} 
} 
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Compiler Error VJS1328 


Error Message 
Cannot apply bitwise &, “, | operators to 'type1' and 'type2' 


An operation was attempted between types for which the operation is not supported. 


The following sample generates VJS1328: 


// VIS1328.js1 
class Test 


{ 
public static void main(String[] args) 
{ 
Test x = new Test(); 
if (x &1)  // VIS1328 
} 
} 
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Compiler Error VJS1329 


Error Message 
Cannot apply shift <<, >>, >>> operators to 'type1' and 'type2' 


An operation was attempted between types for which the operation is not supported. 


The following sample generates VJS1329: 


// VIS1329.js1 
class Test 


{ 
public static void main(String[] args) 
{ 
Test x = new Test(); 
if (x << 1) // VIS1329 
} 
} 
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Compiler Error VJS1330 


Error Message 
Cannot divide a number by zero 


Division by zero is undefined, and therefore is not a valid operation. 


The following sample generates VJS1330: 


// VIS1330.jsl 
class Test 


{ 
public static void main(String[] args) 
{ 
int i= 1/0; // VIS133e 
} 
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Compiler Error VJS1331 


Error Message 
Cannot apply '&&' operator to 'type1' and ‘type2' 


An operation was attempted between types for which the operation is not supported. 


The following sample generates VJS1331: 


// VIS1331.jsl 
class Test 


{ 
public static void main(String[] args) 
{ 
Test x = new Test(); 
if (x 8&1) // VIS1331 
} 
} 
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Compiler Error VJS1332 


Error Message 
Cannot apply '||' operator to 'type1' and 'type2' 


An operation was attempted between types for which the operation is not supported. 


The following sample generates VJS1332: 


// VIS1332.js1 
class Test 


{ 
public static void main(String[] args) 
{ 
Test x = new Test(); 
if (x |] 1) // vIS1332 
} 
} 
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Compiler Error VJS1333 


Error Message 
Cannot cast from ‘type1' and 'type2' 


A cast was attempted between types for which a cast is not supported. 


The following sample generates VJS1333: 


// VIS1333.jsl 
class Test 
{ 
public static void main(String[] args) 
{ 
Test x = new Test(); 
int i = Q; 
i = (int)x;  // VIS1333 
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Compiler Error VJS1334 


Error Message 
The type ‘type1' cannot be returned as a ‘type2' 


A method returned a different type than expected. 


The following sample generates VJS1334: 


// VIS1334.jsl 
class Test 


{ 
public int Test() 
{ 
Test x = new Test(); 
return x; // NIS1334 
// try the following line instead 
// return @; 
} 
public static void main(String[] args) 
{ 
J 


Visual J# Reference 


Compiler Error VJS1335 


Error Message 
Must return a value from a non-void method 


A method had a non-void return type, but the body of the method has a return statement with no value. 
The following sample generates VJS1335: 
// VIS1335.js1 


// compile with: /target:library 
public class MyClass 


{ 
public int Test() 
{ 
return; // \'IJS1335 
// try the following line instead 
// return @; 
} 
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Compiler Error VJS1336 


Error Message 
Cannot return a value from a void method 


A method marked as having a void return type cannot return a value. 


The following sample generates VJS1336: 


// VIS1336.jsl 
public class MyClass 


{ 
public static void Test() 


{ 
return @; // VJS1336, delete return value 


public static void main() 
{ 
} 
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Compiler Error VJS1337 


Error Message 
Cannot return a value from a constructor 


A constructor cannot contain a return statement. 


The following sample generates VJS1337: 


// VIS1337.jsl 
class Test 


{ 
Test() 
{ 
return @; // VJS1337, delete return statement 

F 

public static void main(String[] args) 

{ 

} 
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Compiler Error VJS1338 


Error Message 
Cannot apply operator ‘instanceof' to 'type1' and 'type2' 


An instanceof operation involved two incompatible types. 


The following sample generates VJS1338: 


// VIS1338.jsl 
class Test 


{ 
public static void main(String[] args) 
{ 
Test x = new Test(); 
if (x instanceof Test2) // VIS1338 
// try the following line instead 
// if (x instanceof Test) 
{ 
} 
} 
} 


class Test2 


{ 
} 
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Compiler Error VJS1339 


Error Message 
The right-hand side of ‘instanceof! must be a reference type, not ‘type’ 


The identifier to the right of the instanceof operator must be a reference type. 


The following sample generates VJS1339: 


// VIS1339.jsl 
class Test 


{ 

public static void main(String[] args) 

{ 
Test x = new Test(); 
if (x instanceof int) // NIS1339 
// try the following line instead 
// if (x instanceof Test) 
{ 
} 

} 
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Compiler Error VJS1340 


Error Message 
Missing array index 


An array operation was missing an index into the array. 


The following sample generates VJS1340: 


// VIS1340.js1 
class Test 


{ 
public static void main(String[] args) 
{ 
int[] x = new int[5]; 
x[] = @3 // \N'IS1340 
// try the following line instead 
// x[@] = ®; 
} 
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Compiler Error VJS1341 


Error Message 
Cannot specify array bounds with initializer 


When you initialize an array using an initialization list, you cannot specify the array dimension. 
The following sample generates VJS1341: 
// VIS1341.js1 


// compile with: /target:library 
class MyClass 


{ 

public void Test() 

{ 
int arr[] = new int[2]{1,2}; // VJS1341 
// try the following line instead 
// int arr[] = new int[]{1,2}; 
arr[@] = Q; 

} 
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Compiler Error VJS1342 


Error Message 
Array accessor must be ordinal but was ‘type’ 


While accessing the elements of an array, an index was used whose type was not an integral type. 


The following sample generates VJS1342: 


// VIS1342.js1 
public class MyClass 


{ 

public static void main() 

{ 
int arr[] = {1,2}; 
String str = "test"; 
arr[str] = 1; // VIS1342, str is type String, not int 
// try the following line instead 
arr[@] = 1; 

} 
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Compiler Error VJS1343 


Error Message 
Array accessor prefix must be an array type but was ‘type’ 


The array accessor operator [] was used on a variable that is not an array. 


The following sample generates VJS1343: 


// VIS1343.jsl 
public class MyClass 
{ 
public static void main() 
{ 
int i = Q; 
int arr[] = {1,2}; 
if[e@] = 1; // VIS1343 i is not an array so i[@] is not valid 
// try the following line instead 
arr[@] = 1; 
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Compiler Error VJS1344 


Error Message 
Array bound must be ordinal but was ‘type’ 


When specifying the size of the array in, for example, a call to the new operator, the type of the variable must be an ordinal. 


The following sample generates VJS1344: 


// VIS1344.js1 
public class MyClass 


{ 

public static void main() 

{ 
String s = "test"; 
int i = 10; 
int arr[] = new int[s]; // VJS1344, s is String not ordinal 
// try the following line instead 
int arr2[] = new int[i]; 

} 
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Compiler Error VJS1345 


Error Message 
Expected value of type ‘type’, found array initializer 


An attempt was made to initialize a non-array type with an array initializer. 


The following sample generates VJS1345: 


// VIS1345.jsl 
public class MyClass 
{ 
int i; 
public static void main() 
{ 
MyClass c = {1,2}; // VIS1345 
// try the following line instead 
MyClass cl = new MyClass(); 
c1.i = Q; 
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Compiler Error VJS1346 


Error Message 
Array creation must specify at least one dimension 


An array declaration was ill-formed, due to the lack of an array dimension. 


The following sample generates VJS1346: 


// VIS1346.js1 
class Test 


{ 


public static void main(String[] args) 


intl] x = new int[]; // VIS1346 
// try the following line instead 
// int[] x = new int[5]; 
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Compiler Error VJS1347 


Error Message 
All bounds of a rectangular array must be specified if any are specified 


A rectangular array declaration was ill-formed. 


The following sample generates VJS1347: 


// VIS1347.js1 
class MyClass 


{ 


public static void main() 


{ 


int[,] arr = new int[19,]; // VIS1347, a dimension is missing. 
int[,] arr2 = new int[10,10]; // OK, all dimensions are present 
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Compiler Error VJS1348 


Error Message 
Specified dimensions not allowed after unspecified ones in array creation 


The first dimension of an array was not specified and the second was specified, which is not allowed. 


The following sample generates VJS1348: 


// VIS1348.js1 
public class MyClass 


{ 


public static void main() 


int[][] arr = new int[][2]; // VIS1348 
// try the following line instead 
int[][] arr2 = new int[3][2]; 
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Compiler Error VJS1350 


Error Message 
Bad array initializer for ‘declaration’ 


An array initializer for a rectangular array was specified, but the initializer does not correspond to a rectangular array. 


The following sample generates VJS1350: 


// VIS135@.jsl 
class MyClass 


{ 

public static void main() 

{ 
int[,] arr = new int[, ]{{1,2},{3,4,5}}; // VIS1350 
// Rectangular arrays should have all rows of the same size 
// try the following line instead 
int[,] arr2 = new int[, ]{{1,2},{3,4}}; 
arr2[0,0@] = Q; 

} 
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Compiler Error VJS1351 


Error Message 
Wrong number of indices for ‘declaration’ 


When trying to access the elements of a rectangular array, the number of indices given did not match with the array 
dimensions. 


The following sample generates VJS1351: 


// VIS1351.jsl 
class MyClass 


{ 

public static void main() 

{ 
int[,] arr = new int[2,2]; // 2x2 rectangular array 
arr[@] = 1; // VIS1351, must specify two indices 
// try the following line instead 
arr[@,1] = 10; 

} 
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Compiler Error VJS1354 


Error Message 
'this' is not available in static context 


The this operator cannot be used in a static method. 


The following sample generates VJS1354: 


// VIS1354.jsl1 
class Test 


{ 
public static void Test(Test t) 


if (this == t) // VIS1354 


{ 
} 
} 
public static void main(String[] args) 
{ 
} 
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Compiler Error VJS1355 


Error Message 
'this' is not available in the constructor call in the current context 


When invoking a class constructor using this syntax, it is not valid to use the instance variables of a class. Instance variables are 
not available, as the this variable is not yet initialized. 


The following sample generates VJS1355: 


// VIS1355.jsl 

// compile with: /target:library 

public class MyClass 

{ 
int i; // an instance variable 
static final int ONE = 1; // a static variable 
public MyClass() 


this(i); = // VIS1355 
// try the following line instead 
// this(ONE); // OK. ONE is a static variable 


public MyClass(int i) 
{ 
} 
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Compiler Error VJS1356 


Error Message 
The prefix to ‘this’ must be a class name, not ‘type’ 


A call to this was ill-formed. 


The following sample generates VJS1356: 


// VIS1356.jsl 
// compile with: /target:library 
public class OuterClass 
{ 
public int i; 
public class InnerClass 


void Test() 
int.this.i = 2; // VIJS1356, prefix int is not a class name 


// try the following line instead 
// OuterClass.this.i = 20; // OK 
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Compiler Error VJS1357 


Error Message 
Class ‘class’ is not an enclosing class 


A qualified this statement attempted to access the this variable of an enclosing class; however, the prefix to the this expression 
is not an outer enclosing class. 


The following sample generates VJS1357: 
// NVIS1357.js1 
// compile with: /target:library 


public class OuterClass 


{ 
public int i; 
public class InnerClass 
void Test() 
InnerClass2.this.j = 10; // NIJS1357, not an enclosing class 


// try the following line instead 
// OuterClass.this.i = 10; 


} 


public class InnerClass2 


public int j; 


Visual J# Reference 


Compiler Error VJS1358 


Error Message 
Expected a catch or finally block. 


The compiler detected an incomplete try statement. 
To correct this error 
1. Find the try statement. 


2. Read through the statement to make sure you finish it with a catch or finally block. 


Example 
The following sample generates VJS1358. 


// VIS1358.jsl 
// compile with: /target:library 
// VJS1358 expected 
class MyClass 
void Test() 


try {} 


void Test2() 


{ 
try {} 
catch (Exception e) {} 
} 
i 
See Also 


Other Resources 
Visual J# Compiler 
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Compiler Error VJS1359 


Error Message 
Cannot catch 'class' that does not inherit from java.lang.Throwable or System.Exception 


An exception specified in a catch clause was not derived from an exception class. 


The following sample generates VJS1359: 


// VIS1359.jsl 
class MyClass 


{ 
} 
class MyClass2 
{ 
public static void main(String[] args) 
{ 
try 
{ 
catch (MyClass e) // VJS1359, MyClass is not an exception class 
// try the following line instead 
// catch (Exception e) 
{ 
} 
} 
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Compiler Error VJS1360 


Error Message 
Catch unreachable: no matching exceptions were thrown in try block 


A catch clause is not reachable because the matching exception class or its derived exception is not thrown in the try block. 


The following sample generates VJS1360: 


// VIS1360.js1 
class MyClass extends Exception 


{ 
} 
class MyClass2 
{ 
public static void main(String[] args) 
{ 
try 
{ 
// uncomment the following line to resolve: 
// throw new MyClass(); 
catch (MyClass e) // VIJS1360, Exception MyClass is not thrown in the try block 
} 
catch (Exception e) 
{ 
} 
} 
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Compiler Error VJS1361 


Error Message 
Catch unreachable: matching exceptions were caught in earlier catch clause 


The compiler detected a duplicate catch clause. 


The following sample generates VJS1361: 


// VIS1361.js1 
class MyClass 
{ 

} 


class MyClass2 
{ 


public static void main(String[] args) 


{ 
try 


{ 


catch (Exception e) 


{ 
} 


catch (Exception e) // VIS1361, duplicate catch block 
{ 
} 
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Compiler Error VJS1362 


Error Message 
Cannot throw ‘class’ that does not inherit from java.lang.Throwable or System.Exception 


A throw statement threw a class that was not an exception class. 


The following sample generates VJS1362: 


// VIS1362.js1 
class MyClass 


{ 
} 
class MyClass2 extends Exception 
{ 
} 
class MyClass3 
: public static void main(String[] args) 
{ 
try 
if 
throw new MyClass(); // V'JS1362, MyClass is not exception class 
// try the following line instead 
// throw new MyClass2(); 
} 
catch (MyClass2 e) 
{ 
} 
y 
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Compiler Error VJS1363 


Error Message 
Cannot access type ‘class’ 


The class (class) is a package-scope class and a class in another module is trying to extend the package-scope class in different 
package. A package-scoped member can be accessed in another class only if the accessing class is in the same package. 


Example 


// VIS1363a.jsl 

// compile with: /target:library 
package p; 

class Base {} 

public class Base2 {} 


class MyClass extends p.Base {} // OK 
The following sample generates VJS1363. 


// VIS1363b.js1 

// compile with: /target:library VJS1363a.jsl 
class MyClass2 extends p.Base {} // VIJS1363 
class MyClass3 extends p.Base2 {} // OK 
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Compiler Error VJS1364 


Error Message 
The prefix of field ‘field’ must be a reference, not ‘type’ 


An instance field must be accessed by means of an instance of the type. 


This error indicates that you tried to access fields on a primitive type, like int, char, or boolean. Primitive types cannot have 
any fields. Only reference types can have fields and methods. 


The following sample generates VJS1364: 


// VIS1364.js1 
class MyClass 
{ 
int i; 
public void Test() 
{ 
MyClass x = new MyClass(); 
i.i = @; // VIJS1364, i is not a reference to the class 
// try the following line instead 


// xX.i = @3 
public static void main() 
{ 
} 
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Compiler Error VJS1365 


Error Message 
Cannot find field ‘field’ in class ‘class’ 


The compiler found a reference to a field that was not declared in the class. 


Visual J# does not attach any special importance to property accessor methods. They are treated as methods of the class itself. 


Example 


// VIS1365.jsl 
// compile with: /target:library 
class Test 


{ 
int i; 
public void Test(Test t) 
{ 
this.t = @;  // VIS1365 
this.i = @; // OK 
} 
} 


The following samples generate VJS1365. 


// VIS1365b.js1 
public class MyClass 
{ 
/** @property */ 
void set_Val(int i) 


{ 
value = i; 
} 
public static void main(String [] args) 
{ 
MyClass c = new MyClass(); 
c.Val = 10; // \'IS1365 
c.set_Val(10); // OK 
} 


private int value; 
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Compiler Error VJS1366 


Error Message 
Cannot access field ‘field’ 


A field was inaccessible. 


The following sample generates VJS1366: 


// VIS1366.js1 
class MyClass 


{ 
} 


private int i; 


class MyClass2 


public static void main() 


{ 
MyClass x = new MyClass(); 


x.i = Q; // \VJS1366, i is private 


Visual J# Reference 


Compiler Error VJS1367 


Error Message 
Cannot access inherited field ‘field’ through this object 


An inherited field could not be accessed; add the derived class to the package of the base class. 


Example 


// NVIS1367a.jsl 
// compile with: /target:library 
package p; 


public class Base 


{ 
} 


protected int Ff; 


public class Derived extends Base {} 


The following sample generates VJS1367. 


// VIS1367b.js1 

// compile with: VJS1367a.jsl 

// add MyClass to package p to resolve 
class MyClass 


public static void main (String [] args) 


{ 
} 


int k = new p.Derived().f; // VIS1367 
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Compiler Error VJS1368 


Error Message 
Cannot access non-static field ‘field’ from static inner class 


You cannot access instance members of an outer class from the class scope of a static inner class. 


The following sample generates VJS1368: 


// VIS1368.js1 
// compile with: /target:library 
class MyClass 
{ 
int f = 2; 
static int f2 = 10; 
static class Inner 


{ 
int k = Ff; // VIJS1368, f is an instance variable 
int k2 = £2; // OK: #2 is a static member 
} 
class Inner2 
{ 
int k = Ff; // OK: access instance member from instance inner class 
} 
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Compiler Error VJS1369 


Error Message 
Cannot access non-static method 'method' from static inner class 


You cannot access non-static members from a static inner class. 
The following sample generates VJS1369: 
// VIS1369.js1 


// compile with: /target:library 
class MyClass 


{ 

int instanceMethod() 

{ 
return 1; 

} 

static int staticMethod() 

{ 
return 2; 

} 

static class Inner 

{ 
int k = instanceMethod(); // VIS1369 
int k2 = staticMethod (); // OK 

} 

class Inner2 

{ 
// OK: accessing an instance member from an instance inner class 
int k = instanceMethod (); 

} 
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Compiler Error VJS1371 


Error Message 
Cannot access field ‘field’ that is not fully declared here 


A field needs to be declared before it is used in a static initializer. 
The following sample generates VJS1371: 


// VIS1371.js1 
class MyClass 


a 


static 


i = 2; // VJS1371, declare i before this static initializer 


static int i; 


public static void main() 


{ 
} 
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Compiler Error VJS1372 


Error Message 
Interface field ‘field’ must contain an initializer 


An interface field was not initialized. 


The following sample generates VJS1372: 


// NIS1372.js1 
interface Point 


{ 
int i; // \IS1372 
// try the following line instead 
// int i = @; 
} 
public class MyClass 
{ 
public static void main() 
{ 
} 
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Compiler Error VJS1373 


Error Message 
Missing exponent in floating point literal 


A floating-point value was missing an exponent. 


The following sample generates VJS1373: 


// VIS1373.jsl 

class MyClass 

{ 
float f = 3.40282347e+f; // NIS1373 
// try the following line instead 
// float fF = 3.40282347e+38F; 


public static void main() 
{ 
} 
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Compiler Error VJS1374 


Error Message 
‘literal’ is not a valid value for a literal of type ‘float’ 


The compiler detected an ill-formed floating-point value. 


The following sample generates VJS1374: 


// VIS1374.js1 

class MyClass 

{ 
float f = 11111111111111111111111111111111111111e+2F ; // NIS1374 
// try the following line instead 
// float fF = 3.140e+30f; 


public static void main() 
{ 
} 
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Compiler Error VJS1377 


Error Message 
The local variable 'var' should be final to be used in inner class 


Local variables that are not marked as final in an enclosing class cannot be accessed from an inner class. 


The following sample generates VJS1377: 


// NIS1377.js1 
// compile with: /target:library 
class MyClass 


void Test() 


int k = 30; 

final int k2 = 20; 

class Inner 

{ 
int p = k; // NIS1377 
int p2 = k2; // OK 
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Compiler Error VJS1379 


Error Message 
super cannot be used in static context 


The super keyword was used incorrectly. 
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Compiler Error VJS1380 


Error Message 
break statement not allowed here 


A break statement was found in an invalid location. 


The following sample generates VJS1380: 


// VIS1380.js1 
public class MyClass 


{ 
public static void main() 
{ 
break; // \'IS1380 
} 
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Compiler Error VJS1381 


Error Message 
Invalid char literal: ‘literal’ 


The compiler detected an ill-formed character literal. 


The following sample generates VJS1381: 


// VIS1381.jsl1 
class MyClass 


{ 
public static void main() 
{ 
char c = 'a'';  // VIS1381, invalid char 
// try the following line instead 
char c = ‘a’; 
} 
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Compiler Error VJS1382 


Error Message 
Invalid newline in character literal 


New lines are not allowed in a character literal. 


The following sample generates VJS1382: 


// VIS1382.js1 

// compile with: /target:library 
class MyClass 

{ 


char s = 
F'; // \NIS1382 
// try the following line instead 
// char s = 'F'5 
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Compiler Error VJS1383 


Error Message 
Missing closing quote in char literal: literal 


The compiler detected an ill-formed character literal. 


The following sample generates VJS1383: 


// VIS1383.jsl 
class MyClass 


{ 
public static void main() 
{ 
char c = ‘a; // \'IS1383 
// try the following line instead 
// char c = ‘a'; 
} 
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Compiler Error VJS1384 


Error Message 
Missing closing quote in string literal: literal 


The compiler detected an ill-formed string literal. 


The following sample generates VJS1384: 


// VIS1384.js1 
class MyClass 
{ 


public static void main() 

{ 
String s = "test; // VIS1384 
// try the following line instead 
// String s = "test"; 
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Compiler Error VJS1385 


Error Message 
Invalid octal escape ‘value’ (must be <= 0377) 


An octal value was used, but it was outside the range for a valid octal value. 


The following sample generates VJS1385: 


// VIS1385.jsl 
// compile with: /target:library 
class MyClass 
{ 
// Error: octal char sequence should be less than o equal to 377 
char s = '\456'; // VIJS1385 
// try the following line instead 
// char c = '\375'; 
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Compiler Error VJS1386 


Error Message 
Invalid escape sequence ‘sequence’ 


The compiler detected an invalid escape sequence. For example, valid octal digits are only from 0 — 7. 


The following sample generates VJS1386: 


// VIS1386.js1 
// compile with: /target:library 
class MyClass 
{ 
char s = '\8'; // VIS1386 
char c = '\7';  // OK 
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Compiler Error VJS1387 


Error Message 
Invalid Unicode escape sequence ‘sequence’ 


The compiler detected an invalid Unicode escape sequence. The valid format is \u####. 


The following sample generates VJS1387: 


// VIS1387.js1 

// compile with: /target:library 

class MyClass 

{ 
char c = '\ug@@e'; // N'IS1387 
// try the following line instead 
char cc = '\ul10e0'; 
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Compiler Warning (level 1) VJS1393 


Error Message 
Assembly attributes can be defined only at the beginning of the file after the package and import statements 


An assembly-level attribute was found in the source code file after the type definitions. 


The following sample generates VJS1393: 


// VIS1393.jsl 

// compile with: /W:1 
public class MyClass 
{ 


public static void main() 
{ 
} 


/** @assembly System.Reflection.AssemblyTitle("") */ // V'JS1393, move to top of file 
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Compiler Warning (level 1) VJS1395 


Error Message 
This feature is not available when .NET language extensions are disabled 


The use of certain language extensions is not compatible with the /x:net compiler option, which disables the language 
extensions that support the common language runtime. For example, attributes are ignored. 


The following sample generates VJS1395: 


// VIS1395.jsl 
// compile with: /x:net /W:1 
/** @assembly System.Reflection.AssemblyTitle("") */ // VIS1395 
public class MyClass 
{ 
public static void main() 
{ 
} 
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Compiler Error VJS1396 


Error Message 
Cannot attach attribute ‘attribute’ because it is an abstract class 


An attribute based on an abstract class cannot be used. 


Example 


// VIS1396a.cs 

// compile with: /target:library 

// a C# program 
[System.AttributeUsage(System.AttributeTargets.Al11) ] 
public abstract class MyAttribute : System.Attribute 


public MyAttribute () {} 


// VIS1396b.js1 

// compile with: /reference:VJS1396a.d1l1 /target: library 

/** @attribute MyAttribute() */ // VIS1396 MyAttribute is abstract 
class MyClass {} 
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Compiler Error VJS1397 


Error Message 
Attribute ‘attribute’ doesn't inherit from 'System.Attribute’ 


An attribute was applied, but was not properly defined. 


Example 


// VIS1397a.cs 

// compile with: /target:library 

// a C# program 

// [System.AttributeUsage(System.AttributeTargets.Al1) ] 
public abstract class MyAttribute // : System.Attribute 


public MyAttribute () 


q 
J 


// NVIS1397b.js1 
// compile with: /reference:VJS1397a.d11 
/** @attribute MyAttribute() */ // VIJS1397, MyAttribute not attr. class 
// uncomment the attribute support syntax in VJS1397a.cs to resolve 
class MyClass 
{ 

public static void main (String [] args) 

{ 

} 
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Compiler Error VJS1398 


Error Message 
Attribute ‘attribute’ has a non-constant constructor parameter 


All parameters to an attribute constructor should be constants; variables cannot be passed as parameters to these constructors. 


To resolve, do not use the attribute or change the attribute constructor to be compliant with the common language 
specification (CLS). 


Example 


// VIS1398a.cs 
// compile with: /target:library 
// a C# program 
[System.AttributeUsage(System.AttributeTargets.Al11) ] 
public class MyAttribute:System.Attribute { 

public MyAttribute (MyType t) {} 
} 


public class MyType {} 


// VIS1398b.js1 

// compile with: /target:library /reference:VJS1398a.d11 
/** @attribute MyAttribute (new MyType ()) */ // VIS1398 
public class MyClass {} 
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Compiler Error VJS1399 


Error Message 
Attribute ‘attribute’ has an array constructor parameter that's not 1-dimensional 


Arrays that are two-dimensional or greater cannot be passed as attribute parameters and still be compliant with the Common 
Language Specification (CLS). 


Example 


// VIS1399a.cs 

// compile with: /target:library 

// a C# program 
[System.AttributeUsage(System.AttributeTargets.Al11) ] 
public class MyAttribute : System.Attribute 

{ 


} 


[System.AttributeUsage(System.AttributeTargets.Al11) ] 
public class MyAttribute2 : System.Attribute 


{ 
} 


public MyAttribute (int [][] a) {} 


public MyAttribute2 (int [] a) {} 


The following sample generates VJS1399. 


// VIS1399b.js1 

// compile with: /target:library /reference:VJS1399a.d11 

/** @attribute MyAttribute (new int[][]{{1,2},{1,2,3}}) */ // VIS1399 
class MyClass {} 


// OK 
/** @attribute MyAttribute2 (new int[]{8}) */ 
class MyClass2 {} 
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Compiler Error VJS1401 


Error Message 
Bad type for attribute parameter 


In Visual J#, attribute parameters must be Common Language Specification (CLS)-compliant types. 


The following table lists CLS types and their corresponding Java-language types. 























CLS type Java-language type 
System.Byte(byte) ubyte 
System.Char(char) char 
System.Boolean(bool) boolean 
System.Int16(short) short 
System.Int32(int) int 
System.Int64(long) long 
System.Single(float) float 
System.Double(double) double 
Example 

// VIS14@1a.cs 

// compile with: /target:library 

// a C# program 

[System.AttributeUsage(System.AttributeTargets.Al11) ] 

public class MyAttribute:System.Attribute { 

public MyAttribute (sbyte t) {} 
} 











The following sample generates VJS1401. 


To resolve do not use attribute or change attribute constructor to take a CLS compliant type. 





// VIS1401b.js1 

// compile with: /target:library /reference:VJS14@1a.d11 
/** @attribute MyAttribute ((byte)10) */ // VIS14@1 
class MyClass {} 
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Compiler Error VJS1402 


Error Message 
The named field or property parameter ‘param’ not found in type ‘type’ 


A named parameter does not exist. 


Example 


// VIS14@2a.cs 

// compile with: /target:library 

// a C# program 
[System.AttributeUsage(System.AttributeTargets.Al11) ] 
public class MyAttribute : System.Attribute 


public MyAttribute () {} 
public int Version = 20; 


The following sample generates VJS1402. 


// VIS1402b.js1 

// compile with: /target:library /reference:VIJS14@2a.d11 

/** @attribute MyAttribute (NonExistingField = 10) */ // VIS14@2 
// try the following line instead 

// /** @attribute MyAttribute (Version = 10) */ 

class MyClass {} 
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Compiler Error VJS1403 


Error Message 
The named field or property parameter ‘param’ is not assignable 


A named parameter is read-only; it cannot be initialized. 


Example 


// VIS14@3a.cs 

// compile with: /target:library 

// a C# program 
[System.AttributeUsage(System.AttributeTargets.Al11) ] 
public class MyAttribute : System.Attribute 


public MyAttribute () {} 
public readonly int Version = 20; 


// VIS1403b.js1 

// compile with: /target:library /reference:VIJS1403a.d11 
/** @attribute MyAttribute (Version = 10) */ // VIS14@3 
// try the following line instead 

// /** @attribute MyAttribute () */ 

class MyClass {} 
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Compiler Error VJS1404 


Error Message 
Cannot assign a value of type 'type1' to attribute field or property of type 'type2' 


A field was assigned a value of the wrong type. 


Example 


// VIS1404a.cs 

// compile with: /target:library 

// a C# program 
[System.AttributeUsage(System.AttributeTargets.Al11) ] 
public class MyAttribute : System.Attribute 


public MyAttribute () {} 
public int Version = 20; 


// VIS1404b.js1 

// compile with: /target:library /reference:VJS1404a.d11 

/** @attribute MyAttribute (Version = "string") */ // VIS1404 
// try the following line instead 

// /** @attribute MyAttribute (Version = 10) */ 

class MyClass {} 
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Compiler Error VJS1405 


Error Message 
The named field or property parameter ‘param’ is static 


Named field parameters cannot be static. 


Example 


// VIS14@5a.cs 

// compile with: /target:library 

// a C# program 
[System.AttributeUsage(System.AttributeTargets.Al11) ] 
public class MyAttribute : System.Attribute 


public MyAttribute() {} 
public static int Version = 20; 
public int Version2 = 20; 


The following sample generates VJS1405. 


// VIS1405b.js1 

// compile with: /target:library /reference:VIJS14@5a.d11 
/** @attribute MyAttribute (Version = 10) */ // VIS14@5 
// try the following line instead 

// /** @attribute MyAttribute (Version2 = 10) */ 

class MyClass {} 
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Compiler Error VJS1406 


Error Message 
The named field or property parameter ‘param’ is not public 


It is invalid to access a private, named parameter. 


The following sample generates VJS1406: 


Example 


// VIS14@6a.cs 

// compile with: /target:library 

// a C# program 
[System.AttributeUsage(System.AttributeTargets.Al11) ] 
public class MyAttribute : System.Attribute 


{ 


private int Version 
public int Version2 


1; 
1; 


public MyAttribute() 
{ 


} 


int i = Version; 


// VIS14@6b.js1 
// compile with: /target:library /reference:VIJS1406a.d11 
/** @attribute MyAttribute (Version = 10) */ // VIS1406 
class MyClass {} 


/** @attribute MyAttribute (Version2 = 10) */ // OK 
class MyClass2 {} 
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Compiler Error VJS1407 


Error Message 
System AttributeUsageAttribute can only be attached to a class that descends from System. Attribute 


System.AttributeUsageAttribute is a special attribute attached to every System attribute or user-defined attribute. The type 
to which this attribute is applied should extend from System.Attribute. 


In Visual J#, this attribute cannot be attached to any type because there is no support to author attributes. 


The following sample generates VJS1407: 


// VIS1407.js1 

// compile with: /target:library 

// N'JS1407 expected 

/** @attribute System.AttributeUsage(System.AttributeTargets.All) */ 
class MyClass 

{ 

} 
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Compiler Error VJS1408 


Error Message 
Attribute ‘type’ must be explicitly marked with System AttributeUsageAttribute 


This error occurs if you consume an attribute that was not declared with the System AttributeUsageAttribute. This special 
attribute is required on all Visual J# attribute classes. 


The following sample generates VJS1408: 


// VIS1408.js1 


// Remove the first '//' comment symbols on the next line to avoid this error: 
// /** @attribute System.AttributeUsage(System.AttributeTargets.All) */ 
public class MyAttribute extends System.Attribute 
{ 

public MyAttribute() 

ae 


/** @attribute MyAttribute() */ // VIJS148 
public class MyAttributeClass 
{ 
public static void main(String [] args) 
{ 
} 
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Compiler Error VJS1409 


Error Message 
Attribute ‘type’ is not allowed multiple times on the same declaration 


An attribute was attached multiple times. 


Example 


// VIS1409a.cs 

// compile with: /target:library 

// a C# program 
[System.AttributeUsage(System.AttributeTargets.Al11) ] 
public class MyAttr : System.Attribute {} 


[System.AttributeUsage(System.AttributeTargets.All, AllowMultiple = true )] 
public class MyAttr2 : System.Attribute {} 


The following sample generates VJS1409. 


// VIS1409b.js1 

// compile with: /target:library /reference:VIJS1409a.d11 
/** @attribute MyAttr() */ 

/** @attribute MyAttr() */ // VIS14e9 

class MyClass {} 


// OK 

/** @attribute MyAttr2() */ 
/** @attribute MyAttr2() */ 
class MyClass2 {} 
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Compiler Error VJS1410 


Error Message 
Attribute ‘type’ is not valid on this declaration 


An attribute was applied to a construct for which the attribute was not designed. 


The following sample generates VJS1410: 


//VIS1410.jsl 

// compile with: /target:library 

/** @assembly System.Obsolete ("obsolete") */ // VIJS1410 
class MyClass {} 
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Compiler Error VJS1413 


Error Message 
Attribute 'type1' extends ‘type2' which is not public 


This error occurs if a class that defines an attribute extends a class that is not public. All classes in the inheritance hierarchy 
must be public when defining attributes. 


The following sample generates VJS1413: 
// VIS1413.js1 
import System.*; 
class BaseAttribute extends System.Attribute 


public BaseAttribute() {} 
} 


/**@attribute AttributeUsageAttribute(AttributeTargets.All,Inherited = true) */ 
public class DerivedAttribute extends BaseAttribute // VJS1413 


{ 
public DerivedAttribute (String s) 


{} 
} 


class CMain 


public static void main(String [] args) {} 
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Compiler Error VJS1418 


Error Message 
@conditional directive is valid only on void-returning methods. 


The @conditional directive cannot be used on non-void methods. 


The following sample generates VJS1418: 


// VIS1418.js1 
// compile with: /target:library 
class MyClass 


/** @conditional(DEBUG) */ // VIJS1418 
public int Test1() 


{ 


} 
// try the following instead 


/** @conditional (DEBUG) */ 
public void Test2() 

{ 

} 


return Q; 
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Compiler Error VJS1420 


Error Message 
Delegate creation must have 1 or 2 arguments 


A delegate constructor takes only 1 or 2 parameters. Valid constructors for delegates are: 
e MyDelegate ( method ) 
e MyDelegate ( Object,String ) 


The following sample generates VJS1420: 


// VIS1420.js1 
// compile with: /target:library 
class MyClass 
{ 

delegate void MyDel(); 

public void Test() 

{ 

MyDel d = new MyDel(new MyClass (), "DelMethod", null); // VIS1420 


// OK. param is a method 
MyDel d1 = new MyDel(DelMethod) ; 


// OK. passing object and the method name 
MyDel d2 = new MyDel(new MyClass (), "DelMethod"); 


} 
public void DelMethod() 


{ 
} 
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Compiler Error VJS1421 


Error Message 
Delegate creation cannot include a body 


The Visual J# compiler does not support creation of delegates. 


The following sample generates VJS1421: 


// VIS1421.js1 

class MyDelegate extends System.Delegate // VIS1421 
{ 

} 
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Compiler Error VJS1422 


Error Message 
The second argument in the creation of delegate ‘delegate’ must be a string 


The second argument to the creation of a delegate must be a string. 


The following sample generates VJS1422: 


// delegate creation second arg must be a string 
// VIS1422.js1 
// compile with: /target:library 
class MyClass 
{ 
delegate void MyDel(); 
public void Test() 


MyDel d = new MyDel(new MyClass (), new Object()); 


// OK, passing object and the method string 
MyDel d2 = new MyDel (new MyClass (), "DelMethod"); 
} 


public void DelMethod() 


{ 
i 


// NIS1422 
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Compiler Error VJS1423 


Error Message 
The argument in the creation of delegate ‘delegate’ must name a method 


A method is expected when creating a delegate. 


The following sample generates VJS1423: 


// NIS1423.js1 
// compile with: /target:library 
class MyClass 
{ 
delegate void MyDelegate(); 
public void Test() 
{ 
MyDelegate d = new MyDelegate (new MyClass ()); // VIS1423 
MyDelegate d1 = new MyDelegate (new MyClass ().DelMethod); // OK 


public void DelMethod() 


{ 
} 
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Compiler Error VJS1424 


Error Message 
The return type of 'method' must be 'type' 


The return type of a delegate did not match the return type of a method being associated with the delegate. 


The following sample generates VJS1424: 


// VIS1424.js1 
// compile with: /target:library 
class MyClass 


{ 
delegate void MyDelegate(); 


public void Test1() 


{ 
MyDelegate d = new MyDelegate (new MyClass ().Test2); // VIS1424 


// try the following line instead 
MyDelegate d1 = new MyDelegate (new MyClass ().Test3); 


public int Test2() 
{ 


return @Q; 


} 
public void Test3() 


t 
} 
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Compiler Error VJS1425 


Error Message 
Signature of method 'method' doesn't match with the signature of ‘delegate’ Delegate 


The signature of a delegate did not match the signature of the method being associated with the delegate. 


The following sample generates VJS1425: 


// \VIS1425.js1 
// compile with: /target:library 
class MyClass 
{ 
delegate void MyDelegate(int i); 
public void Test1() 
{ 
MyDelegate d = new MyDelegate(new MyClass ().Test2);  // VIS1425 
// try the following line instead 
MyDelegate d1 = new MyDelegate(new MyClass ().Test3); 
} 


void Test2(long 1) 
{ 


void Test3(int i) 
{ 
} 
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Compiler Error VJS1426 


Error Message 
Static method 'method' cannot be used for initializing Delegate 


You cannot pass static methods to create a delegate. Only instance methods are allowed. 


The following sample generates VJS1426: 


// VIS1426.js1 
// compile with: /target:library 
class MyClass 


{ 
delegate void MyDelegate(); 


public void Test1() 


{ 
MyDelegate d = new MyDelegate(Test2); // VIS1426 


// try the following line instead 
MyDelegate d1 = new MyDelegate(Test3); 


} 


static void Test2() 
{ 


void Test3() 


} 
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Compiler Error VJS1427 


Error Message 
The argument in the .NET delegate ‘delegate’ creation must be a string literal 


In creating NET Framework delegates, the second argument must be a string literal. 


Example 


// VIS1427a.cs 

// compile with: /target:library 
// a C# program 

public delegate void MyDelegate(); 


The following sample generates VJS1427. 


// NIS1427b.js1 
// compile with: /target:library /reference:VIJS1427a.d11l 
class MyClass 
{ 
public void Test1() 
{ 
String s = "m1"; 
MyDelegate d = new MyDelegate(new MyClass (), s)3; // NIS1427 
MyDelegate d1 = new MyDelegate(new MyClass (), "Test2"); // OK 


void Test2() {} 
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Compiler Error VJS1428 


Error Message 
Method 'method' throws ‘exception’ not in throws clause of delegate 


A method assigned to a delegate cannot throw an exception if the delegate declaration does not specify the exception. 


The following sample generates VJS1428: 


// or declare the delegate to throw 
// VIS1428.js1 
// compile with: /target:library 
class MyClass 
{ 
delegate void MyDelegate(); 
public void Test1() 


MyDelegate d = new MyDelegate(new MyClass ().Test2); // VIS1428 
// try the following line instead 
MyDelegate d1 = new MyDelegate(Test3); 


} 


void Test2() throws Exception 


void Test3() 


{ 
} 
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Compiler Error VJS1432 


Error Message 
‘type’ must be explicitly declared as final 


When defining a value type class in Visual J#, the final keyword is required since value types cannot be derived from. For more 
information see, User-Defined Value Types. 


The following sample generates VJS1432: 


// VIS1432.js1 
import System.*; 


// Try this instead: 
// public final class MyValueType extends System.ValueType 
public class MyValueType extends System.ValueType // VIJS1432 


i 
} 


public class CMain 


{ 
: 


public static void main() {} 
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Compiler Warning (level 1) VJS1434 


Error Message 
Ignoring '@attribute' — extensions are disabled 


Keywords such as @dll.import, @attribute, @com, and delegate are extensions to the standard Java language. Compiling 
with /xall disables all extensions. The extension is ignored. 


The following sample generates VJS1434: 


// VIS1434.js1 

// compile with: /target:library /x:all /W:1 
/** @dll.import("user32") */ // VIS1434 
class MyClass 

{ 

} 
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Compiler Error VJS1435 


Error Message 
Delegate cannot be declared inside ‘class’ inner class 


A delegate cannot be declared as an inner class member. 


The following sample generates VJS1435: 


// VIS1435.js1 
// compile with: /target:library 


class MyClass 


{ 
class InnerClass 
delegate void del(); // VIS1435 
} 
delegate void MyDelegate1(); // OK, declare as an outer class member 
} 


delegate void MyDelegate2 (); // OK, declare delegate as separate member 
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Compiler Error VJS1436 


Error Message 
Method call on null literal not allowed 


A method call on the null expression will always fail at run time. 


The following sample generates VJS1436: 


// VIS1436.js1 
class MyClass 


{ 
public static void main (String [] args) 
{ 
null.toString(); // VIS1436, method call on null literal 
} 
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Compiler Error VJS1437 


Error Message 
Method call not allowed here 


Constant strings can only be passed as parameters. 


The following sample generates VJS1437: 


// NIS1437.js1 

// compile with: /target:library 

/** @assembly System.Reflection.AssemblyTitle("abc".ToString()) */ // VIJS1437 
// try the following line instead 

// /** @assembly System.Reflection.AssemblyTitle("abc") */ 

class MyClass 

{ 

} 
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Compiler Error VJS1438 


Error Message 
Cannot access non-static member 'name' in a static context 


Instance members cannot be accessed in a static constructor or static member function in that class. 


The following sample generates VJS1438: 


// VIS1438.jsl 
// compile with: /target:library 
// NVIS1438 
class MyClass 
{ 
int name = @; 
public static int function() 


int i = Q; 
i = name; //error attemting to reference instance member "name" 
return i; 


To fix this error you either have to make the variable name a static variable, or else make function non-static. 
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Compiler Error VJS1439 


Error Message 
The array initializer is incorrectly structured 


Mixed arrays are not being initialized correctly. Individual array elements need to be initialized separately. The manner in which 
array initializations of mixed arrays are being done is incorrect. Individual array elements need to be initialized separately. 


The following sample generates VJS1439: 


// VIS1439.js1 
// compile with: /target:library 
class Myclass 


void f() 


int [,][] arr = new int [10,10][10]; // VIS1439 


Use the following correct code instead: 


// VIS1439a.jsl 
// compile with: /target:library 
class Myclass 


void f() 
{ 
// Remove the last dimension and explicitly initialize 
// the rectangular array. 
int [,][] arr = new int [10,10][]; 
for (int i = 0; i < 100; i++) 
for (int j = 03; j < 100; j+t) 
arr[i,j] = new int[10]; 
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Compiler Error VJS1440 


Error Message 
member: type cannot contain a protected member 


The modifiers protected is not allowed in the declaration of members of value types, since value types cannot be derived 
from, therefore protected is meaningless. 


The following sample generates VJS1440: 
// VIS1440.js1 


// compile with: /target:library 
import System.*; 


public final class MyValueType extends System.ValueType 
{ 


public int i; 
private int j; 


protected int k; // VvIS144e 


public MyValueType(int _i, int _j, int _k) 


{ 
i= i; 
j = _J3 
k = _k; 
} 
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Compiler Error VJS1441 


Error Message 
‘type’ cannot contain explicit parameterless constructors. 


This error occurs if a value-type class is defined (e.g. a class that inherits from System.ValueType) with a constructor that 
takes no arguments. Value types are types that must be fully defined when they are constructed; they cannot have constructors 
with no arguments. For more information on defining value types in Visual J#, see User-Defined Value Types. 


The following sample generates VJS1441: 


// VIS1441.js1 
import System.*; 


public final class MyValueType extends System.ValueType 


1 
int m_i; 
public MyValueType() // VIS1441 
{ 
} 
// Try this instead: 
// public MyValueType(int i) 
‘1-4 
// mi = i; 
// 33 
} 


class CMain 


{ 


public static void main() {} 
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Compiler Error VJS1442 


Error Message 
Cannot have an explicit ‘super’ call in the constructor of a class of ValueType 


An explicit call to super is not allowed in a constructor of class extending System.ValueType. This construct is not meaningful 
for a value type. 


The following sample generates VJS1442: 


// VIS1442.js1 
// compile with: /target:library 
import System.*; 


public final class MyValueType extends System.ValueType 
{ 


public MyValueType(int z) 


super(); // VIS1442 
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Compiler Error VJS1443 


Error Message 
Cannot have a instance initializer block inside ValueType type 


Instance initializer blocks are not allowed on value types. An instance initializer block is a block of code in a class that is not part 
of a function body, and runs before the constructor executes when instances of a class are created. 


The following sample generates VJS1443: 


// VIS1443.js1 
import System.*; 


public final class MyValueType extends System.ValueType 
{ 
public int integer; 
public int[] ia; 
// instance initializer: 
{ // NIS1443 
int[100]; 
= @; k < 100; k++) 
k: 


Bd 


public MyValueType(int i) 
{ 


} 


integer = i; 


} 


class CMain 


{ 


public static void main() 


{ 
MyValueType mvt = new MyValueType(); 


} 
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Compiler Error VJS1444 


Error Message 
Cannot implement interfaces on an enumeration type. 


Enums are not ordinary classes are not allowed to implement interfaces. 
To correct this error 


e Remove the implements keyword and any interface names. 


Example 
The following sample generates VJS1444. 


// VIS1444.js1 

// Compile with: /target:libary 
// NJS1444 expected 

import System.*; 


enum MyEnum implements MyInterface 


{ 
} 


public interface MyInterface 


{ 
} 


See Also 

Reference 

User-Defined Enumeration Types (J#) 
Other Resources 

Visual J# Compiler 
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Compiler Error VJS1445 


Error Message 
Cannot declare methods on the enumeration type. 


Enums are not ordinary classes; for example, they cannot have methods. 
To correct this error 


e Remove any methods defined in Enum classes. 


Example 
The following sample generates VJS1445. 


// VIS1445.js1 
import System.*; 


enum MyEnum 


Red(10); 
public void method ( ) // VIS1445 
1 
} 
I 
See Also 
Reference 


User-Defined Enumeration Types (J#) 
Other Resources 
Visual J# Compiler 
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Compiler Error VJS1446 


Error Message 
‘type’ cannot contain a finalizer 


An Enum is a value type, meaning that it is always destroyed when the stack frame it is declared on is destroyed. Finalize is 
only valid for objects on the heap, and is therefore not applicable or allowed in an Enum. 


The following sample generates VJS1446: 


// VIS1446 
import System.*; 


public final class MyValueType extends System.ValueType 
{ 


} 


public void Finalize() { } // VIS1446 


class CMain 


{ 
} 


public static void main() { } 
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Compiler Error VJS1448 


Error Message 
ValueType cannot have 'modifier' modifier 


Remove the abstract keyword. Value types cannot be abstract. 


The following sample generates VJS1448: 


// VIS1448.js1 
import System.*; 


public abstract class MyValueType extends System.ValueType // VJS1448 
{ 


} 
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Compiler Error VJS1449 


Error Message 
‘field declaration’ : cannot have instance field initializers in ‘type’ 


Instance fields may not be initialized in a value type. The default value of a value type is determined by setting all members to 
their default values. Any other default is not allowed. 


The following sample generates VJS1449: 


// VIS1449.js1 
import System.*; 


public final class MyValueType extends System.ValueType 


{ 
public long ONE = 1; // VIS1449 
} 
public class CMain 
{ 
public static void main() 
{ 
} 
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Compiler Warning (level 2) VJS1450 


Error Message 
Identifier ‘identifier’ is not CLS-compliant 


Identifiers in CLS-compliant classes cannot begin with the underscore character. 


The following sample generates VJS1450: 


// \VIS1450@.js1 
// compile with: /target:library /W:2 
/** @assembly System.CLSCompliant(true) */ 


// Because the assembly level CLSCompliant attribute 
// is true, this type will be checked for compliance 
public class MyClass 


public int _value; // \VIS1450 
public int value; // OK 


See Also 

Reference 

Common Language Specification Compliance Checking 
Concepts 

Common Language Specification 


Visual J# Reference: Errors and Warnings 


Compiler Warning (level 2) VJS1451 


Error Message 
Identifiers 'identifier_1' and ‘identifier_1' differing only in case are not CLS-compliant 


This error occurs if CLS compliance is enabled and two or more identifiers in a single scope differ only by the capitalization. 
This is allowed in Visual J#, but it is not CLS compliant. To resolve the error, rename the variables or disable CLS compliance 
for the relevant type. 


The following sample generates VJS1451: 


// VIS1451.jsl 
// compile with: /target:library /W:2 
/** @assembly System.CLSCompliant(true) */ 
public class MyClass 
{ 
public int value; // VIJS1451 
public int VALUE; 


See Also 

Reference 

Common Language Specification Compliance Checking 
Concepts 

Common Language Specification 
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Compiler Warning (level 2) VJS1452 


Error Message 
Class 'class' already contains a definition for identifier ‘identifier’ 


All names introduced in a CLS-compliant scope must be distinct independent of kind, except where the names are identical and 
resolved through overloading. 


Example 
Because the assembly level CLSCompliant attribute is ‘true’, this type will be checked for compliance. The following sample 
generates VJS1452. 


// VIS1452.jsl 
// compile with: /target:library /W:2 
/** @assembly System.CLSCompliant(true) */ 


public class MyClass 


{ 

public int val; // VIS1452 

public void val(int i) {} 
| } 
See Also 
Reference 
Common Language Specification Compliance Checking 
Concepts 


Common Language Specification 
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Compiler Error CLS VJS1457 


Error Message 
Super class or interface ‘type’ is not CLS compliant 


A type from which a Java-language type derived was not common language specification (CLS) compliant. 


Example a 


// VIS1457a.cs 
// compile with: /unsafe /target:library 
public abstract class Unsafe 


i 
} 


public abstract unsafe void UnsafeMethod(byte * src); 








// vjs1457b.jsl 
// compile with: /reference:vjs1475a.d11 
public class MyClass extends Unsafe {} // VJS1457 











See Also 

Reference 

Common Language Specification Compliance Checking 
Concepts 

Common Language Specification 
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Compiler Error CLS VJS1459 


Error Message 
Type of field ‘field’ is not CLS-compliant 


The type of public fields in a CLS-compliant type must be CLS compliant. The NET Framework includes alternative types that 
are CLS compliant that can be used instead, for example, System.Byte. For a list of CLS compliant alternatives to non-CLS 
compliant types, see What is the Common Language Specification? 


The following sample generates VJS1459: 


// VIS1459.jsl1 

// compile with: /target:library /W:2 

/** @assembly System.CLSCompliant(true) */ 
public class MyClass 


i 
} 


public byte value; // \IS1459 


See Also 
Reference 


Common Language Specification Compliance Checking 
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Compiler Warning (level 2) VJS1460 


Error Message 
Return type of method 'method' is not CLS-compliant 


The return type of methods in a CLS-compliant type must be CLS compliant. The .NET Framework includes alternative types 
that are CLS compliant that can be used instead, for example, System.Byte. For a list of CLS-compliant alternatives to non-CLS 
compliant types, see What is the Common Language Specification? 


The following sample generates VJS1460: 


// VIS146@.js1 

// compile with: /W:2 /target:library 

/** @assembly System.CLSCompliant(true) */ 
public class MyClass 


i 
} 


public byte method() { return (byte) 1; } // VIS146e 


See Also 
Reference 
Common Language Specification Compliance Checking 
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Compiler Warning (level 2) VJS1461 


Error Message 
Parameter type of method ‘method! is not CLS compliant 


The parameter type is not allowed in a CLS-compliant type. The .NET Framework includes alternative types that are CLS 
compliant that can be used instead, for example, System.Byte. For a list of CLS-compliant alternatives to non-CLS compliant 
types, see What is the Common Language Specification? 


The following sample generates VJS1461: 


// VIS1461.js1 
// compile with: /W:2 
/** @assembly System.CLSCompliant(true) */ 


// Because the assembly level CLSCompliant attribute 
// is true, this type will be checked for compliance 
public class MyClass 


: public void method(byte sb) {} // VIS1461 
public static void main(String [] args) {} 
} 
See Also 
Reference 
Common Language Specification Compliance Checking 
Concepts 


Common Language Specification 


Visual J# Reference 


Compiler Warning (level 2) VJS1463 


Error Message 
Interface interface defining static methods or fields is not CLS-compliant 


Interfaces cannot contain fields in a CLS-compliant type. 


Example 
Because the assembly level CLSCompliant attribute is true, this type will be checked for compliance. The following sample 
generates VJS1463. 


// VIS1463.js1 

// compile with: /target:library /W:2 

/** @assembly System.CLSCompliant(true) */ 
interface IA 


{ 
: 


int i=; // VIS1463 


See Also 

Reference 

Common Language Specification Compliance Checking 
Concepts 

Common Language Specification 
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Compiler Error CLS VJS1465 


Error Message 
type is more accessible than its signature 


This error indicates that the indicated type has a lower level of access than its parent. This error can appear if you indicated that 
your code should be CLS compliant by setting System.CLSCompliant to true. 


To correct this error 


e Make sure the signature of type has the correct level of access, according to its parent class. 


Example 
The following sample generates CLS VJS1465: 


import System.*; 
/** @assembly System.CLSCompliant(true) */ 
class B 


/** @attribute System.CLSCompliant(true) */ 
public class BInner 


{ 


} 
} 


See Also 

Reference 

Common Language Specification Compliance Checking 
Other Resources 

Visual J# Compiler 
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Compiler Error VJS1467 


Error Message 
System.TypedReference is a valid type for only local variables and parameters 


TypedReference was used in an invalid location. 


The following sample generates VJS1467: 


// VIS1467.js1 
class MyClass 


{ 
System. TypedReference typeRef; // NIS1467 
public static void main (String [] args) 


{ 
System. TypedReference localRef; // OK on local var 


public void m (System.TypedReference paramRef) // OK on param 
{ 
} 
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Compiler Error VJS1468 


Error Message 
Invalid assembly or file version ‘version’ specified in the assembly attribute 


The format of the version number for an assembly is major.minor.build.revision, and all of these numbers should be greater 
than 0. 


The following sample generates VJS1468: 


// VIS1468.js1 

// compile with: /target:library 

import System.Reflection.*; 

/** @assembly AssemblyVersion ("1.-1.1.1") */ // VIS1468 
class MyClass 

{ 

} 
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Compiler Error VJS1469 


Error Message 
Assembly is not delay signed 


VJS1469 can occur if there are problems with the key file or the key container specified. To fully sign an assembly, you must 
provide a valid key file that contains information about the public and private keys. To delay sign an assembly, you must select 
the Delay sign only check box and provide a valid key file that contains information about the public key information. The 
private key is not necessary when an assembly is delay-signed. For more information, see 

How to: Sign an Assembly (Visual Studio). 


Use sn -p to create a keyfile with only a public key. 
For information on delay signing, see /delaysign (Delay the Cryptographic Key Signing). 
The following sample generates VJS1469: 

// VIS1469.js1 

import System.Reflection.*; 

import System.Runtime.CompilerServices.*; 

/** @assembly AssemblyDelaySign(false) */ 


// Assume VJS1469.key only has public key 
/** @assembly AssemblyKeyFile("VJS1469.key") */ // VIJS1469 


class MyClass 
{ 


} 


public static void main (String [] args) {} 
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Compiler Error VJS1470 


Error Message 


Invalid key file ‘file’ 


The file name passed to the AssemblyKeyFileAttribute attribute was not found on disk, did not contain a valid key pair, or 
did not contain a valid public key. For more information on signing page, see Signing Page, Project Designer. 


The following sample generates VJS1470: 


// VIS1470.js1 
import System.Reflection.*; 
import System.Runtime.CompilerServices.*; 


/** @assembly AssemblyKeyFile("file") */ // VIJS1470 
class MyClass 


: 


public static void main (String [] args) 


1 
} 


See Also 

Tasks 

How to: Create a Public/Private Key Pair 
Reference 

Signing Page, Project Designer 
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Compiler Error VJS1471 


Error Message 
Invalid key name ‘container’ 


The key name passed to the AssemblyKeyNameAttribute attribute was not valid. 


The following sample generates VJS1471: 


// VIS1471.js1 
import System.Reflection.*; 
import System.Runtime.CompilerServices.*; 


/** @assembly AssemblyKeyName("container") */ // VIS1471 
class MyClass 
{ 

public static void main (String [] args) 

{ 

} 


Visual J# Reference 


Compiler Error VJS1472 


Error Message 
‘type1' is not valid in field or method declarations, use 'type2' instead 


Type type7 cannot be used as a field or method declaration. To resolve this, use type2 instead. 
The following sample generates VJS1472: 

// VIS1472.js1 

// compile with /target:library 


// N'JS1472 expected 
public class MyClass 


void f(System.Int32 int32) {} 
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Compiler Error VJS1473 


Error Message 
‘member’: CLS-compliant interfaces must have CLS-compliant members 


An interface member cannot be non-CLS-compliant. The CLS specifies that all interface members shall be implemented. 


The following sample generates VJS1473: 


// NIS1473.js1 
// compile with: /target:library /W:2 
/** @assembly System.CLSCompliant(true) */ 


public interface IA 


/** @attribute.method System.CLSCompliant(false) */ 
public void m1(); // VIS1473 
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Compiler Warning (level 2) VJS1474 


Error Message 
‘member’: only CLS-compliant members can be abstract 


A class member cannot be abstract and non-CLS compliant. The CLS specifies that all class members shall be implemented. 


The following sample generates VJS1474: 


// NIS1474.js1 

// compile with: /target:library /W:2 

/** @assembly System.CLSCompliant(true) */ 
public abstract class MyClass 


/** @attribute.method System.CLSCompliant(false) */ 
public abstract void method2(); // NIS1474 
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Compiler Warning (level 2) VJS1475 


Error Message 
CLS compliance checking will not be performed on 'member' because it is private 


CLS rules apply only to types or members that are visible outside the assembly in which they are defined. 


The following sample generates VJS1475: 


// NIS1475.jsl 

// compile with: /target:library /W:2 

/** @assembly System.CLSCompliant(true) */ 
public class MyClass 


{ 


/** @attribute System.CLSCompliant(true) */ 
private int i; // NIS1475 
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Compiler Error CLS VJS1477 


Error Message 
Property property is not CLS-compliant. 


This error occurs when a bean property is used in source that is being checked for CLS compliance. To fix the error, do not use 
bean properties in code that is intended to be CLS-compliant. 


The following sample generates CLS VJS1477: 


Example 
The following sample generates VJS1477: 


/**@assembly System.CLSCompliantAttribute(true) */ 


public class AssemblyCompliant 


{ 
protected int fprop = 23; 


/**@beanproperty*/ public void setprop(int val) 


fprop = val; 
} 


/**@beanproperty*/ public int getprop() 
uf 


return fprop ; 


} 
} 


See Also 

Concepts 

Writing CLS-Compliant Code 
Other Resources 

Visual J# Compiler 
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Compiler Error VJS1478 


Error Message 
type has no accessible constructors that use only CLS-compliant types 


This error occurs when a custom attribute has an array parameter. 


To correct this error 


e To avoid this error, use another parameter type in the constructor. 


Example 
The following sample generates VJS1478. 


// NIS1478.js1 
// compile with: /target:library 
// \'JS1478 expected 
/**@assembly System.CLSCompliantAttribute(true) */ 
class MyAttrib extends System.Attribute 
{ 
public MyAttrib(int[] arg) {} // VIS1478 
// try the following line instead 
// public MyAttrib() {} 


See Also 
Other Resources 


Visual J# Compiler 
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Compiler Warning (level 3) VJS1482 


Error Message 
Final field field can be declared static 


This warning is letting you know that efficiency can be gained by declaring your final field static so that it doesn't take up space 
in each instance of the object. 


To correct this error 


e To avoid this warning, add the static keyword to the declaration of the field. 


Example 
Uncomment the following code to generate VJS1482. //public final int i = 10; 


// vjs1482.js1 
// compile with: /W:3 
public class C 


{ 
public final int i = 10; 
//public static final int i = 10; // more efficient 


public static void main() 


{ 
} 
} 
See Also 


Other Resources 
Visual J# Compiler 
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Compiler Warning (level 3) VJS1483 


Error Message 
Empty try statement. 


This warning informs you that you have an empty try statement in your code. 
To correct this error 


e To avoid this warning, make sure your code contains no empty try statements 


Example 
The following sample generates VJS1483: 


public class Test 


{ 

public static void main() 

{ 
try { } 
catch (Exception ex) { } 
try { System.out.println("Hi"); } 
finally { } 

} 

See Also 


Other Resources 
Visual J# Compiler 
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Compiler Warning (level 3) VJS1484 


Error Message 
Empty finally statement. 


This warning informs you that you have an empty finally statement in your code. 
To correct this error 


e To avoid this warning, make sure your code contains no empty finally statements. 


Example 
The following sample generates VJS1484: 


public class Test { 
public static void main() { 


try { } catch (Exception ex){} 
try { System.out.println("Hi");} finally {} 


See Also 
Other Resources 


Visual J# Compiler 
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Compiler Warning (level 3) VJS1485 


Error Message 
The catch clause for System.Exception catches all exceptions. A separate clause for Throwable is not required. 


Your code includes an explicit Throwable clause and a System.Exception catch clause. 


To correct this error 


e Instead of catching Throwable for all exceptions as you would in the Java language, catch System.Exception, from 
which Throwable is derived. 


Example 
The following sample generates VJS1485 


public class CatchSysExAfterCatchTh 


{ 
public static void main(String[] args) 
{ 
try 
throw new System.SystemException(); 
catch (Throwable t) 
{ 
catch (System.Exception nfe) 
} 
} 
} 
See Also 
Reference 


Visual J# Exception Hierarchies 
Other Resources 
Visual J# Compiler 
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Compiler Warning (level 3) VJS1486 


Error Message 
The catch clause for Throwable must appear after this clause. 


The code includes a catch clause without a required following Throwable. 
To correct this error 


1. Check your code for a catch statement that does not have a corresponding catch cause for Throwable following it. 


2. Add the appropriate catch clause. 


Example 
The following sample generates VJS1486. 


public class CatchUnmapdExAfterCatchTh 


public static void main(String[] args) 


{ 
try 


{ 


throw new System.SystemException(); 


catch (Throwable t) 
i 


catch (System.SystemException nfe) 


we eH 


See Also 
Other Resources 


Visual J# Compiler 
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Compiler Warning (level 3) VJS1493 


Error Message 
Variable ‘var’ is not used 


A variable was declared but not initialized or used. 
The following sample generates VJS1493: 
// VIS1493.jsl1 


// compile with: /W:3 
public class MyClass 


{ 
public static void main() 
{ 
int i; // VIS1493, i is not initialized or used 
} 
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Compiler Warning (level 1) VJS1499 


Error Message 
‘private protected’ not supported, using ‘protected! 


The access specifier private protected is not supported; use protected instead. 


The following sample generates VJS1499: 


// VIS1499.jsl1 
// compile with: /W:1 
public class MyClass 
{ 
private protected void Test() // VIS1499 
// try the following line instead 
// protected void Test() 
uf 
} 
public static void main() 
uf 
} 
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Compiler Warning (level 1) VJS1500 


Error Message 
Type ‘type’ is found in more than one imported binaries. Using the one in ‘file’ 


A type was defined in two or more referenced assemblies. The Visual J# compiler chose the type defined in file. 


Example 


// VIS15@@a.cs 

// compile with: /target:library 
// a C# program 

public class MyClass 

{ 


} 


public static int i = 1; 


// VIS150@b.cpp 

// compile with: /LD /clr 

// a C++ program 

public ref struct MyClass { 
static int i = Q; 


}3 


// VIS150@c.jsl 

// compile with: /reference:VJS150@a.d1l1 /reference:VIS150@b.d11 /W:1 
// NJS1500 expected 

public class MyClass2 


{ 
public static void main() 
{ 
System.Console.WriteLine(MyClass.i); 
} 
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Compiler Warning (level 1) VJS1503 


Error Message 
‘member’ is deprecated 


A member marked as deprecated was invoked. 


Example 


// VIS15@3a.cs 

// compile with: /target:library 
// a C# program 

public class VJS15@3a 


[System.Obsolete ("deprecated") ] 
public void Test() {} 


The following sample generates VJS1503. 


// VIS1503b.js1 
// compile with: /target:library /reference:VJS1503a.d11 /W:1 
class MyClass 
{ 

public void Test() 

{ 

new VJS15@3a () .Test ()3;  // VIS15@3 
} 
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Compiler Warning (level 1) VJS1504 


Error Message 
Package ‘package’ was already implicitly imported 


The compiler issues this warning when you try to import a package that is implicitly imported by the compiler. To resolve this 
warning, delete the explicit import statement. 


The following sample generates VJS1504: 


// VIS1504.js1 

// compile with: /target:library /W:1 

import java.lang.*; // VIJS1504 Package java.lang is implicitly imported 
class MyClass 

{ 

} 
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Compiler Warning (level 1) VJS1505 


Error Message 
Package ‘package’ was already imported 


A package (or namespace) was imported more than once. 


The following sample generates VJS1505: 


// VIS1505.jsl 

// compile with: /W:1 

import System.*; // \VIS1505 

import System.*; 

class Test 

{ 
public static void main(String[] args) 
uf 
} 
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Compiler Warning (level 4) VJS1506 


Error Message 
The 'l' suffix is easily confused with the digit '1' — use 'L' for clarity 


To avoid possible syntax errors, use uppercase 'L' to specify a long value, and not lowercase ‘I’. 


The following sample generates VJS1506: 


// VIS1506.js1 

// compile with: /W:4 

class MyClass 

{ 
public static void TestL(long i) 
{ 
} 


public static void TestL(int i) 


{ 
} 


public static void main() 


TestL(251); = // VIS15e6 
// try the following line instead 
// TestL(25L); 
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Compiler Warning (level 3) VJS1507 


Error Message 
This ‘instanceof’ operator will always be true 


The compiler detected that a particular instanceof check will always succeed and return true. This can happen when the 
instanceof operator is used to check if a derived class object is an instance of a base class or an implemented interface. The 
warning is given because the check is redundant. 


The following sample generates VJS1507: 


// NVIS1507.js1 
// compile with: /W:3 
interface I { } 


class A { } 
class B extends A implements I { } 
public class MyClass 


public static void main (String [] args) 


{ 
B b = new B()3 


// Each of the instanceof operators below give VJS1507 


if (b instanceof B) // VIJS1507 b is of type B 


: 
} 


if (b instanceof A) // VIS15®7 b is instance of B that extends A 


{ 
} 


if (b instanceof I) // VJS1507 b is instance of B that implements I 


t 
} 


if (b instanceof Object) // VIS1507 all classes derive from Object 


{ 
} 
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Compiler Warning (level 1) VJS1510 


Error Message 


Empty switch block 


An empty switch block was detected. 


The following sample generates VJS1510: 


// VIS1510.js1 
// compile with: /W:1 
class MyClass 
{ 
public static void main() 
{ 
int i = 6; 
switch(i) 


// to resolve, add something to the switch block, for example: 
/* 
case (5): 
System.Console.WriteLine("5"); 
return; 


default: 
System.Console.WriteLine("not 5"); 
return; 
ad 
} // VIS1510 
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Compiler Warning (level 3) VJS1512 


Error Message 
Variable ‘var' is initialized but never used 


A variable was declared and initialized, but never used. 
The following sample generates VJS1512: 
// VIS1512.js1 


// compile with: /W:3 
class Test 


{ 
public static void main(String[] args) 
{ 
int i = @; // \IS1512 
} 
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Compiler Warning (level 1) VJS1513 


Error Message 
Type ‘type’ is found in an imported assembly and in the source. Using the one in the source. 


The compiler detected that a type found in an imported assembly was also declared in the source file. The type from the source 
file will be used. 


The following sample generates VJS1513: 


// VIS1513.jsl 

// compile with: /target:library /W:1 
package java.util; 

class Vector { } // VIS1513 
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Compiler Error VJS1515 


Error Message 
Option option overrides attribute given in source. 


This error occurs when an attribute specified in a source file is in conflict with a command line option. 


To correct this error 


e Remove the source line or do not use the conflicting option. 


Example 
The following sample generates VJS1515. 


// VIS1515.jsl 

// compile with: /keyfile:mykey.snk 

/** @assembly System.Reflection.AssemblyKeyName("myotherkey.snk") */ 
class MyClass 


{ 
public static void main() 
‘ 
} 
} 
See Also 


Other Resources 
Visual J# Compiler 
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Compiler Warning (level 2) VJS1516 


Error Message 
A reference to the volatile field field will not be treated as volatile. 


A volatile field is passed as an out param. 


To correct this error 


Example 
The following sample generates VJS1516. 


public class VolatileField f{ 
public static volatile R js_volatilefield_js; 


public static void method1(/**@attribute System.Runtime. InteropServices.OutAttribute()* 
/ /**@ref*/ R myR) { 


myR = new R(); 
public static void method2() { 
js_volatilefield_js = new R(); 


method1(js_volatilefield_ js); 


ij 
class R{} 
See Also 


Other Resources 
Visual J# Compiler 
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Compiler Warning (level 2) VJS1517 


Error Message 
Volatile field field of type long/double will not be treated as volatile. 


To correct this error 


Example 
The following sample generates VJS1517. 


public class Field f{ 


static volatile double js_volatilefield js = 0.001; 


} 


See Also 
Other Resources 


Visual J# Compiler 
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Compiler Warning (level 1) VJS1518 


Error Message 
The secure scoping option is ignored on member member since it overrides a base class method with wider scope. 


To correct this error 


e Check to make sure that you want to override secure scoping. 


Example 
The following sample generates VJS1518. 


public class Test 


void foo() 


} 


public class User extends Test 


void foo() // VIJS1518 expected 


{ 
} 


See Also 
Other Resources 


Visual J# Compiler 
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Compiler Warning (level 3) VJS1519 


Error Message 
MemberName: member name same as enclosing type. 


The member specified has the same name as the type that it belongs to. 
To correct this error 


e Change the member name so it is not the same as its parent type. 


Example 
The following sample generates VJS1519. 


// VIS1519.jsl 
// compile with: /t:1 /w:3 
public class VJS1519 


if 
public void VJS1519a() { } 
//public void VJS1519(){} //uncomment this line to generate VJS1519 
} 
See Also 


Other Resources 
Visual J# Compiler 
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Compiler Warning (level 3) VJS1520 


Error Message 
Switch statement contains no ‘case’ or ‘default’ labels. 


To correct this error 


Example 
Comment the default clause to generate VJS1520. 


// VIS1520.jsl 
// compile with: /t:1 /w:3 


public class VJS152@ 


{ 
int var = @; 
public void method() 
{ 
switch (var) 
{ 
case Q: 
break; 
case 2: 
break; 
//default: //uncomment out next two lines correct VJS1520 
// System.out.printlin("invalid entry"); 
} 
} 
} 
See Also 


Other Resources 
Visual J# Compiler 
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Compiler Warning (level 3) VJS1522 


Error Message 
Empty control statement. 


Your control statement is incomplete. 
To correct this error 


e Add conditions to your control statement. 


Example 
The following sample generates VJS1522. 


// VIS1522.js1 
// compile with: /t:1 /w:3 
public class VJS1522 


{ 
public void method() 
if (true) 
System.out.println("Item is true"); //comment this line to generate VJS1522 
} 
} 
See Also 


Other Resources 
Visual J# Compiler 
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Compiler Warning (level 2) VJS1523 


Error Message 
Invalid #pragma checksum syntax 


A #pragma checksum directive must contain three elements: a valid file name, the GUID for the file, and the checksum bytes. 
For more information, see #pragma checksum (Visual J#). 


To correct this error 


e Ensure that all three elements of the directive are present. 


Example 
The following example generates VJS1523 because it has no value for checksum bytes. 


#pragma checksum "drt1.java" "{BED7F4EA-1A96-11d2-8FQ8-@GAQ8C9A6186D}" me 
// VIJS1523 expected 


See Also 
Other Resources 


Visual J# Compiler 
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Compiler Error VJS1524 


Error Message 
@dll.import directive must supply a DLL name 


The compiler detected an ill-formed @dll.import specification. 


The following sample generates VJS1524: 


// NIS1524.js1 
class MyClass 
{ 
/** 
* @d11l.import() // VIS1524, no .dll file specified 
// try the following line instead 
// * @dll.import("msvcrt", auto) 
*/ 
public static native int puts(System.String c); 


public static void main() 


{ 
} 
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Compiler Warning (level 3) VJS1525 


Error Message 
Parameter name ‘param1' does not match with the corresponding @com.parameters parameter name ‘param2' 


Parameter names have to match between the method declaration and the parameters specified in an @com attribute. 


The following sample generates VJS1525: 


// VIS1525.jsl 
// compile with: /reference: TESTCOMOBIJLib.d1l /target:library /W:3 
package testcomobj; 


/** @com.class(classid=836A4F1C-AF14-4210-99DB-28C7BDD2DE2B,DynamicCasts) */ 
public class Calculator // contained in TEstCOMObjLib.d1l 
{ 
/** @com.method(vtoffset=4, dispid=1, type=METHOD, name="Add", addFlagsVtable=4) 
@com.parameters([in,type=14] a, [in,type=14] b, [type=I4] return) */ // VIS1525 
public native int Add(int i, int b); 
// try the following line instead 
// public native int Add(int a, int b); 
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Compiler Error VJS1526 


Error Message 
‘return’ must be last in @com.parameters declaration 


The compiler detected an identifier after the return statement in an @com.parameters declaration. 


The following sample generates VJS1526: 


// VIS1526.js1 
// compile with: /target:library 
class MyClass 
{ 
/** @com.parameters([type=14] return, i) */ // VIS1526 
// try the following line instead 
// /** @com.parameters([type=14] i, return) */ 
native int method1i(Object i); 
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Compiler Error VJS1527 


Error Message 
‘return’ is already defined in @com.parameters 


The compiler detected a duplicate return statement in an @com.parameters declaration. 


The following sample generates VJS1527: 


// NIS1527.js1 
// compile with: /target:library 
class MyClass 
{ 
/** @com.parameters([type=14] i, return, return) */ // VIJS1527 
// try the following line instead 
// /** @com.parameters([type=14] i, return) */ 
native int methodi(int i); 
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Compiler Error VJS1528 


Error Message 
The @com.parameters directive has wrong number of parameters for member 'member' 


The number of parameters has to match between the method declaration and the parameters specified in an @com attribute. 


The following sample generates VJS1528: 


// VIS1528.js1 
// compile with: /target:library /reference:testcomobjlib.d1l 
// assumes the presence of a COM object, testcomobjlib.d1l 
/** @com.class(classid=836A4F1C-AF14-4210-99DB-28C7BDD2DE2B, DynamicCasts) */ 
public class Calculator 
{ 
/** @com.method(vtoffset=4, dispid=1, type=METHOD, name="Add", addFlagsVtable=4) 
@com.parameters([in,type=14] a, [type=I4] return) */ 
public native int Add(int a, int b); // VIS1528 
// try the following line instead 
// public native int Add(int a); 
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Compiler Error VJS1529 


Error Message 
‘parameter’ is required for ‘attribute’ 


An attribute was not fully defined. 


The following sample generates VJS1529: 


// VIS1529.jsl1 

// compile with: /target:library 

/** @com.class() */ // VIS1529 

// try the following line instead 

// /** @com.class(classid=911CAED@-2957-11d1-A55E-@@A@C9@F26EE) */ 
public class Calculator 

{ 

} 
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Compiler Error VJS1530 


Error Message 
‘@attribute' is not valid for this declaration 


An attribute was applied to a construct for which it was not designed. 


The following sample generates VJS1530: 


// VIS1530.jsl 

/** @com.register (clsid=2148925C-234F-11D2-8C4E-0@0CO4F8F3341, typelib=2148925B-234F-11D2-8 
C4E-@0CO4F8F3341) */ // NIS1530 

interface MyInterface 

{ 

} 
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Compiler Error VJS1531 


Error Message 
Cannot find .NET COM class with GUID ‘guid’ 


A reference to a class was not resolved. 


The following sample generates VJS1531: 


// VIS1531.jsl 

// compile with: /target:library 

/** @com.class(classid=911CAED@-2957-11d1-A55E-@@A@C9@F26EE) */ // NVIS1531 
// To resolve, reference a COM object on which JActiveX or uuidgen was run 
// and that has a class with the specified ID. 

class MyClass 


/** @com.parameters([type=14], return) */ 
int methodi(int i); 
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Compiler Error VJS1532 


Error Message 
Cannot find .NET COM interface with GUID ‘guid! 


A reference to an interface was not resolved. 


The following sample generates VJS1532: 


// NVIS1532.jsl 

// compile with: /target:library 

/** @com. interface (iid=911CAED@-2957-11d1-A55E-@@A@C9@F26EE) */ // NIS1532 
// to resolve, reference a COM object on which JActiveX or uuidgen was run 
// and that has an interface with the specified ID 

interface MyInterface 

{ 

} 
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Compiler Error VJS1533 


Error Message 
Cannot find a matching .NET method for the method 'method' on COM class/interface ‘type’ 


To compile an attributed interface wrapper generated by the JActiveX tool, you need to refer to the Tiblmp-generated DLL for 
the type library. The Visual J# compiler tries to find a match for each method in the interface in the corresponding interface in 
the TlbImp-generated DLL. In this case, the compiler was not able to find a method that matches the name and the signature of 
the method found in the @com.interface-attributed interface. 


The example below will give this error as Addi is not a method found in the interface calculator. 


The following sample generates VJS1533: 


// VIS1533.jsl 

// compile with: /target:library /reference: TESTCOMOBILib.d1l 
// assumes the presence of a COM object, testcomobjlib.d1l 
import com.ms.com.IUnknown; 


// Dual interface ICalculator 
/** @com. interface (iid=7F707219-A772-4437-AD86-DBABD5F6BC33, thread=AUTO, type=DUAL) */ 
public interface ICalculator extends IUnknown 
{ 
/** @com.method(vtoffset=4, dispid=1, type=METHOD, name="Add1", addFlagsVtable=4) 
@com.parameters([in,type=14] a, [in,type=14] b, [type=I4] return) */ 
public int Addi(int f, int b);  // VIS1533 
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Compiler Error VJS1534 


Error Message 
The @com.parameters directive for parameter ‘param’ does not specify a value for ‘type’ 


The @com.parameters directive does not have a type attribute for a parameter. 


The following sample generates VJS1534: 


// VIS1534.jsl1 
// compile with: /target:library /reference: TESTCOMOBIJLib.d11 
// assumes the presence of a COM object, testcomobjlib.d1l 
/** @com. interface (iid=7F707219-A772-4437-AD86-DBABD5F6BC33, thread=AUTO, type=DUAL) */ 
public interface ICalculator extends com.ms.com.IUnknown 
{ 
/** @com.method(vtoffset=4, dispid=1, type=METHOD, name="Add", addFlagsVtable=4) 
@com.parameters([in] a, [in,type=14] b, [type=I4] return) */ // VIS1534 
// try the following line instead 
// @com.parameters([in, type=14] a, [in,type=14] b, [type=1I4] return) */ 
public int Add(int a, int b); 
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Compiler Error VJS1535 


Error Message 
The @com.parameters directive for parameter ‘param’ has a type that is not supported 


The @com.parameters directive had a type value of STRUCT or PTR and the actual parameter was not a STRUCT. In the 
example below, parameter a is of type Object and is not a stRuct (a class attributed with @com.struct). 


The following sample generates VJS1535: 


// VIS1535.jsl 

// compile with: /target:library /reference: TESTCOMOBIJLib.d1l1 

// assumes the presence of a COM object, testcomobjlib.d1l 

import com.ms.com.IUnknown; 

// Dual interface ICalculator 

/** @com. interface (iid=7F707219-A772-4437-AD86-DBABD5F6BC33, thread=AUTO, type=DUAL) */ 
interface ICalculator extends com.ms.com.IUnknown 


/** @com.method(vtoffset=4, dispid=1, type=METHOD, name="Add", addFlagsVtable=4) 
@com.parameters([in,type=STRUCT] a, [in,type=14] b, [type=14] return) */ // VIS153 


public int Add(Object a, int b); 
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Compiler Error VJS1537 


Error Message 
The @com.parameters directive for parameter 'param' has a SAFEARRAY VT type that is not supported 


The parameter in the @com.parameters directive is a SAFEARRAY (type=SAFEARRAY), but the value for the vt attribute was 
one that is not supported. 


Visual J# only supports the following values: 
e VT_I2=2 
e VT_I4 =3 
e VT_R4=4 
e VT_R8=5 
e VT_CY=6 
e VT_DATE =7 
e VT_BSTR = 8 
e VT_DISPATCH = 9 
e VT_BOOL = 11 
e@ VT_VARIANT = 12 
e VT_UNKNOWN = 13 
e VT_I1 = 16 
e VT_UI1 =17 


The following sample generates VJS1537: 


// NVIS1537.js1 
// compile with: /target:library /reference: TESTCOMOBILib.d1l 
// assumes the presence of a COM object, testcomobjlib.d1l 
import com.ms.com.IUnknown; 
// Dual interface ICalculator 
/** @com. interface (iid=7F707219-A772-4437-AD86-DBABD5F6BC33, thread=AUTO, type=DUAL) */ 
public interface ICalculator extends IUnknown 
{ 
/** @com.method(vtoffset=4, dispid=1, type=METHOD, name="Add", addFlagsVtable=4) 
@com. parameters([in, type=SAFEARRAY, vt=10] a, [in,type=14] b, [type=I4] return) */ 
// NIS1537 
public int Add(com.ms.com.SafeArray a, int b); 
// don't use Add or change its definition in the COM object 
// to use a different VT type 
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Compiler Error VJS1538 


Error Message 
The @com.parameters directive for ‘param’ uses custom marshalling which is not supported 


The @com.parameters directive indicates that custom marshaling is being used (type=CUSTOM). This is not supported in 
Vjprvj. 
The following sample generates VJS1538: 


// VIS1538.jsl 

// compile with: /target:library /reference: TESTCOMOBIJLib.d1l1 
// assumes the presence of a COM object, testcomobjlib.d1l 
import com.ms.com.IUnknown; 


// Dual interface ICalculator 
/** @com. interface (iid=7F707219-A772-4437-AD86-DBABD5F6BC33, thread=AUTO, type=DUAL) */ 
public interface ICalculator extends IUnknown 


/** @com.method(vtoffset=4, dispid=1, type=METHOD, name="Add", addFlagsVtable=4) 
@com. parameters([in, type=CUSTOM, customMarshal="myMarshallerClass"] a, [in,type=14] b 
» [type=14] return) */ // VIS1538 
public int Add(int a, int b); 
} 
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Compiler Error VJS1539 


Error Message 
Unable to create the intermediate source file for COM interface wrapper 


The compiler creates temporary files during compilation of Java-language source files that are @com-attributed. This error 
occurs if the compiler is unable to create a temporary file. The temporary files are either created in the user's temp directory or 
in the current directory. 


This error is raised if you do not have write permissions on the temp directory (or the current directory) or if the disk is full. 
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Compiler Error VJS1540 


Error Message 
In @dll or @com, ‘parameter’ is invalid for ‘class’ 


An invalid parameter was found on an attribute. 


The following sample generates VJS1540: 


// VIS1540.js1 

// compile with: /target:library 

/** @dll.import("test.d11", entrypoint="Test") */ // VIS154e 
// try the following line instead 

// /** @dll.import("test.d11") */ 

public class MyClass 

{ 

} 
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Compiler Error VJS1541 


Error Message 
In @dll or @com, ‘member’ requires ‘parameter’ 


An attribute was ill-formed due to missing information. 


The following sample generates VJS1541: 


// VIS1541.jsl1 

// compile with: /target:library 

// NVJS1541 expected 

/** @d1l.struct(noAutoOffset) */ 

public class MyClass 

{ 
/** @dll.structmap() */ 
// Try the following line instead: 
// /** @d1ll.structmap([offset=0]) */ 
int i; 
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Compiler Error VJS1542 


Error Message 
‘pack’ and 'noAutoOffset’ cannot be specified together for ‘attribute’ 


Mutually exclusive parameters were specified for an attribute. 


The following sample generates VJS1542: 


// VIS1542.js1 

// compile with: /target:library 

/** @d1l.struct(noAutoOffset, pack=1) */ // VIS1542 
// try the following line instead 

// /** @d1l.struct(noAutoOffset) */ 

public class MyClass 

{ 

} 
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Compiler Error VJS1543 


Error Message 
Syntax error in '@attribute' for GUID declaration 


A GUID was specified incorrectly. 


The following sample generates VJS1543: 


// VIS1543.jsl 

// compile with: /target:library 

/** @com.class(classid=x) */ // VIJS1543, add real classid 
public class MyClass 

{ 

} 
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Compiler Error VJS1544 


Error Message 
Syntax error in '@attribute’ declaration 


A syntax error was found in an attribute declaration. 


The following sample generates VJS1544: 


// \NIS1544.js1 
class MyClass 
{ 
/** 
* @d1l.import(, auto) // VIS1544, no .d1ll file specified 
// try the following line instead 
// * @d1l.import("msvcrt", auto) 
e/ 
public static native int puts(System.String c); 


public static void main() 


{ 
} 
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Compiler Error VJS1545 


Error Message 
@dll.import requires ‘method’ to be native 


A method declared with @dll.import must be declared with the native qualifier. 


The following sample generates VJS1545: 


// VIS1545.js1 
// compile with: /target:library 
class MyClass 
{ 
[** 
* @dll.import("msvcrt", auto) 
*/ 
public static int puts(System.String c); // VIS1545 
// try the following line instead 
// public static native int puts(System.String c); 


public static void main() 
{ 
} 
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Compiler Error VJS1546 


Error Message 
The matching .NET type for class/interface ‘type’ has the same package name. Please use /namespace or /out option of 
tlbimp.exe to import the type library to a different package. 


An @com.interface-attributed interface has the same package name as the matching class generated by TlbIlmp.exe. 


In the sample below, the matching .NET Framework class in the TlbImp-generated DLL TESTCOMOBJLib.dll also has the same 
package name. To resolve this error, use tlbimp /namespace=SomethingElse TestComObj.d11 and then recompile. 


The following sample generates VJS1546: 


// VIS1546.js1 

// compile with: /target:library /reference: TESTCOMOBILib.d1l1 
// assumes the presence of a COM object, testcomobjlib.d1l 
package TESTCOMOBIJLib; 

import com.ms.com.IUnknown; 


// Dual interface ICalculator 
/** @com. interface(iid=7F707219-A772-4437-AD86-DBABD5F6BC33, thread=AUTO, type=DUAL) */ / 
/ VIS1546 
public interface ICalculator extends IUnknown 
{ 
/** @com.method(vtoffset=4, dispid=1, type=METHOD, name="Add", addFlagsVtable=4) 
@com.parameters([in,type=14] a, [in,type=14] b, [type=14] return) */ 
public int Add(int a, int b); 
} 
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Compiler Error VJS1547 


Error Message 
The matching .NET field ‘field’ is not found in Class ‘type’ which is required for J/Direct 


To compile an @com-attributed interface wrapper generated by the JActiveX tool, you need to refer to the Tlblmp-generated 
DLL for the type library. The Visual J# compiler tries to match each method in the interface with a method in the corresponding 
interface from the Tlblmp-generated DLL. Here, the matching field was not found in the Tlblmp-generated class. 


In the sample below, resolve the error by either removing the field declaration or mapping it to one of the field declarations in 
the TESTCOMOBJLib.MyStruct class. 





The following sample generates VJS1547: 


// NVIS1547.js1 

// compile with: /target:library /reference: TESTCOMOBILib.d1l 
// assumes the presence of a COM object, testcomobjlib.d1l 
package testcomobj; 


/** @com.struct(noAutoOffset) */ 


public final class MyStruct // NIS1547 

{ 
/** @com.structmap([offset=0,type=14] fld1) */ 
public int f1d1; 


/** @com.structmap([offset=4,type=14] fld2) */ 
public int f1d2; 
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Compiler Error VJS1548 


Error Message 
Use /jcpa:@file_name option to bind the correct tlbimported .NET type for 'type1' which is conflicting with .NET type ' type2' 


There are two instances of the same COM interface in two different libraries. There are also two corresponding .NET 
Framework interfaces in different namespaces (in their own assemblies). 


The compiler is unable to resolve which COM interface corresponds to which .NET Framework interface. Use the /jcpa compiler 
option to explicitly specify this correspondence. 
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Compiler Error VJS1549 


Error Message 
Missing @com.parameters directive for the method 'method' of COM interface ‘interface’ 


The @com.parameters directive is missing from a COM method in an @com-attributed COM interface. 


The following sample generates VJS1549: 


// VIS1549.jsl1 
// compile with: /target:library /reference: TESTCOMOBILib.d1l 
// assumes the presence of a COM object, testcomobjlib.d1l 
import com.ms.com.IUnknown; 
/** @com. interface (iid=7F707219-A772-4437-AD86-DBABD5F6BC33, thread=AUTO, type=DUAL) */ 
interface ICalculator extends IUnknown 
{ 
/** @com.method(vtoffset=4, dispid=1, type=METHOD, name="Add", addFlagsVtable=4) */ 
// add the following line to the attribute block 
// @com.parameters([in,type=14] a, [in,type=14] b, [type=14] return) 
public int Add(int a, int b); // VvIS1549 
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Compiler Error VJS1550 


Error Message 
The @com.parameters directive does not contain information about all the parameters of the method 'method' of COM 
interface ‘interface’ 


The @com.parameters directive does not describe all of the parameters. 


The following sample generates VJS1550: 


// VIS155@.jsl 

// compile with: /target:library /r:TESTCOMOBIJLib.d11l 

// assumes the presence of a COM object, testcomobjlib.d1l 

import com.ms.com.IUnknown; 

/** @com. interface (iid=7F707219-A772-4437-AD86-DBABD5F6BC33, thread=AUTO, type=DUAL) */ 
interface ICalculator extends IUnknown 


/** @com.method(vtoffset=4, dispid=1, type=METHOD, name="Add", addFlagsVtable=4) 
@com.parameters([in,type=14] a, [type=14] return) */ 
// try the following line instead 
// @com.parameters([in,type=14] a, [in,type=14] b, [type=I4] return) */ 
public int Add(int a, int b); // VIS155e 
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Compiler Warning (level 1) VJS1551 


Error Message 
‘attribute’ is not valid here, ignoring it. 


An attribute was applied on a declaration for which it was not designed. The attribute was ignored by the compiler. 
The following sample generates VJS1551: 
// VIS1551.js1 


// compile with: /target:library /W:1 
class MyClass 


/** @dll.struct () */  // VIS1551 
int x; 
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Compiler Error VJS1552 


Error Message 
‘value’ is not a valid value for /jcpa 


An invalid value was passed to the /jcpa compiler option. 


The following sample generates VJS1552: 


// VIS1552.jsl1 

// compile with: /jcpa:# 

// \“'JS1552 expected 

public class MyClass 

{ 
public static void main() 
{ 
} 
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Compiler Warning (level 2) VJS1553 


Error Message 
A COM type library for the class 'comclass' was not found. COM applications that used to access this class using a type library 
will not work. 


The @com.register attribute does not specify a type library GUID or the GUID that was specified was not registered on the 
machine. 


In Visual J+ + 6.0, you could access a Java-language/COM component marked with the @com.register attribute from COM 
clients. If the Java-language/COM component was accessed by COM clients using the type library generated for the 
component by the VJREG tool, the COM client would use the dispinterface exposed on the component and would have cached 
the Displds of the members. The Displds of such a component are not guaranteed to be the same in the NET Framework. This 
may cause existing COM clients to fail. To avoid such run-time failures, the compiler must generate the same Displds that were 
used by COM clients. This warning is given when the compiler is unable to load the type library and hence cannot ensure that 
COM clients that use this object by means of the dispinterface continue to function properly at run time. 


To work around this issue: 


e If atypelib attribute was not specified, add this attribute to the @com.register class. The value of the typelib GUID 
should be the same as the GUID assigned to the type library generated by the VJREG tool. 


e Make sure that the type library with the given GUID is registered on the machine. 


The following sample generates VJS1553: 


// VIS1553.jsl 

// compile with: /target:library /W:2 

// typelib attribute missing in @com.register directive 

/** @com.register(clsid=b62107bb-18ed-4796-a61a-@ade6edd3a91) */ 

public class test{} // VJS1553 

// typelib attribute found but type library is not registered on machine 

/** @com.register(clsid=b62107bb-18ed-4796-a61a-@ade6edd3a91, typelib=84b1fa15 -6a14-4663-be 
9e-aa23Fe4ee9ed) */ 

public class test2{} // VIS1553 
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Compiler Error VJS1554 


Error Message 
DillmportAttribute requires method 'method' to be static and native 


The DLLImportAttribute can be attached only to methods that are static and native. 


The following sample generates VJS1554: 


// VIS1554.js1 
import System.Runtime.InteropServices. *; 


public class MyClass { 
/** @attribute DllImportAttribute("Test") */ 
public static void Compute(); // VIS1554 
// try the following line instead 
// public static native void Compute(); 
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Compiler Error VJS1555 


Error Message 
The class ‘class' cannot be exposed to COM as it is not a public class 


Only public classes can be exposed to COM using the @com.register attribute. 


This error is also given when you try to expose nested private classes to COM by way of implementing a COM interface on the 
class. 


Example 


// VIS1555a.jsl 

// compile with: /target:library 

/** @com.register(clsid=17d49bf0-d80f-4cb4-a40f-a17b1037bee5) */ 
// class MyClass {} // VIS1555 

// try the following line instead 

// public class MyClass {} 


// VIS1555b.jsl1 

// compile with: /target:library 

import com.ms.com.*; 

public class MyOuterClass 

{ 
private class MyEnum implements IEnumVariant // VIS1555 
// try the following line instead 
// public class MyEnum implements IEnumVariant 


{ 
public IEnumVariant Clone() { return null; } 
public void Next(int celt, Variant[] rgvar, int[] pceltFetched) {} 
public void Reset() {} 
public void Skip(int celt) {} 
} 
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Compiler Error VJS1561 


Error Message 
file : The file format does not comply with win32 resource file format. 


A file passed to the /win32res compiler option was not in the format of a Win32 resource file. 
To correct this error 


e Make sure the file you are passing to the compiler is a Win32 resource file. 


Example 
The following sample generates VJS1561: 


// VIS1561.jsl1 

// compile with: /win32res:VJS1561.doc 
// \'JS1561 expected 

// assume VJS1561.doc is a file on disk 
public class MyClass 


{ 
public static void main() 
{ 
} 
} 
See Also 


Other Resources 
Visual J# Compiler 
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Compiler Error VJS1562 


Error Message 
Could not find or read the file : ‘file’ 


A file passed to /win32res, /resource, or /linkresource was not found by the compiler, or could not be read by the compiler. 


The following sample generates VJS1562: 


// VIS1562.js1 
// compile with: /win32res:x.res 
// \'JS1562 expected 
// assume x.res is not on disk 
public class MyClass 
{ 

public static void main() 

t 

} 
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Compiler Error VJS1566 


Error Message 
Two resource data entries in the win32 resource have same type, name and language. Cannot attach such resources. 


The resource (.res) file specified with /win32res is corrupted so that the format is correct but the data is not. 


For example, appending a resource to a .res file twice or appending the .res file to itself and then trying to attach it using 
/win32res option would result in this error. 


To correct this error 


1. Locate the resource file. 
2. Make sure it is not corrupted. 


3. Check the code to make sure you have not appended the resource file more than once. 


Example 
The following sample generates VJS1566: 


//steps to reproduce: 

//copy some.res VJS1566.res 

//type some.res >> VJS1566.res 

//vjc /win32res:VIJS1566.res test.java 


// VIS1566.js1l 

// compile with: /win32res:VJS1566.res 
// VJS1566 expected 

public class MyClass 


{ 
public static void main() 
{ 
} 
} 
See Also 


Other Resources 
Visual J# Compiler 
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Compiler Error VJS1567 


Error Message 
Conflicting options specified: Win32 resource file; Win32 icon. 


To correct this error 


Example 
The following sample generates VJS1567. 


// VIS1567.js1 
// compile with: /win32res:MSN.ico /win32res:cmredz67.res 
package ConsoleApplication1; 


/** 
* Summary description for Program 
*/ 

// 

public class Program 


{ 


public static void main(String[] args) 


{ 
} 
} 


See Also 
Other Resources 


Visual J# Compiler 
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Compiler Error VJS1568 


Error Message 
Error generating Win32 Resource: Error reading icon icon -- The data is invalid. 


You have provided an invalid icon file to /win32icon. 
To correct this error 


e Check the icon data and try again. 


Example 
The following sample generates VJS1568. 


// compile with /win32icon:cmredz67.res sample.java //VJS1568 expected 


See Also 
Other Resources 


Visual J# Compiler 
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Compiler Error VJS1575 


Error Message 
Cannot call constructor recursively (directly or indirectly) 


This error occurs when you try to make a recursive call to a constructor inside a constructor. 


The following sample generates VJS1575: 


// VIS1575.jsl 
// compile with: /target:library 
public class MyClass 

MyClass() 


this(); // VJS1575, recursive call to the same constructor 
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Compiler Error VJS1576 


Error Message 
Unable to create the directory for compiler intermediate sources 


The compiler creates a temporary directory during compilation. This error occurs if the compiler is unable to create a 
temporary directory. 


This error is raised if you do not have write permissions for the directory or if the disk is full. 


Visual J# Reference 


Compiler Error VJS1578 


Error Message 
Unable to get the Visual J# system directory 


This error occurs when the Visual J# installation is corrupt. Perhaps some directories were deleted or maybe the registry has 
become corrupt. 


To resolve this error, repair or reinstall Visual J#. 
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Compiler Error VJS1579 


Error Message 
Build cancelled by user 


Cancel was selected from the Build menu in the development environment while a build was in progress. 
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Compiler Error VJS1580 


Error Message 
Internal Compiler Error - Out of memory 


The compiler ran out of memory while compiling sources. Retry compilation after doing one of the following: 


e Make memory available by closing one or more running applications. 


e Increase the virtual memory pagefile size. Refer to the operating system's online Help for how to do this on your 
operating system or contact your system administrator. 
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Compiler Error VJS1581 


Error Message 
Internal Compiler Error: reason 


Try to determine if the compiler is failing because of its inability to parse unexpected syntax. Then, contact 
Microsoft Product Support Services. 
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Compiler Error VJS1582 


Error Message 
Error attaching attribute ‘type’ — ‘message’ 


The compiler could not attach the attribute to the particular member. 


The following sample generates VJS1582: 


// VIS1582.js1 

// compile with: /target:library 

// \VJS1582 expected 

/** @attribute System.Runtime.InteropServices.GuidAttribute("") */ 
class MyClass 

{ 

} 
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Compiler Error VJS1800 


Error Message 
Property accessor must begin with a get_ or set_ 


A property name was ill-formed. 


The following sample generates VJS1800: 


// vjs1800e.jsl 
// compile with: /target:library 
public class C 
{ 
/** @property */ 
int Val()  // VIS18ee 
// try the following line instead 
// int get_Val() 
{ 


} 


return @; 
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Compiler Error VJS1801 


Error Message 
Property name 'name' is not a valid identifier 


The defined name of a property will resolve to the name minus the get_ or set_ prefix when used by a client. Certain characters 
are invalid at the beginning of an identifier. The first character after the get_ or set_ prefix in a property name must be a valid 
character with which to begin an identifier. For example, a property name cannot begin with a number. 


The following sample generates VJS1801: 


// VIS1801.js1 
// compile with: /target:library 
public class MyClass 
{ 
/** @property */ 
int get_2Val() // VJS1801 
// try the following line instead 
// int get_Val() 
{ 


} 


return @Q; 
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Compiler Error VJS1802 


Error Message 
‘identifier’ is redefined as a property or event name 


The property name as defined in Visual J# source resolves to the name minus get_ or set_ for users. Therefore, you cannot 
define an identifier to be the same as the name that a property will resolve to for consumers of your component. 


The following sample generates VJS1802: 


// VIS1802.js1 
// compile with: /target:library 
public class MyProp 
{ 
private int SomeNum = -1; 
// try the following line instead 
// private int i = -1; 


/** @property */ 
public int get_SomeNum() // VIJS1802, SomeNum already defined 
{ 


} 


return i; 
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Compiler Error VJS1803 


Error Message 
Property type cannot be void 


A property's get_ accessor must return a value. 


The following sample generates VJS1803: 


// VIS1803.js1 

// compile with: /target:library 
public class MyClass 

{ 


private int ival; 


/** @property */ 

public void get_Val() // VIS183 
// try the following line instead 
// public int get_Val() 

{ 


} 


return @Q; 
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Compiler Error VJS1804 


Error Message 
The set accessor method must have void return type 


The set access of a property did not have a void return type. 


The following sample generates VJS1804: 


// VIS1804.js1 

// compile with: /target:library 
public class MyClass 

{ 


private int ival; 


/** @property */ 

public int set_Val(int i) // VIS1804 
// try the following line instead 

// public void set_Val(int i) 

{ 


} 


ival = i; 
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Compiler Error VJS1805 


Error Message 
Both accessor methods of a property or event must have the same modifiers 


The accessor methods of a property or event must use the same access modifiers. 


The following sample generates VJS1805: 


// vjs1805.jsl 

// compile with: /target:library 
public class MyClass 

{ 


private int ival; 


/** @property */ 
public int get_Val() 
{ 


} 


/** @property */ 

private void set_Val(int i) // VIS18®5 
// try the following line instead 

// public void set_Val(int i) 

{ 


i 


return ival; 


ival = i; 
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Compiler Error VJS1806 


Error Message 
The event ‘event’ must have both add and remove accessors 


An event was not completely defined. 


The following sample generates VJS1806: 


// vjs1806.jsl 

// compile with: /target:library 
/** @delegate */ 

public delegate void ValueChanged(); 


public class Container // VJS1806 


{ 


public ValueChanged ev = null; 


/** @event */ 
public void add _Event(ValueChanged p) 


{ 
} 


ev = (ValueChanged) System.Delegate.Combine(ev, p); 


// event with add accessor also needs remove accessor 
// /** @event */ 

// public void remove_Event(ValueChanged p) 

th4 

// ev = (ValueChanged) System.Delegate.Remove(ev, p); 
ie 5 
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Compiler Error VJS1807 


Error Message 
Event name ‘identifier’ is not a valid identifier 


The defined name of an event will resolve to the name minus the add_ or remove_ prefix when used by a client. Certain 
characters are invalid at the beginning of an identifier. The first character after the add_ or remove_ prefix in an event name 
must be a valid character with which to begin an identifier. For example, an event name cannot begin with a number. 


The following sample generates VJS1807: 


// vjs1807.jsl1 

// compile with: /target:library 
/** @delegate */ 

public delegate void ValueChanged() ; 


public class Container 


{ 


public ValueChanged ev = null; 


/** @event */ 

public void add_2Event(ValueChanged p) // NIS1807 
// try the following line instead 

// public void add_Event(ValueChanged p) 


{ 
} 


/** @event */ 
public void remove_2Event(ValueChanged p) // VIJS1807 


{ 
} 


ev = (ValueChanged) System.Delegate.Combine(ev, p); 


ev = (ValueChanged) System.Delegate.Remove(ev, p); 
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Compiler Error VJS1808 


Error Message 
Event type ‘identifier’ is not a delegate 


An identifier was used as a delegate, but was not declared as a delegate. 
The following sample generates VJS1808: 

// vjs1808.js1 

// compile with: /target:library 

// uncomment the following line to resolve 


// /** @delegate */ 
public delegate void ValueChanged(); 


public class Container 
public ValueChanged ev = null; 
/** @event */ 
public void add _Event(ValueChanged p) // VIS188 
{ 


} 
/** @event */ 
public void remove_Event(ValueChanged p) 


{ 
} 


ev = (ValueChanged) System.Delegate.Combine(ev, p); 


ev = (ValueChanged) System.Delegate.Remove(ev, p); 
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Compiler Error VJS1809 


Error Message 
Event accessor must have void return type 


An event accessor had an invalid return type. 


The following sample generates VJS1809: 


// vjs1809.jsl 

// compile with: /target:library 
/** @delegate */ 

public delegate void ValueChanged(); 


public class Container 


{ 
public ValueChanged ev = null; 


/** @event */ 
public int add _Event(ValueChanged p) // VIS189 
// try the following line instead 
// and delete the return statement from the body of the event 
// public void add_Event(ValueChanged p) 
{ 
ev = (ValueChanged) System.Delegate.Combine(ev, p); 
return Q; 


} 


/** @event */ 
public void remove_Event(ValueChanged p) 


t 
} 


ev = (ValueChanged) System.Delegate.Remove(ev, p); 
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Compiler Error VJS1810 


Error Message 
Event accessor must be of type 'void add_name(type)' or 'void remove_name(type)' where 'type' derives from System.Delegate 


An event accessor has an invalid number of arguments. 


The following sample generates VJS1810: 


// vjs1810.jsl 

// compile with: /target:library 
/** @delegate */ 

public delegate void ValueChanged(); 


public class Container 


{ 
public ValueChanged ev = null; 


/** @event */ 

public void add Event(ValueChanged p, int i) // VIS1818 
// try the following line instead 

// public void add_Event(ValueChanged p) 


{ 
ev = (ValueChanged) System.Delegate.Combine(ev, p); 


} 


/** @event */ 
public void remove_Event(ValueChanged p) 


{ 
ev = (ValueChanged) System.Delegate.Remove(ev, p); 


} 
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Compiler Error VJS1811 


Error Message 
Event accessor must begin with add_ or remove_ 


An event accessor name did not begin as expected. 


The following sample generates VJS1811: 


// vjs1811.jsl 

// compile with: /target:library 
/** @delegate */ 

public delegate void ValueChanged(); 


public class Container 


{ 


public ValueChanged ev = null; 


/** @event */ 

public void set_Event(ValueChanged p) // VIS1811 
// try the following line instead 

// public void add_Event(ValueChanged p) 


{ 
ev = (ValueChanged) System.Delegate.Combine(ev, p); 


} 


/** @event */ 
public void remove_Event(ValueChanged p) 


{ 
ev = (ValueChanged) System.Delegate.Remove(ev, p); 


} 
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Compiler Error VJS1812 


Error Message 
Type ubyte, short, int or long expected. 


An invalid type was used in an enumeration type. Enum members represent the possible values of the enumeration, and so 
must be an integral type; although char is not allowed. 


See Also 
Other Resources 


Visual J# Compiler 
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Compiler Error VJS1817 


Error Message 
Property index index must be of type int 


The specified property index is not an int. 
To correct this error 


1. Find the property that you are trying to set or get. 


2. Change the parameter type to int. 


Example 
The following example generates VJS1817. 


package ConsoleApplication; 


/** 
* Summary description for Program 
= 
public class Program 
{ 
public static void main(String[] args) 
{ 
// 
// Add code to start application here: 
Lf 
} 
public class WithNonIntIndexer 
1 
protected String[] __prop = new String[3]; 
/**@beanproperty*/ 
public void setprop(String index, String val) 
{ 
} 
/**@beanproperty*/ 
public String getprop(String index) 
{ 
return null; 
} 
} 
} 
See Also 
Reference 


Defining and Using Properties 
Other Resources 
Visual J# Compiler 
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Compiler Error VJS1818 


Error Message 
Property accessor must begin with an is, or a get, or a Set. 


Visual J# translates properties in .NET Framework classes to the accessor methods get_ and set_. When you get a property, the 
accessor must begin with get_. If you put (or set) a property, the accessor must begin with set_. 


To correct this error 


1. Find the property that you are trying to get or set. 


2. Change the accessor using the appropriate preceding text (is, get_, or set_). 


Example 
The following example generates VJS1818. 


public class UnsupportedNamingConvention 


1 
protected int __prop = 23; 
/**@beanproperty */ 
public void putprop(int i) 
{ 
} 
public static void main(String[] args) 
{ 
} 
} 
See Also 
Reference 


Defining and Using Properties 
Other Resources 
Visual J# Compiler 
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Compiler Error VJS1819 


Error Message 
Too many parameters in accessor of property property. 


The specified property declaration contains more parameters in its argument than it should. 
To correct this error 


1. Locate the specified property. 
2. Review the property's parameters. 


3. Remove any unnecessary parameters. 


Example 
The following sample generates VJS1819. 


public class IsWithArgs 

{ 

/**@beanproperty*/ 

public boolean ispropWithNonZeroArgs(int i) 


{ 


return false; 


i 


public static void main(String[] args) 
{ 
} 
} 


See Also 

Reference 

Defining and Using Properties 
Other Resources 

Visual J# Compiler 
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Compiler Error VJS1820 


Error Message 
The is accessor must have a boolean return type. 


The is accessor indicates whether the item you are checking is a property, so it must return a boolean. 
To correct this error 
1. Find the is<property> method. 


2. Change the return type. 


Example 
The following sample generates VJS1820. 


public class IsWithNonBooleanReturnType 
{ 


/**@beanproperty */ 
public int isprop() 
{ 


} 


return 23; 


public static void main(String[] args) 
{ 
} 


See Also 

Reference 

Defining and Using Properties 
Other Resources 

Visual J# Compiler 
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Compiler Error VJS1850 


Error Message 
Modifier modifier is not allowed on delegate. 


The code contains an illegal modifier. 


To correct this error 


e Find and remove the illegal modifier. 


Example 
The following sample generates VJS1850. 


public class Test 


{ 
public strictfp delegate int MyDelegate(); 


i 


See Also 
Other Resources 


Visual J# Compiler 
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Compiler Error VJS1851 


Error Message 
Cannot mark the Value Type type as volatile. 


Fields that are value types cannot be marked as volatile 


To correct this error 


Example 
The following sample generates VJS1851. 


public class Program 


{ 


public static void main(String[] args) 


af 

// 

// TODO: Add code to start application here 
// 

} 


} 


public class Field 


{ 
public static volatile V js_volatilefield_js; // VJS1851 expected 


} 


public final class V extends System.ValueType 
{ 


public int i; 


} 


See Also 
Other Resources 
Visual J# Compiler 
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Compiler Error VJS1852 


Error Message 
Modifier modifier is not allowed on an enum. 


You cannot use the specified modifier with an enum. 
To correct this error 


e Remove or change the modifier type. 


Example 
The following sample generates VJS1852. 


package ConsoleApplication; 


/** 
* Summary description for Program 
i 
public class Program 
{ 
public static void main(String[] args) 
{ 
} 


strictfp enum VJS1852 { 
} 


See Also 

Reference 

User-Defined Enumeration Types (J#) 
Other Resources 

Visual J# Compiler 
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Compiler Error VJS1853 


Error Message 
reference reference has conflicting platform setting of platform. 


The operating system platform flag setting does not match for each compiling application. 
To correct this error 


e Specify the same operating system for each application. For example: /platform:x64 compiles applications for a 64-bit 
operating system. 


Example 
The following sample generates VJS1853, because the Visual J# compiler builds applications with the default of 
/platform: x32. 


VJS1853a.cs 

// compile with: /w:@ /out:VJS1853a.d1l1 /platform:x64 /t:library 
// \V'JS1853 expected 

public class Ref 


{ 
} 


// VIS1853b.js1 
// compile with: /t:library /out:VJS1853b.d11 /r:VIS1853a.d11 


import System.*; 


public class Source 


4 
public static void main(String[] args) { } 
} 
See Also 


Other Resources 
Visual J# Compiler 
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Compiler Error VJS1854 


Error Message 
The argument to the attribute attribute must be a valid identifier. 


To correct this error 


Example 
The following sample generates VJS1854: 


class ref 


/** @attribute System.Diagnostics.ConditionalAttribute("~DEBUG#") */ 
void method1() { } 
} 


See Also 
Other Resources 


Visual J# Compiler 
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Compiler Error VJS1855 


Error Message 
Cannot explicitly instantiate the enumeration enumeration. 


Enum types are implicitly static; consequently, you cannot explicitly instantiate an enum using new. 


To correct this error 


e To refer to the static enum, use the fully qualified name (unless it is accessible from the same scope). 


Example 
The following sample generates VJS1855. 


public enum Color { Red, Green, Blue } 


public class myClass 


{ 
public void Foo() 
{ 
Color c = new Color(); // VJS1855 expected 
} 
} 
See Also 
Reference 


User-Defined Enumeration Types (J#) 
Other Resources 
Visual J# Compiler 
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Compiler Error VJS1856 


Error Message 
The evaluation of the constant value for value involves a circular reference 


Each enum member has an associated constant value. Multiple enum members can share the same associated value. You can 
associate a constant with each enum member at compile-time, so you must ensure that such an association does not create a 
circular reference. Other than this circularity restriction, enum member initializers may freely refer to other enum member 
initializers, regardless of their lexical position. 


To correct this error 


e Correct the constant value creating the circular reference. 


Example 
The following sample generates VJS1856. 


enum Color { 
Red(Green), 
BLUE, 
Green(Red) 


See Also 

Reference 

User-Defined Enumeration Types (J#) 
Other Resources 

Visual J# Compiler 


Compiler Error VJS1857 


Error Message 
Invalid option for /platform; must be x86, x64, Itanium or anycpu. 


The string specified is not valid for use with the /platform compiler option. 


To correct this error 
e Make sure a valid string is passed to the /platform compiler option. Valid choices are as follows: 
e x86 
e x64 
e Itanium 


® anycpu 


See Also 

Other Resources 

Visual J# Compiler 

/platform (Specify Output Platform) (Visual J#) 


Compiler Error VJS1858 


Error Message 
<feature-set> feature-set is supported by Visual J# only on <platform type>-bit platform. Use /platform:< platform type> 
option to generate <platform type>-bit specific binaries for this feature. 


The feature set used is not supported by Visual J# on the current platform target type. 
To correct this error 


e Modify the code to remove the unsupported set of features to compile and execute the application on the 64-bit platform 
natively. 


- or - 
Compile and execute the application as a WoW (or 32-bit) application by using the x86 /platform option. 


The following features are not supported on the 64-bit platform. To compile the code to a 64-bit platform type, change 
the application to use the recommended feature. 





Deprecated Feature Recommended Substitute Feature 





JavaCom support Use .NET COM interoperability instead of COM interop. For more information, see 
Advanced COM Interoperability. 


J/Direct Use .NET Platform Invoke instead of making native calls. For more information, see 


Creating Prototypes in Managed Code. 





J++ delegates Use .NET delegates to author delegates. For more information, see 


Delegates in the Common Type System. 


WFC support Use Windows Forms to write controls. For more information, see 


Getting Started with Windows Forms. 








Java Bytecode to MSIL Converte|No substitute. 
r Jbimp.exe) 


Design-time application develo |No substitute. Compile your application from a command prompt. 
pment 








See Also 
Other Resources 


Visual J# Compiler 
/platform (Specify Output Platform) (Visual J#) 





Compiler Warning VJS1859 


Error Message 
Usage of <feature-set> feature-set is deprecated. Use <feature-set> instead. 


The selected feature is deprecated. Use the recommended features instead. 
To correct this error 


e Toremove this warning, change the application to use the recommended feature-set. 





Deprecated Featur [Recommended Substitute Feature 


WFC support Use Windows Forms to write controls. For more information, see 


Getting Started with Windows Forms. 





See Also 
Other Resources 
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Compiler Error VJS1860 


Error Message 
<option> option is supported by Visual J# only on <platform type>-bit platform. Use /platform: <platform type> option to 
generate <platform type> -bit specific binaries for this option. 


The specified option is supported on only certain platforms. 


To correct this error 


e Use the specified option to generate only specified platform type applications. 


See Also 
Other Resources 


Visual J# Compiler 
/platform (Specify Output Platform) (Visual J#) 


Compiler Warning VJS1861 


Error Message 
Assembly generation — Referenced assembly <reference> targets a different processor. 


The platform setting of the referenced assembly may be incompatible with the target processor of the generated assembly. 
To correct this error 

e No modification is needed. This warning is emitted when cross compiling to a specific platform type. 
See Also 


Other Resources 
Visual J# Compiler 
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Compiler Error VJS2003 


Error Message 
#endif directive expected 


The text editor detected a missing #endif directive. 


The following sample generates VJS2003: 


public class MyClass 


{ 
public static void main() 
#if DEBUG 
// uncomment the following line to resolve 
// #endif 


} 


Visual J# Reference 


Compiler Error VJS2004 


Error Message 
Unexpected preprocessor directive 


The text editor detected an unexpected directive. 


The following sample generates VJS2004: 


public class MyClass 


{ 
public static void main() 
{ 
#endif // no #if 
} 
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Compiler Error VJS2008 


Error Message 
IDE limit exceeded: File cannot exceed number lines 


For the current release, this error is generated if a source code file exceeds 2,097,151 lines. 
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Compiler Error VJS2009 


Error Message 
IDE limit exceeded: Line cannot exceed number characters 


For the current release, this error is generated if a line in a source code file exceeds 2,046 characters. 
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Compiler Error VJS2010 


Error Message 
#endregion directive expected 


A #region directive was found, but no #endregion directive. 


The following sample generates VJS2010: 


#region 

public class MyClass 

{ 
public static void main() 
{ 
} 

ii 

// #endregion 
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Compiler Error VJS2012 


Error Message 
Invalid preprocessor expression 


A preprocessor expression should be of type boolean. 
The following sample generates VJS2012: 

#if 1 // NIS2012 

// try the following line instead 


#if true 
#endif 


Visual J# Reference 


Compiler Error VJS2013 


Error Message 
Filename specified for #line is too long 


When a file name is passed to the #line directive, the file name cannot exceed 260 characters. 
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Compiler Error VJS2015 


Error Message 
Filename, single-line comment, or end-of-line expected 


The parser detected an ill-formed statement. 
The following sample generates VJS2015: 
#line 4 hello 


// try the following line instead 
#line 4 "myfilename" 
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Compiler Error VJS2101 


Error Message 
) expected 


A missing closing parenthesis was detected. 


The following sample generates VJS2101: 


public class MyClass 
{ 
public static void main( 
// try the following line instead 
// public static void main() 
{ 
} 


Visual J# Reference 


Compiler Error VJS2102 


Error Message 
A constant value is expected 


A constant must be passed to a case statement. 


The following sample generates VJS2102: 


public class MyClass 


{ 
public static void main() 
{ 
int i = Q; 
switch (i) 
case : // NIS2102 
// try the following line instead 
// case @: 
default: 
} 
} 
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Compiler Error VJS2103 


Error Message 
} expected 


A missing closing brace was detected. 


The following sample generates VJS2103: 


public class MyClass 

{ 
public static void main() 
{ 


} 
[fy 
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Compiler Error VJS2104 


Error Message 
{ expected 


A missing opening brace was detected. 


The following sample generates VJS2104: 


public class MyClass 
{ 


public static void main() 
fox 
} 
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Compiler Error VJS2105 


Error Message 
; expected 


A missing semicolon (;) was detected. 


The following sample generates VJS2105: 


public class MyClass 


{ 
int i 
} 
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Compiler Error VJS2107 


Error Message 
Syntax error, ‘token’ expected 


A token was expected but not found. 


The following sample generates VJS2107: 


public class MyClass 
{ 
public static void main(String[ args) // VIS2107 
// try the following line instead 
// public static void main(String[] args) 
{ 
} 
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Compiler Error VJS2120 


Error Message 
Identifier expected 


A missing identifier was detected. 


The following sample generates VJS2120: 


public class MyClass 


{ 
int ; 
} 
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Compiler Error VJS2112 


Error Message 
Type or constructor expected 


An ill-formed declaration was detected. 


The following sample generates VJS2112: 


public class MyClass 


public () // VIS2112 
{ 
} 
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Compiler Error VJS2113 


Error Message 
Constructor cannot have a return type 


A constructor cannot have a return type. 


The following sample generates VJS2113: 


public class MyClass 

{ 
public MyClass() [] // VIS2113, remove array notation 
{ 
} 
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Compiler Error VJS2116 


Error Message 
Array initializer expected 


An array declaration was ill-formed. 


The following sample generates VJS2116: 


class Test 


{ 
public static void main(String[] args) 
{ 
intl] x = new int[]; // VIS2116 
// try the following line instead 
int[] x2 = new int[10]; 
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Compiler Error VJS2117 


Error Message 
Array initializer unexpected here 


An array cannot be initialized in the current context. 


The following sample generates VJS2117: 


public class Class1 


{ 

public static void main(String[] args) 

{ 
Classi cl = new Class1(); 
cl.method(new int[2]{}); // \'JS2117 
// try the following line instead 
// cl.method(new int[2]); 

} 
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Compiler Error VJS2118 


Error Message 
Type expected 


This error is raised whenever a type is expected but is not found. 


The following sample generates VJS2118: 


class Test 


{ 
public static void main(String[] args) 
{ 
Test x = new Test(); 
if (x instanceof ) // VIS2118 
// try the following line instead 
// if (x instanceof Test) 
{ 
} 
} 
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Compiler Error VJS2119 


Error Message 
Multicast delegate must have void return type 


A multicast delegate declaration was ill-formed due to return type. 


The following sample generates VJS2119: 


class MyClass 

{ 
public multicast delegate int MyDelegate(); // VIS2119 
// try the following line instead 
public multicast delegate void CorrectDelegate(); 
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Compiler Error VJS2202 


Error Message 
The keyword case or default must precede code in switch block 


The compiler detected an unexpected statement in a switch block. 


The following sample generates VJS2202: 


public class MyClass 


{ 
public static void main() 
{ 
int i = Q; 
switch (i) 
1 // VIJS2202, delete 
case @: 
default: 
} 
} 


Visual J# Reference 


Compiler Error VJS2203 


Error Message 
Only assignment, call, increment, decrement, and new expressions can be used as an expression statement 


A statement was ill-formed. 


The following sample generates VJS2203: 


public class MyClass 


{ 
public static void main() 
{ 
i; // NIS2203 
} 
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Compiler Error VJS2204 


Error Message 
Duplicate 'modifier' modifier 


Duplicate access modifiers are not allowed in a declaration. 


The following sample generates VJS2204: 


public class MyClass 


{ 
public public static void main() // VIS2204, two public modifiers 


7 
} 
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Compiler Error VJS2207 


Error Message 
Can only use array initializer expressions to assign to array types 


An array initialization was attempted on a variable that was not an array type. 


The following sample generates VJS2207: 


public class Class1 
{ 
public static void main(String[] args) 
{ 
int IAmNotAnArray = {1, 2}; // NIS2207 
// try the following line instead 
intl] x = new int[]{1,2}; 
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Compiler Error VJS2208 


Error Message 
Class or interface method must have a return type 


A method declaration did not include a return type. 


The following sample generates VJS2208: 


public class MyClass 

{ 
public static main() // VIS2208 
// try the following line instead 
// public static void main() 
{ 
} 
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Compiler Error VJS2210 


Error Message 
Expected class, interface or delegate 


An invalid token was detected. 


The following sample generates VJS2210: 


// vjs2210a.jsl 
// compile with: /target:library 
int i; // NIS2210 


This could also occur if you include more than one package statement in the same file. 


// VIJS2210b.js1 

// compile with: /target:library 
package MyPackage1; 

public class X {} 


package MyPackage2; // NIS2210 
public class Y {} 


Visual J# Reference 


Compiler Error VJS2211 


Error Message 
Inner classes should not contain interfaces 


An inner class contained an interface, which is not allowed. 


The following sample generates VJS2211: 


public class MyClass 


{ 
class MyInnerClass 
{ 
interface MyInterface // NIS2211 
af 
} 
} 
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Compiler Error VJS2213 


Error Message 
Invalid token ‘token’ in class, or interface member declaration 


An invalid token was detected in a class or interface. 


The following sample generates VJS2213: 


public class MyClass 

{ 
default; // NIJS2213 
public static void main() 


{ 
} 
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Compiler Error VJS2301 


Error Message 
Newline in constant 


A newline character was found in a character or string literal. 


The following sample generates VJS2301: 


class MyClass 
{ 


char s = 

nae 
// try the following line instead 
// char s = 'F'; 
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Compiler Error VJS2302 


Error Message 
Integral constant is outside range for int 


Integral constant cannot be represented as an int. This error will be raised whenever an int constant causes an overflow. 


The following sample generates VJS2302: 


class MyClass 
{ 


} 


int i = 10@@@e@e@0@0000; // VIS2302 
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Compiler Error VJS2303 


Error Message 
Constant is outside range for floating-point value 


Constant cannot be represented as a float. This error will be raised whenever a floating-point constant causes an overflow or 
underflow. 


The following sample generates VJS2303: 


class MyClass 

{ 
float f = 11111111111111111111111111111111111111e+2F; // NIS2303 
// try the following line instead 
// float fF = 3.140e+30Ff; 


public static void main() 
{ 
} 
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Compiler Error VJS2304 


Error Message 
Invalid number 


An invalid number format was detected. 


The following sample generates VJS2304: 


public class Class1 


{ 
public static void main(String[] args) 
{ 
int a = 0x; // NIS2304 
// try the following line instead 
// int a = @xa; 
} 
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Compiler Error VJS2305 


Error Message 
Empty character literal 


A variable of type char was assigned an empty character, which is not allowed. 


The following sample generates VJS2305: 


class MyClass 


{ 
public static void main() 
{ 
char i = "'3 -// VJS2305 
// try the following line instead 
char j = ‘a'; 
} 
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Compiler Error VJS2306 


Error Message 
Too many characters in character literal 


A variable of type char was assigned more than one character, which is not allowed. 


VJS2306 can also occur when doing data binding. For example the following line will give an error: 


<S# DataBinder.Eval (Container.DataItem, 'doctitle') %> 


Try the following line instead: 





<S# DataBinder.Eval (Container.DataItem, "doctitle") %> 


The following sample generates VJS2306: 


class MyClass 


{ 
public static void main() 
{ 
char i = ‘ab'; // VIS2306 
// try the following line instead 
char j = ‘a'; 
} 
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Compiler Error VJS2307 


Error Message 
Unrecognized escape sequence 


A character was ill-formed. 


The following sample generates VJS2307: 


class MyClass 

{ 
char s "\8'; // NIJS2307, not a valid octal char 
char c = '\7';  // OK 
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Compiler Error VJS2308 


Error Message 
Constant is outside range for double value 


Constant cannot be represented as a double. This error will be raised whenever a double constant causes an overflow or 
underflow. 


The following sample generates VJS2308: 


public class Class1 
{ 


public static void main(String[] args) 


double d = 4e3045d; // \VJS2308, try a smaller value 
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Compiler Error VJS2309 


Error Message 
Integral constant is outside range for long 


Integral constant cannot be represented as a long. This error will be raised whenever a long causes an overflow. 


The following sample generates VJS2309: 


class MyClass 
{ 


} 


long s = 10@@e@eeeGeGeeGeG0R000000000L; // VIS2309 
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Compiler Error VJS2401 


Error Message 
Interface cannot be final 


An interface definition had the final access modifier, which is not allowed. 
The following sample generates VJS2401: 
final interface MyInterface // NIS2401 


{ 
} 
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Compiler Error VJS2402 


Error Message 
Modifier ‘modifier’ is not allowed for a class 


A modifier was used on a class declaration, but the modifier was not designed for a class declaration. 


The following sample generates VJS2402: 


volatile class MyClass // NIS2402 


{ 
} 
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Compiler Error VJS2403 


Error Message 
Modifier ‘modifier’ is not allowed for an interface 


A modifier was incorrectly used on an interface declaration. 


The following sample generates VJS2403: 


volatile interface inter1 // NIS24@3 


{ 
} 
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Compiler Error VJS2404 


Error Message 
Modifier ‘modifier’ is not allowed for a delegate 


A modifier was incorrectly applied to a delegate declaration. 


The following sample generates VJS2404: 


volatile delegate void Del(); // VIS2404 
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Compiler Error VJS2405 


Error Message 
Static class cannot be defined in an inner class 


A static inner class cannot be defined when the enclosing class is not static. 


The following sample generates VJS2405: 


class Classi 


{ 
class InnerClass // not static 
{ 
static class InnnerMostClass // NIS2405 
{ 
} 
} 
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Compiler Error VJS2406 


Error Message 
Modifier ‘modifier’ is not allowed for a local class 


A modifier was incorrectly used on a local, or inner, class declaration. 


The following sample generates VJS2406: 


class Classi 


{ 
public static void main(String[] args) 
{ 
abstract static class LocalClass // VIS24@6, static not allowed here 
{ 
} 
} 
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Compiler Error VJS2407 


Error Message 
Modifier ‘modifier’ is not allowed for a constructor 


A modifier (modifier) was incorrectly applied to a constructor. 


The following sample generates VJS2407: 


class Classi 

{ 
static public Classi() // VIS2407, static not allowed here 
{ 
} 
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Compiler Error VJS2408 


Error Message 
Modifier ‘modifier’ is not allowed for a method 


A modifier (modifier) was incorrectly applied to a method declaration. 


The following sample generates VJS2408: 


class Classi 

{ 
public volatile static void main(String[] args) 
{ 
} 


// VIS2408, volatile not allowed here 
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Compiler Error VJS2409 


Error Message 
Modifier ‘modifier’ is not allowed for a field 


A modifier (modifier) was incorrectly applied to a field declaration. 


The following sample generates VJS2409: 


class Classi 


{ 
synchronized int FieldCantBeSync; // NIS2409 
} 
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Compiler Error VJS2410 


Error Message 
Cannot have both 'modifier1' and 'modifier2' modifiers 


A modifier (modifier7) was incorrectly applied along with another modifier. Remove the conflicting modifier. 


The following sample generates VJS2410: 


// vjs2410.jsl 

// compile with: /target:library 

public abstract final class Class1 // NIS2410 
{ 

} 
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Compiler Error VJS2411 


Error Message 
Modifier ‘modifier’ is not allowed for a method of an interface 


A modifier (modifier) was incorrectly applied to a method declaration in an interface. 


The following sample generates VJS2411: 


interface inter1 


{ 
final void method(); // VIS2411 
} 
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Compiler Error VJS2413 


Error Message 
Modifier ‘modifier’ is not allowed for a field of an interface 


A modifier (modifier) was incorrectly applied to a field declaration in an interface. 


The following sample generates VJS2413: 


interface inter1 


{ 
volatile int a; // \'IS2413 
} 
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Compiler Error VJS2414 


Error Message 
Cannot have both 'modifier1' and 'modifier2' modifiers 


Two mutually exclusive modifiers were applied to the same declaration. 


The following sample generates VJS2414: 


class Classi 


i 
} 


final volatile int a; // NIS2414 
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Compiler Error VJS2416 


Error Message 
Outer class cannot have ‘modifier’ modifier 


A modifier (modifier)was incorrectly applied to the declaration of an outer class. 


The following sample generates VJS2416: 


protected class MyClass // NIS2416 
{ 


public static void main() 
{ 
} 
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Compiler Error VJS2417 


Error Message 
Outer interface cannot have 'modifier' modifier 


A modifier (modifier) was incorrectly applied to the declaration of an outer interface. 
The following sample generates VJS2417: 
private interface inter // VJS2417 


A 
} 
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Compiler Error VJS2501 


Error Message 
The type ‘type’ must have a public parameterless constructor in order to use it as parameter ‘parameter’ in the generic type or 
method ‘method’ 


You have tried to use the specified type as a parameter in the generic type or method, but the type's constructor is either not 
public, or it has parameters. 


To correct this error 


1. Locate the method or generic type where you have used the specified type as a parameter. 


2. Change the parameter to a public constructor of the type, or make sure the constructor has no parameters before you 
use it as a parameter. 


Example 
The following sample generates VJS2501. 


// NIS2501.cs 

// compile with: /target:library 

using System; 

public class MyClass{} 

public class Gen<G> where G:MyClass, new() 


{ 
public G method<U>(int a) 
G t=default(G); 
return t; 
} 
} 
public class MyClassExt 
{ 
public void methi<T, U, V> (T t, Uu, Vv) {} 
public void methi<T, U> ( T t, Uu, inti ) {} 
public void methi<T, U> ( T t, Uu,long i ) {} 
} 
public class Gen2<T,U> 
{ 
public static int val = @; 
public Gen2() 
val ++; 
} 
} 


public class Gen3<T> where T:class {} 
public class Gen4<T> where T:struct {} 


// VIS2501_b.jsl 
// compile with: /reference:VJS2501.d11 
public class MyClassext extends MyClass 


{ 
} 


private MyClassext() {} 


public class jsTest 
{ 


public static void main() 


{ 
Gen<MyClassext> mygen = new Gen<MyClassext>(); // NVJS2501 expected 


pe 


See Also 
Other Resources 


Visual J# Compiler 
Generics Samples (Consuming Generics) 
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Compiler Error VJS2502 


Error Message 
The type type1 must be convertible to type2 in order to use it as parameter parameter in the generic type or method method. 


The type you are using as a parameter is not convertible to the type needed as a parameter for the specified method. 


To correct this error 


e Make sure that the type you are using as a parameter can be converted to the type used in the specified method. 


Example 
The following sample generates VJS2502. 


// VIS2502.cs 

// compile with: /target:library 

using System; 

public class MyClass{} 

public class Gen<G> where G:MyClass, new() 


{ 
public G method<U>(int a) 


G t=default(G); 
return t; 


} 


public class MyClassExt 

{ 
public void methi<T, U, V> (T t, Uu, V v){} 
public void methi<T, U> ( T t, Uu, int i ){} 
public void meth1i<T, U> ( T t, U u,long i ){} 


public class Gen2<T,U> 
1 


public static int val = @; 
public Gen2() 


val ++; 


} 


public class Gen3<T> where T:class {} 
public class Gen4<T> where T:struct{} 


// NIS2502.js1 
// compile with: /reference:VJS2502.d11 
public class jsTest 


if 
public static void main() 
{ 
Gen<int> mygen = new Gen<int>(); // VIS2502 
} 
} 
See Also 


Other Resources 
Visual J# Compiler 
Generics Samples (Consuming Generics) 
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Compiler Error VJS2504 


Error Message 
Keyword keyword cannot be used in this context 


You have used the specified keyword incorrectly. 


Example 


// NIS2504.cs 

// compile with: /target:library 

public class MyClass{} 

public class Gen<G> where G:MyClass, new() 


if 
public G method<U>(int a) 
{ 
G t=default(G); 
return t; 
} 
public class MyClassExt 
{ 
public void methi<T, U, V> (T t, Uu, Vv) {} 
public void methi<T, U> ( T t, Uu, inti ) {} 
public void methi<T, U> ( T t, Uu,long i ) {} 
} 
public class Gen2<T,U> 
{ 
public static int val = @; 
public Gen2() 
val ++; 
} 
; 


public class Gen3<T> where T:class {} 
public class Gen4<T> where T:struct {} 


The following sample generates VJS2504. 


// NIS2504.js1 
// compile with: /reference:VJS2504.d11 
public class MyClassext extends MyClass 


{ 
} 


private MyClassext(){} 


public class jsTest 


public static void main() 


{ 
Gen<void> mygen = new Genx<void>(); // VIJS2504 expected 
} 
See Also 


Other Resources 
Visual J# Compiler 
Generics Samples (Consuming Generics) 
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Compiler Error VJS2505 


Error Message 
The type ‘type’ may not be used as a type argument. 


You have specified a type that cannot be used as a type argument. 


To correct this error 
e Use a native type instead. For example int. 


Example 


// VIS2505.cs 
// compile with: /target:library 
public class MyClass {} 


public class Gen<G> where G : 


MyClass, new() 


{ 
public G method<U>(int a) 
uf 
G t = default(G); 
return t; 
} 
} 
public class MyClassExt 
{ 
public void methi<T, U, V>(T t, Uu, Vv) {} 
public void methi<T, U>(T t, Uu, int i) {} 
public void methi<T, U>(T t, Uu, long i) {} 
} 
public class Gen2<T, U> 
{ 
public static int val = @; 
public Gen2() 
{ 
val++; 
} 
} 
public class Gen3<T> where T : class {} 
public class Gen4<T> where T : struct {} 


The following sample generates VJS2505. 


// VIS2505_b.jsl 
// compile with: /reference:VJS25@5.d11 
import System.*; 
public class MyClassext extends MyClass 


i 
private MyClassext() {} 


} 

public class jsTest 

: public static void main() 
: Gen<RuntimeArgumentHandle> mygen = 
} 


new Gen<RuntimeArgumentHandle>(); 


// NIS2505 


See Also 
Other Resources 
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Generics Samples (Consuming Generics) 
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Compiler Error VJS2506 


Error Message 
Cannot use generics when .NET language extensions are disabled. 


Generics require .NET language extensions. 


To correct this error 


e Enable .NET extensions before attempting to compile a project using generics. 


Example 
The following sample generates VJS2506. 


// NIS2506.js1 

// compile with: /t:1 /x:net 

package ConsoleApplication; 

//import System.Collections.Generic.*; 
public class Program 


{ 


public static void main(String[] args) 
public class VJS25@6 


{ 
public Stack<int> mystack = new Stack<int>(); 
// N'JIS2506 expected 


} 


See Also 
Other Resources 


Visual J# Compiler 
Generics Samples (Consuming Generics) 
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Compiler Error VJS2508 


Error Message 
Inconsistent accessibility: cannot access type type or one of its type arguments. 


The specified type can't be accessed. 


To correct this error 


e Check to make sure that the type you are trying to access isn't private or restricted in some other way. 


Example 
The following sample generates VJS2508. 


// NVIS2508.cs 

// compile with: /target:library 

using System; 

public class MyClass{} 

public class Gen<G> where G:MyClass, new() 


{ 
public G method<U>(int a) 


G t=default(G); 
return t; 


} 


public class MyClassExt 

i! 
public void methi<T, U, V> (T t, Uu, V v){} 
public void methi<T, U> ( T t, Uu, int i ){} 
public void meth1i<T, U> ( T t, U u,long i ){} 


public class Gen2<T,U> 

{ 
public static int val = @; 
public Gen2() 


val ++; 


} 


public class Gen3<T> where T:class {} 
public class Gen4<T> where T:struct{} 


// VIS2508_b.jsl 

// compile with: /reference:VJS2508.d11 
import System.*; 

import java.util.Date; 

import System.Collections.Generic.*; 


public class jScope 
{ 
public Stack<int> mystack; 
public class CPub1 {} 
public class CPub2 {} 
private class CPril{} 
protected class CProtif{} 
//public types 
public Gen2<CPub1,CPub2> pubfld1; 
public Gen2<CPub1,CPub2> pubfld2; 
//One type protected 
public Gen2<CProt1, CPub1> protfl1d1; 
//Private type 
public Gen2<CPri1,CPub1> prifld1; 


//Private type 
public Gen2<CPri1,CPub1> getPri() 


{ 


} 
//One type protected 


public Gen2<CProt1, CPub1> getProt() 
{ 


} 
//public types 
public Gen2<CPub1,CPub2> getPub() 


{ 
return new Gen2<CPub1,CPub2> (); 
// NJS2508 expected 
} 


return new Gen2<CPrii1,CPub1>(); 


return new Gen2<CProt1, CPub1>(); 


} 











See Also 
Other Resources 


Visual J# Compiler 
Generics Samples (Consuming Generics) 


Visual J# Reference 


Compiler Error VJS2509 


Error Message 
The type type must be a reference type in order to use it as parameter parameter in the generic type or method method. 


The parameter specified in the generic type or method is not a reference type. 
To correct this error 


e Check the specified type to see if you can change it to a reference type. 


Example 


// VIS2509.cs 

// compile with: /target:library 

public class MyClass {} 

public class Gen<G> where G:MyClass, new() 


{ 
public G method<U>(int a) 
{ 
G t=default(G); 
return t; 
} 
public class MyClassExt 
{ 
public void methi<T, U, V> (T t, Uu, Vv) {} 
public void methi<T, U> ( T t, Uu, inti ) {} 
public void methi<T, U> ( T t, U u,long i ) {} 
} 


public class Gen2<T,U> 


public static int val = @; 
public Gen2() 
{ 
val ++; 
i 
} 


public class Gen3<T> where T:class {} 
public class Gen4<T> where T:struct {} 


// VIS2509_b.jsl 
// compile with: /reference:VJS2509.d11 
public class jsTest 


{ 
public static void main() 
{ 
Gen3<int> mygen = new Gen3<int>(); // VSI2509 
} 
} 
See Also 


Other Resources 
Visual J# Compiler 
Generics Samples (Consuming Generics) 
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Compiler Error VJS2510 


Error Message 
The type type must be a value type in order to use it as parameter parameter in the generic type or method method. 


The parameter in the specified method must be a value type. 


Example 
The following example generates VJS2510. 


// NIS2510.cs 

// compile with: /target:library 
using System; 

public class MyClass {} 


public class Gen<G> where G:MyClass, new() 


{ 
public G method<U>(int a) 
G t=default(G); 
return t; 
} 
} 
public class MyClassExt 
{ 
public void methi<T, U, V> (T t, Uu, Vv) {} 
public void methi<T, U> ( T t, Uu, inti ) {} 
public void methi<T, U> ( T t, Uu,long i ) {} 
} 
public class Gen2<T,U> 
{ 
public static int val = @; 
public Gen2() 
val ++; 
} 
} 


public class Gen3<T> where T:class {} 
public class Gen4<T> where T:struct {} 


// VIS2510_b.jsl 

// compile with: /reference:VJS251@.d11 
import java.util.*; 

public class jsTest 


{ 
public static void main() 
{ 
Gen4<int> mygen = new Gen4<int>(); 
Gen4<Stack> nonVal = new Gen4<Stack>(); // VSI1251® expected 
} 
i 
See Also 


Other Resources 
Visual J# Compiler 
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Visual J# Reference 


Compiler Error VJS2701 


Error Message 
The assembly assembly, Version=version, Culture=culture, PublickeyToken=publickeytoken not found 


The specified assembly, referred by one of the files in metadata, was missing. This problem is probably either due to a build 
error or the assemblies not building in the correct order. 


To correct this error 


1. Ensure that each assembly builds to the correct DLL or EXE name. 


2. Verify and correct the order of the build and dependencies in your makefile or within Visual Studio. 


Example 
Before compiling these examples, generate a keyfile called VJS2701_key.snk. For more information, see 
/keyfile (Specify Cryptographic Key Filename). 


The following examples generate VJS2701. 


// vjs2701_1.js1 
// compile with: /target:library /keyfile:VJS2701_key.snk /out:VJS2701a.d11 
/** @assembly System.Reflection.AssemblyVersion("1.0.0.0")*/ 
/** @assembly System.Reflection.AssemblyCulture("de")*/ 
public class B { 
public int myAdd(int i, int j) 
t 


} 


return i+ j; 


// VjS2701_2.js1 
// compile with: /target:library /reference:VJS27@1a.d1ll /keyfile:VIJS2701_key.snk /out:VIS2 
701b.d11 
public class D { 
public static B getB() 


{ 
} 


return new B(); 


// vjS2701_3.js1 
// compile with: /target:library /keyfile:VIJS2701_key.snk /out:VJS2701a.d11 


// Notice that the compile comment builds to the wrong DLL name. 
// Should build to VJS2701a2.d11. 
/** @assembly System.Reflection.AssemblyVersion("1.0.0.0")*/ 
/** @assembly System.Reflection.AssemblyCulture("en-us")*/ 
public class B { 

public int myAdd(int i, int j) 

{ 


} 


return i+ j; 


// vjs2701_4.js1 
// compile with: /target:library /reference:VJS27@1a.d1l /reference:VJS2701b.d1l /keyfile:V 
JS2701_key.snk /out:VJS2701c.d11 
// N'JS2701 expected 
public class Test { 
public static void main() { 


new D(); 
2 = d.getB(); 





See Also 
Other Resources 
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Compiler Error VJS2702 


Error Message 
Found assembly assembly1 has lower version than required assembly assembly2. 


The assembly version numbers do not match between assembly7 and assembly2. 
To correct this error 


1. Update the AssemblyVersion attribute so all related assemblies have the same version number. For example: 
/**@assembly System.Reflection.AssemblyVersion ("2.2.2.2") */. 


2. Recompile all assemblies. 


Example 
Before compiling this example, generate a keyfile called VJS2702_key.snk. See 


/keyfile (Specify Cryptographic Key Filename) for more information. 


The following sample generates VJS2702. 


// VjS2702a2.j51 
// compile with: /t:library /keyfile:VJS27@2_key.snk /out:VJS27@2a.d11 
/**@assembly System.Reflection.AssemblyVersion("2.2.2.2")*/ 
/**@assembly System.Reflection.AssemblyCultureAttribute("de")*/ 
public class B { 
//myAdd() of v1 returns 'i + j + 1' and myAdd of V2 returns 'i + j + 2' 
public int myAdd(int i, int j) f{ 
return i+ j + 2; 


} 


// “jS2702b.js1 
// compile with: /t:library /r:VIJS27@2a.d1l /keyfile:VJS2702_key.snk /out:VJS2702b.d11 
public class D { 
public B getB() { 
return new B(); 


} 


// vjS2702a1.jsl 
// compile with: /t:library /keyfile:VJS27@2_ key.snk /out:VJS27@2a.d11 
/**@assembly System.Reflection.AssemblyVersion("2.1.2.2")*/ 
/**@assembly System.Reflection.AssemblyCultureAttribute("de")*/ 
public class B { 
//myAdd() of v1 returns 'i + j + 1' and myAdd of V2 returns 'i + j + 2' 
public int myAdd(int i, int j) f{ 
return i+ j +1; 


} 


// “jS2702c.js1 
// compile with: /t:library /r:VIJS27@2a.d11 /r:VJS2702b.d11 /keyfile:VIJS2702_key.snk /out:V 
JS2702c.d11 
public class Test { 
public static void main() { 

B b2; 

Dd = new D(); 

b2 = d.getB(); 

//int ret = b2.myAdd(12, 14); 





See Also 
Other Resources 
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Visual J# Class Library 


The J# Class Libraries is Microsoft's implementation of the JDK 1.1.4 specification. Most classes implement functionality that is 
subset or equivalent to JDK1.1.4 whereas some implement functionality that is subset or equivalent to 1.2. Visual J# 2005 also 
supports many of the Microsoft Extensions defined in Visual J++ 6.0, such as com.ms.lang.Delegate. For a complete list of 
which features are supported, see Supported Class Libraries. For a list of the features that Visual J# does not support, see 
Unsupported Class Libraries and Features. 


The J# Class Libraries are built on top of the NET Framework. The root class of the J# Class Libraries, java.lang.Object, is 
derived from Object. This means that all J# objects can be used where a .NET object is expected, and vice versa. For example, a 
java.lang.String can be inserted into an ArrayList. Conversely, a String can be inserted into a Vector class. For more information 
on the relationship between Visual J# and the .NET Framework, see Visual J# Architecture. 


For Visual J# 2005, most packages defined by the Java 1.1.4 specification are supported, but only the most important classes in 
the following packages are documented at this time: 


® java.io J#) 
e javalang 


@ java.lang.Class 


java.lang.Object 


java.lang.reflect 


e java.lang.String 


java.lang.Thread 


@ java.lang.ThreadGroup 


java.security.acl 


® javasq| 


java.text 


© java.util 





Note 





The Java JDK 1.1.4 classes are enabled for native 64-bit execution by using Visual J#. Install Microsoft Visual J#® 2.0 Re 
distributable Package — Second Edition. 








See Also 
Other Resources 
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java.io (J#) 


Contains classes used for data input and output. 


Classes 
Class 


BufferedinputStream 


Description 


Used to hold data from an input stream. The member methods read data from the buffer. 





BufferedOutputStream |Stores the data to be written into a buffer. The data is actually written when the buffer is full or when 
you empty the buffer by calling the flush method. 

BufferedReader Provides an implementation of the abstract Reader class that buffers character data from another rea 
der. 

BufferedWriter Provides an implementation of the abstract Writer class that buffers character data to another writer. 





ByteArraylnputStream 


ByteArrayOutputStream 


Contains an internal buffer that stores the bytes read from the input stream. By using a counter, it kee 
ps track of the next byte to be read. 


Extends the OutputStream class in which the data is written into a byte array. It contains a buffer that 
automatically grows as data is written to it. It also contains methods to retrieve and convert data. 














CharArrayReader Provides an implementation of the abstract Reader class specific to reading arrays of characters. 

CharArrayWriter Provides an implementation of the abstract Writer class specific to writing into an array of characters. 
The array can be used to retrieve the written character data as a character array or a string or to write 
the character buffer to another instance of a Writer object. 

EOFException The exception that is thrown when an attempt is made to read past the end of a file. 

File Contains methods to access, create, or edit files and folders on disk. 





FileNotFoundException 


The exception that is thrown when an attempt is made to access a file that does not exist. 











InterruptedIOException 


FileReader Provides an implementation of the abstract Reader class used to provide a character stream for files. 
FileWriter Provides an implementation of the abstract Writer class specific to writing files. 
InputStreamReader Provides an implementation of the abstract Reader class specific to reading characters in an 


InputStream object. 


The exception that is thrown when a timeout has occurred or there was an interruption during an I/O 
operation. 





InvalidClassException 


The exception that is thrown when an attempt is made to serialize or deserialize an instance of a class 
that does not support serialization. 





InvalidObjectException 


The exception that is thrown when an error occurs during deserialization of an object. 





IOException 





The exception that is thrown when a generic I/O error has occurred. This class represents the base cla 
ss for most of the exceptions in the java.io package. 











LineNumberReader 


OutputStreamWriter 


Provides an implementation of the abstract Reader class that counts the number of lines in a stream o 
f data. 


Provides an implementation of the abstract Writer class specific to writing characters to an 
OutputStream object. 





PipedReader 


Provides an implementation of the abstract Reader class specific to reading characters from a 
PipedWriter object. 





PipedWriter Provides an implementation of the abstract Writer class specific to writing characters to a PipedWriter 
object. 

PrintWriter Provides an implementation of the abstract Writer class specific to printing various primitive types an 
d other objects to an underlying output stream. 

PushbackReader Provides an implementation of the abstract Reader class that buffers data from another stream. The i 


nternal buffer is initially filled with the contents read in from the underlying stream. Characters in this 
internal buffer can then be "pushed back", or replaced with other characters at the position marked. 





RandomAccessFile 


Represents a file used to store data that can be accessed in a non-sequential manner. 





Reader 


An abstract class representing the base for all character readers in the java.io package. 





StringReader 


Provides an implementation of the abstract Reader class used to read characters from a given string. 








StringWriter 


Writer 





Provides an implementation of the abstract Writer class used to write characters into a StringBuffer o 
bject that can be resized as required. 


An abstract class representing the base for all character writers in the java.io package. 
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BufferedinputStream Class 


Used to hold data from an input stream. The member methods read data from the buffer. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public class java.io.BufferedInputStream 
extends java.io.FilterInputStream 





Inheritance Hierarchy 
java.lang.Object 
java.io.InputStream 
java.io.FilterInputStream 
java.io.BufferedinputStream 


See Also 

Concepts 

BufferedinputStream Members 
java.io 
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BufferedinputStream Members 


Used to hold data from an input stream. The member methods read data from the buffer. 


The following tables list the members exposed by the BufferedinputStream type. 


Public Constructors 





Name Description 





BufferedinputStream Overloaded. 





Public Fields 

















Name Description 

buf Stores the array of bytes read from the input stream. 
count Stores the number of bytes that have been read. 

in (inherited from FilterInputStream ) 

marklimit Stores the maximum number of bytes that can be marked. 
markpos Stores the position of the marked byte. 

pos Stores the position of the last read byte. 








Public Methods 








Name Description 

available Overridden. Returns the available number of bytes that can be read from the input stream without being bloc 
ked. 

close Overridden. Closes the input buffer. 

equals (inherited from Object ) 





hashCode (inherited from Object ) 





getClass (inherited from Object ) 





mark Overridden. Marks the current position of the byte read so far in the input buffer. 





markSupported/Overridden. Checks if fc2bb7b1-e8ab-44ca-a9a1-362d98852478 and 
bde7d3cb-ef57-4231-9a8d-4578236481e1 are supported. 








clone (inherited from InputStream ) 
read Overloaded. Overridden. 
reset Overridden. Repositions the mark created by fc2bb7b1-e8ab-44ca-a9a1 -362d98852478 to its last position w 


hen mark() was last called. 


skip Overridden. Skips reading a specific number of bytes. 














toString (inherited from InputStream ) 








Protected Methods 
Name 


finalize (inherited from Object ) 








See Also 

Reference 
BufferedinputStream Class 
Concepts 

java.io Package 
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BufferedinputStream Fields 


Public Fields 


























Name Description 

buf Stores the array of bytes read from the input stream. 
count Stores the number of bytes that have been read. 

in (inherited from FilterInputStream) 

marklimit Stores the maximum number of bytes that can be marked. 
markpos Stores the position of the marked byte. 

pos Stores the position of the last read byte. 

See Also 

Reference 

BufferedinputStream Class 

Concepts 


java.io Package 
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BufferedInputStream.buf Field 


Stores the array of bytes read from the input stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





protected byte[] buf; 





See Also 

Reference 
BufferedinputStream Class 
Concepts 

BufferedinputStream Members 
java.io Package 
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BufferedInputStream.count Field 


Stores the number of bytes that have been read. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected int count; 


See Also 

Reference 
BufferedinputStream Class 
Concepts 

BufferedinputStream Members 
java.io Package 
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BufferedInputStream.marklimit Field 


Stores the maximum number of bytes that can be marked. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected int marklimit; 


See Also 

Reference 
BufferedinputStream Class 
Concepts 

BufferedinputStream Members 
java.io Package 
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BufferedinputStream.markpos Field 


Stores the position of the marked byte. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected int markpos; 


See Also 

Reference 
BufferedinputStream Class 
Concepts 

BufferedinputStream Members 
java.io Package 
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BufferedInputStream.pos Field 


Stores the position of the last read byte. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





protected int pos; 





See Also 

Reference 
BufferedinputStream Class 
Concepts 

BufferedinputStream Members 
java.io Package 
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BufferedinputStream Constructor 


Overload List 
Name Description 








BufferedinputStream (InputStream) — |Constructs a repository to read data from a specific stream using the default buffer siz 
e (2K). 






BufferedinputStream (InputStream, int)|Constructs a repository to read data from a specific stream using a specific buffer size. 





See Also 

Reference 
BufferedinputStream Class 
Concepts 

BufferedinputStream Members 
java.io Package 
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BufferedInputStream Constructor (InputStream) 


Constructs a repository to read data from a specific stream using the default buffer size (2K). 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.BufferedInputStream( 
java.io.InputStream in); 


Parameters 
in 


The input stream. 
Example 


// Read the file name as a program argument: 
File f = new File(args[@]); 


// Construct an input stream using the file "f": 
FileInputStream fin = new FileInputStream(F); 


// Construct the buffer using the stream "fin": 
BufferedInputStream bin = new BufferedInputStream(fin) ; 


See Also 

Reference 
BufferedinputStream Class 
Concepts 

BufferedinputStream Members 
java.io Package 
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BufferedInputStream Constructor (InputStream, Int32) 


Constructs a repository to read data from a specific stream using a specific buffer size. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.BufferedInputStream( 
java.io.InputStream in, 
int size); 


Parameters 
in 

The specified input stream. 
size 

The size of the buffer. 
See Also 
Reference 
BufferedinputStream Class 
Concepts 


BufferedinputStream Members 
java.io Package 
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BufferedinputStream Methods 


Public Methods 
































Name Description 

available Overridden. Returns the available number of bytes that can be read from the input stream without being bloc 
ked. 

close Overridden. Closes the input buffer. 

equals (inherited from Object ) 

hashCode (inherited from Object ) 

getClass (inherited from Object ) 

mark Overridden. Marks the current position of the byte read so far in the input buffer. 

markSupported/Overridden. Checks if fc2bb7b1-e8ab-44ca-a9a1-362d98852478 and 
bde7d3cb-ef57-4231-9a8d-4578236481e1 are supported. 

clone (inherited from InputStream ) 

read Overloaded. Overridden. 

reset Overridden. Repositions the mark created by fc2bb7b1-e8ab-44ca-a9a1 -362d98852478 to its last position w 
hen mark() was last called. 

skip Overridden. Skips reading a specific number of bytes. 

toString (inherited from InputStream ) 

Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 


BufferedinputStream Class 


Concepts 
java.io Package 
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BufferedinputStream.available Method 


Returns the available number of bytes that can be read from the input stream without being blocked. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized int available() throws java.io. IOException; 


Return Value 
The number of bytes that can be read from the input stream without being blocked. 


See Also 

Reference 
BufferedinputStream Class 
Concepts 

BufferedinputStream Members 
java.io Package 
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BufferedInputStream.close Method 


Closes the input buffer. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized void close() throws java.io. IOException; 


See Also 

Reference 
BufferedinputStream Class 
Concepts 

BufferedinputStream Members 
java.io Package 
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BufferedinputStream.mark Method 


Marks the current position of the byte read so far in the input buffer. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized void mark( 
int readLimit); 


Parameters 
readLimit 


The number of bytes to be read before changing the mark position. 


See Also 

Reference 
BufferedinputStream Class 
Concepts 

BufferedinputStream Members 
java.io Package 
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BufferedInputStream.markSupported Method 


Checks if fc2bb7b1-e8ab-44ca-a9a1 -362d98852478 and bde7d3cb-ef57-4231-9a8d-4578236481e1 are supported. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public boolean markSupported(); 





Return Value 
true if mark() and reset() are supported; false otherwise. 


See Also 

Reference 
BufferedinputStream Class 
Concepts 

BufferedinputStream Members 
java.io Package 
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BufferedinputStream.read Method 


Overload List 
Name Description 








BufferedinputStream.read () Reads the next byte of data from the buffered input stream. If the end of the stream 
has been reached, it returns -1. 


BufferedinputStream.read (byte[]) 


BufferedinputStream.read (byte{], int, int)|Reads up to the number of bytes of data stipulated by len from the buffered input str 
eam into an array of bytes. 














See Also 

Reference 
BufferedinputStream Class 
Concepts 

BufferedinputStream Members 
java.io Package 
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BufferedInputStream.read Method () 


Reads the next byte of data from the buffered input stream. If the end of the stream has been reached, it returns -1. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized int read() throws java.io. IOException; 


Return Value 
The actual number of bytes that have been read. 
Example 


The following example reads the file specified as an argument. For example, if the code example is called "readfile," you can 
read a file named "my-filename.txt," by invoking the program like this: 


> readfile my-filename.txt. 


The read file will be displayed on the screen. 


// BIS-Readfile1.jsl 
// BufferedInputStream.read example 


import java.io.*; 


public class myClass 


{ 


public static void main(String [] args) 


{ 
try 


{ 
// Accept the name of the input file from the keyboard 


// as an argument: 
File f = new File(args[@]); 


// Declare and initialize the input stream: 
FileInputStream fin = new FileInputStream(F); 


// Declare and initialize the input buffer: 
BufferedInputStream bin = new BufferedInputStream(Ffin) ; 


// Read from the buffer one character at a time: 
int c = Q; 
while ((c = bin.read()) >= 0) 


// Display the read character: 
System.out.print((char) c); 
} 


// Close the buffer: 
bin.close(); 


catch (IOException e) 


// Do nothing. 


Remarks 


This method is blocked until input data is available, the end of the stream is detected, or an exception is thrown. 


This method can throw java.io.IOException. 


See Also 

Reference 
BufferedinputStream Class 
Concepts 

BufferedinputStream Members 
java.io Package 


Visual J# Reference 


BufferedInputStream.read Method (SByte[], Int32, Int32) 


Reads up to the number of bytes of data stipulated by len from the buffered input stream into an array of bytes. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized int read( 
byte[] b, 
int off, 
int len) throws java.io.IOException; 


Parameters 


b 
Buffer into which the data is read. 
off 
The offset that indicates the starting point of the data. 
len 
Number of bytes to read. 
Return Value 
The actual number of bytes read. 
Example 


The following example reads the file specified as an argument. For example, if the code example is called "readfile," you can 
read a file named "my-filename.txt," by invoking the program like this: 


> readfile my-filename.txt. 


// BIS-Readfile2.jsl 
// Reading from a buffered stream 


import java.io.*; 


public class myClass 


{ 
public static void main(String [] args) 
{ 
try 
{ 


// Accept the name of the input file from the keyboard 
// aS a program argument: 
File f = new File(args[@]); 


// Declare and initialize the input stream: 
FileInputStream fin = new FileInputStream(F) ; 


// Declare and initialize the input buffer: 
BufferedInputStream bin = new BufferedInputStream(Ffin) ; 


int c = @; 


// Declare the buffer and initialize its size: 
byte[] b = new byte[1024]; 


// Read from the buffer one character at a time: 
while ((c = bin.read(b, 0, b.length)) >= @) 
{ 


for (int i = @3; i < c; i++) 

{ 

// Display the read byte: 
System.out.print((char)b[i]); 


} 
} 


// Close the buffer: 
bin.close(); 





} 
catch (IOException e) 
{ 
// Do nothing. 
} 
} 
} 
Remarks 


If no byte is available because the end of the stream has been reached, it returns -1. 
Can throw java.io.IOException and 997bf792-c774-4384-8045-19bacbOcb4ad. 


See Also 

Reference 
BufferedinputStream Class 
Concepts 

BufferedinputStream Members 
java.io Package 
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BufferedInputStream.reset Method 


Repositions the mark created by fc2bb7b1 -e8ab-44ca-a9a1-362d98852478 to its last position when 
fc2bb7b1-e8ab-44ca-a9al -362d98852478 was last called. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized void reset() throws java.io. IOException; 








See Also 

Reference 
BufferedinputStream Class 
Concepts 

BufferedinputStream Members 
java.io Package 
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BufferedinputStream.skip Method 


Skips reading a specific number of bytes. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized long skip( 
long n) throws java.io.IOException; 


Parameters 
n 


The number of bytes to skip. 
Return Value 
The actual number of skipped bytes. 


See Also 

Reference 
BufferedinputStream Class 
Concepts 

BufferedinputStream Members 
java.io Package 
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BufferedOutputStream Class 


Stores the data to be written into a buffer. The data is actually written when the buffer is full or when you empty the buffer by 
calling the flush method. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.BufferedOutputStream 
extends java.io.FilterOutputStream 





Inheritance Hierarchy 
java.lang.Object 
java.io.OutputStream 
java.io.FilterOutputStream 
java.io.BufferedOutputStream 


See Also 

Concepts 

BufferedOutputStream Members 
java.io Package 
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BufferedOutputStream Members 


Stores the data to be written into a buffer. The data is actually written when the buffer is full or when you empty the buffer by 
calling the flush method. 


The following tables list the members exposed by the BufferedOutputStream type. 


Public Constructors 





BufferedOutputStream Overloaded. 


Public Fields 








Name Description 

buf Stores the array of bytes that represents the buffer data. 
count Stores the number of bytes written to the stream. 

out (inherited from FilterOutputStream ) 





Public Methods 














Name Description 

close Overridden. Closes the output stream. 

equals (inherited from Object ) 

flush Overridden. Empties the output buffer, causing the stored data to be written to the output stream. 





hashCode ___|(inherited from Object ) 





getClass (inherited from Object ) 





clone (inherited from OutputStream ) 





toString (inherited from OutputStream ) 





write Overloaded. Overridden. 








Protected Methods 
Name 


finalize (inherited from Object ) 











See Also 

Reference 
BufferedOutputStream Class 
Concepts 

java.io Package 
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BufferedOutputStream Fields 


Public Fields 























Name Description 

buf Stores the array of bytes that represents the buffer data. 
count Stores the number of bytes written to the stream. 

out (inherited from FilterOutputStream ) 

See Also 

Reference 

BufferedOutputStream Class 

Concepts 


java.io Package 
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BufferedOutputStream.buf Field 


Stores the array of bytes that represents the buffer data. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





protected byte[] buf; 





See Also 

Reference 
BufferedOutputStream Class 
Concepts 

BufferedOutputStream Members 
java.io Package 
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BufferedOutputStream.count Field 


Stores the number of bytes written to the stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected int count; 


See Also 

Reference 
BufferedOutputStream Class 
Concepts 

BufferedOutputStream Members 
java.io Package 
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BufferedOutputStream Constructor 


Overload List 





Name Description 





BufferedOutputStream (OutputStream) Constructs a BufferedOutputStream with the default size. 





BufferedOutputStream (OutputStream, int) Creates a BufferedOutputStream with a specified size. 











See Also 

Reference 
BufferedOutputStream Class 
Concepts 

BufferedOutputStream Members 
java.io Package 
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BufferedOutputStream Constructor (OutputStream) 


Constructs a BufferedOutputStream with the default size. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.BufferedOutputStream( 
java.io.OutputStream out); 


Parameters 
out 


The buffer that stores the data to be written to the output stream. 


See Also 

Reference 
BufferedOutputStream Class 
Concepts 

BufferedOutputStream Members 
java.io Package 
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BufferedOutputStream Constructor (OutputStream, Int32) 


Creates a BufferedOutputStream with a specified size. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.BufferedOutputStream( 
java.io.OutputStream out, 
int size); 


Parameters 
out 


The buffer that stores the data to be written to the output stream. 
size 
The buffer size. 
See Also 
Reference 
BufferedOutputStream Class 
Concepts 


BufferedOutputStream Members 
java.io Package 
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BufferedOutputStream Methods 


Public Methods 






































Name Description 

close Overridden. Closes the output stream. 
equals (inherited from Object ) 

flush Overridden. Empties the output buffer, causing the stored data to be written to the output stream. 
hashCode ___|(inherited from Object ) 

getClass (inherited from Object ) 

clone (inherited from OutputStream ) 

toString (inherited from OutputStream ) 

write Overloaded. Overridden. 

Protected Methods 

Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


BufferedOutputStream Class 


Concepts 


java.io Package 
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BufferedOutputStream.close Method 


Closes the output stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized void close() throws java.io. IOException; 


See Also 

Reference 
BufferedOutputStream Class 
Concepts 

BufferedOutputStream Members 
java.io Package 
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BufferedOutputStream.flush Method 


Empties the output buffer, causing the stored data to be written to the output stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized void flush() throws java.io. IOException; 


See Also 

Reference 
BufferedOutputStream Class 
Concepts 

BufferedOutputStream Members 
java.io Package 
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BufferedOutputStream.write Method 


Overload List 
Name 





Description 





BufferedOutputStream.write (int) Writes the least significant byte of an int parameter to the stream. 





BufferedOutputStream.write (byte[]) 





BufferedOutputStream.write (byte[], int, int)/Writes a specific number of bytes, specified by the length of a byte array, to the ou 











See Also 

Reference 
BufferedOutputStream Class 
Concepts 

BufferedOutputStream Members 
java.io Package 
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BufferedOutputStream.write Method (Int32) 


Writes the least significant byte of an int parameter to the stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized void write( 
int b) throws java.io.IOException; 


Parameters 


b 
An int parameter. 


See Also 

Reference 
BufferedOutputStream Class 
Concepts 

BufferedOutputStream Members 
java.io Package 
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BufferedOutputStream.write Method (SByte[], Int32, Int32) 


Writes a specific number of bytes, specified by the length of a byte array, to the output buffer. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized void write( 
byte[] b, 
int off, 
int len) throws java.io. IOException; 


Parameters 


b 

The byte array. 
off 

The offset at which the writing of the data will start. 
len 

The number of bytes to be written. 


See Also 

Reference 
BufferedOutputStream Class 
Concepts 

BufferedOutputStream Members 
java.io Package 
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BufferedReader Class 


Provides an implementation of the abstract Reader class that buffers character data from another reader. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.BufferedReader 
extends java.io.Reader 


Example 


The following example demonstrates the close, mark, markSupported, read, ready, and reset methods of the BufferedReader 
class. 


// bufferedreader_overview.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 
{ 
try 
{ 
// Create a new instance of a BufferedReader object using 
// a StringReader. 
String s = "This is the internal StringReader buffer."; 
StringReader stringReader = new StringReader(s) ; 
BufferedReader bufReader = new BufferedReader (stringReader ) ; 


// Read from the underlying StringReader. 
char[] arr = new char[s.length()]; 
if (bufReader.ready()) 


bufReader.read(arr, @, arr.length - 10); 


// Call mark after having read all but the last 10 
// characters from the StringReader. 
if (bufReader.markSupported() ) 


bufReader.mark(s.length()); 


// Read the rest of the data from the underlying 
// StringReader. 
if (bufReader.ready()) 


bufReader.read(arr, arr.length - 10, 10); 
} 


System.out.println(arr) ; 


// Call reset and then re-read from the underlying 
// StringReader. 

bufReader.reset(); 

char[] arr2 = new char[s.length()]; 
bufReader.read(arr2); 

System.out.println(arr2) ; 


// Close the BufferedReader object and the underlying 
// StringReader object. 
stringReader.close(); 


bufReader.close(); 





} 
catch (IOException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 
} 
/* 
Output: 
This is the internal StringReader buffer. 
er buffer. 
a 
Remarks 


The BufferedReader class provides functionality to read characters from a stream with buffering. It also provides mark and 
reset functionality for reading characters back and forth within a buffered limit from a sequential stream. 


Inheritance Hierarchy 
java.lang.Object 
java.io.Reader 
java.io.BufferedReader 
java.io.LineNumberReader 


See Also 

Concepts 

BufferedReader Members 
java.io Package 
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BufferedReader Members 


Provides an implementation of the abstract Reader class that buffers character data from another reader. 


The following tables list the members exposed by the BufferedReader type. 


Public Constructors 



























































Name Description 

BufferedReader Overloaded. Initializes a new instance of a BufferedReader object. 

Public Fields 

Name |Description 

lock The object used to synchronize operations on the reader.(inherited from Reader) 

Public Methods 

Name Description 

close Overridden. Closes the stream being buffered and releases internal buffer. 

equals (inherited from Object ) 

hashCode (inherited from Object ) 

getClass (inherited from Object ) 

mark Overridden. Sets the mark to the next character in the stream to be read. Also specifies a limit on the number 
of characters that can be read before the mark becomes invalid. 

markSupported/Overridden. Determines whether the current position of the stream can be marked. 

clone Creates a shallow copy of the object. (inherited from Reader) 

read Overloaded. Overridden. Reads the next character or characters from the underlying stream. 

readLine Reads an entire line from the underlying stream. 

ready Overridden. Determines whether the underlying stream is ready for reading. 

reset Overridden. Resets the reader for the underlying stream such that the next character read is the character that 
is marked. 

skip Overridden. Skips over the next n characters in the underlying stream or until the end of the stream, whicheve 
ris less. 

toString Displays a human readable representation of the reader. (inherited from Reader) 

Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 
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BufferedReader Fields 


Public Fields 





Name _ Description 





lock The object used to synchronize operations on the reader. (inherited from Reader ) 
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BufferedReader Constructor 


Initializes a new instance of a BufferedReader object. 


Overload List 


Name Description 


Initializes a new instance of a BufferedReader object. The provided Reader object is the source of t 
he data to be buffered. 


BufferedReader (Reader) 








BufferedReader (Reader, int)|Initializes a new instance of a BufferedReader object. The provided Reader object is the source of t 
he data to be buffered. The internal buffer is initialized to the given size. 
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BufferedReader Constructor (Reader) 


Initializes a new instance of a BufferedReader object. The provided Reader object is the source of the data to be buffered. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.BufferedReader( 
java.io.Reader in); 


Parameters 
in 


A Reader object that is the source of the data to be buffered. 


See Also 
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BufferedReader Constructor (Reader, Int32) 


Initializes a new instance of a BufferedReader object. The provided Reader object is the source of the data to be buffered. The 
internal buffer is initialized to the given size. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.BufferedReader( 
java.io.Reader in, 
int size); 


Parameters 
in 


A Reader object that is the source of the data to be buffered. 
size 
The size of the internal buffer. 
See Also 
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BufferedReader Methods 


Public Methods 





















































Name Description 

close Overridden. Closes the stream being buffered and releases internal buffer. 

equals (inherited from Object ) 

hashCode (inherited from Object ) 

getClass (inherited from Object ) 

mark Overridden. Sets the mark to the next character in the stream to be read. Also specifies a limit on the number 
of characters that can be read before the mark becomes invalid. 

markSupported/Overridden. Determines whether the current position of the stream can be marked. 

clone Creates a shallow copy of the object. (inherited from Reader ) 

read Overloaded. Overridden. Reads the next character or characters from the underlying stream. 

readLine Reads an entire line from the underlying stream. 

ready Overridden. Determines whether the underlying stream is ready for reading. 

reset Overridden. Resets the reader for the underlying stream such that the next character read is the character that 
is marked. 

skip Overridden. Skips over the next n characters in the underlying stream or until the end of the stream, whicheve 
ris less. 

toString Displays a human readable representation of the reader. (inherited from Reader ) 

Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 
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BufferedReader.close Method 


Closes the stream being buffered and releases internal buffer. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void 


Example 


close() throws java.io. IOException; 


The following example demonstrates how to close a BufferedReader object. 


// bufferedreader_close.jsl 


import java. 
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public class Program 


public static void main(String[] args) 


// Create a new instance of a BufferedReader object using 
// a StringReader. 

String s = "This is the internal StringReader buffer."; 
StringReader stringReader = new StringReader(s) ; 
BufferedReader bufReader = new BufferedReader (stringReader) ; 


// Read from the underlying StringReader. 
char[] arr = new char[s.length()]; 
bufReader.read(arr) ; 
System.out.println(arr) ; 


// Close the BufferedReader object and the underlying 
// StringReader object. 

stringReader.close(); 

bufReader.close(); 


catch (IOException ex) 


{ 
try 
{ 
{ 
} 
ie 
i 
/* 
Output: 
This is the 
*/ 
See Also 
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System.out.println(ex.toString()); 


internal StringReader buffer. 
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BufferedReader.mark Method 


Sets the mark to the next character in the stream to be read. Also specifies a limit on the number of characters that can be read 
before the mark becomes invalid. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void mark( 
int readLimit) throws java.io. IOException; 


Parameters 
readLimit 


The maximum number of characters that can be marked. If negative, an IIllegalArgumentException is thrown. 
Example 


The following example demonstrates the effects that calling mark and reset have on a BufferedReader object. 
// bufferedreader_mark.jsl 
import java.io.*; 


public class Program 


+ 
public static void main(String[] args) 
{ 
try 
{ 


// Create a new instance of a BufferedReader object using 
// a StringReader. 

String s = "This is the internal StringReader buffer."; 
StringReader stringReader = new StringReader(s) ; 
BufferedReader bufReader = new BufferedReader (stringReader) ; 


// Read from the underlying StringReader. 
char[] arr = new char[s.length()]; 
bufReader.read(arr, @, arr.length - 10); 


// Call mark after having read all but the last 10 
// characters from the StringReader. 
if (bufReader.markSupported()) 


bufReader.mark(s.length()); 
} 


// Read the rest of the data from the underlying 
// StringReader. 

bufReader.read(arr, arr.length - 10, 10); 
System.out.println(arr) ; 


// Call reset and then re-read from the underlying 
// StringReader. 

bufReader.reset(); 

char[] arr2 = new char[s.length()]; 
bufReader.read(arr2); 

System.out.println(arr2) ; 


// Close the BufferedReader object and the underlying 
// StringReader object. 

stringReader.close(); 

bufReader.close(); 











catch (IOException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 
} 
/* 
Output: 
This is the internal StringReader buffer. 
er buffer. 
*/ 
See Also 
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BufferedReader.markSupported Method 


Determines whether the current position of the stream can be marked. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean markSupported(); 


Return Value 
Always true. 
Example 


The following example demonstrates the effects that calling mark and reset have on a BufferedReader object. 
// bufferedreader_marksupported.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
try 
{ 


// Create a new instance of a BufferedReader object using 
// a StringReader. 

String s = "This is the internal StringReader buffer."; 
StringReader stringReader = new StringReader(s) ; 
BufferedReader bufReader = new BufferedReader (stringReader) ; 


// Read from the underlying StringReader. 
char[] arr = new char[s.length()]; 
bufReader.read(arr, @, arr.length - 10); 


// Call mark after having read all but the last 10 
// characters from the StringReader. 
if (bufReader.markSupported() ) 


bufReader.mark(s.length()); 
} 


// Read the rest of the data from the underlying 
// StringReader. 

bufReader.read(arr, arr.length - 10, 10); 
System.out.println(arr) ; 


// Call reset and then re-read from the underlying 
// StringReader. 

bufReader.reset(); 

char[] arr2 = new char[s.length()]; 
bufReader.read(arr2); 

System.out.println(arr2) ; 


// Close the BufferedReader object and the underlying 
// StringReader object. 
stringReader.close(); 
bufReader.close(); 
} 
catch (IOException ex) 


{ 
System.out.printin(ex.toString()); 


} 


/* 

Output: 

This is the internal StringReader buffer. 
er buffer. 

*/ 
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BufferedReader.read Method 


Reads the next character or characters from the underlying stream. 


Overload List 


Name Description 
BufferedReader.read () Reads the next character from the underlying stream. 
BufferedReader.read (char[]) Reads the characters in the array starting at an offset for the length specified and stores th 


em in the provided array of characters. 





BufferedReader.read (char[], int, int)/Reads the characters from the underlying stream for the length specified, and stores them 
in the provided array of characters, starting at an offset. 





See Also 
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BufferedReader.read Method () 


Reads the next character from the underlying stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read() throws java.io. IOException; 


Return Value 
The numeric value of the character read from the stream, or -1 if the end of the stream is reached. 
Example 


The following example demonstrates how to read a single character at a time from the underlying input stream. 
// bufferedreader_read.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
try 
{ 
// Create a new instance of a BufferedReader object using 
// a StringReader. 
String s = "This is the internal StringReader buffer."; 
StringReader stringReader = new StringReader(s); 
BufferedReader bufReader = new BufferedReader (stringReader) ; 
// Read from the underlying StringReader. 
for (int i = @; i < s.length(); i++) 
{ 
System.out.print((char)bufReader.read()); 
} 
// Close the BufferedReader object and the underlying 
// StringReader object. 
stringReader.close(); 
bufReader.close(); 
} 
catch (IOException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 
} 
/* 
Output: 
This is the internal StringReader buffer. 
rf 
See Also 
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BufferedReader.read Method (Char[], Int32, Int32) 


Reads the characters from the underlying stream for the length specified, and stores them in the provided array of characters, 
starting at an offset. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read( 
char[] b, 
int off, 
int len) throws java.io. IOException; 


Parameters 
b 
The array of characters to store the characters read from the underlying stream. 


off 


An offset into the array of characters. This value represents the index of the first character in the array to be written. This 
value must be greater than zero. 


len 
The number of characters to be read. This value plus the offset must be less than the overall length of the array. 
Return Value 
The number of characters read, or -1 if the end of the stream is reached. 
Example 


The following example demonstrates how to read from the underlying input stream and store the data read into an array. 
// bufferedreader_read_2.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
try 
{ 


// Create a new instance of a BufferedReader object using 
// a StringReader. 

String s = "This is the internal StringReader buffer."; 
StringReader stringReader = new StringReader(s); 
BufferedReader bufReader = new BufferedReader (stringReader) ; 


// Read from the underlying StringReader. 
char[] arr = new char[s.length()]; 
bufReader.read(arr, @, arr.length); 
System.out.println(arr) ; 


// Close the BufferedReader object and the underlying 
// StringReader object. 

stringReader.close(); 

bufReader.close(); 


catch (IOException ex) 
{ 


} 


System.out.printin(ex.toString()); 


} 


/* 

Output: 

This is the internal StringReader buffer. 
*/ 
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BufferedReader.readLine Method 


Reads an entire line from the underlying stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String readLine() throws java.io. IOException; 


Return Value 


A string representing the contents of the line read from the underlying stream. The string contains all the text in the stream up 
to the next carriage return (CR), line feed (LF), carriage return plus line feed (CR+LF), or the end of the stream. If no characters 
other than a carriage return or line feed are found, then null is returned. 


Example 

The following example demonstrates how to read an entire line from the underlying input stream. 
// bufferedreader_readline.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
try 
{ 
// Create a new instance of a BufferedReader object using 
// a StringReader. 
String s = "This is the internal StringReader buffer."; 
StringReader stringReader = new StringReader(s) ; 
BufferedReader bufReader = new BufferedReader (stringReader) ; 
// Read from the underlying StringReader. 
String str = null; 
while (true) 
{ 
str = bufReader.readLine(); 
if (str != null) 
{ 
System.out.printin(str); 
} 
else 
break; 
} 
// Close the BufferedReader object and the underlying 
// StringReader object. 
stringReader.close(); 
bufReader.close(); 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 


This is the internal StringReader buffer. 


null 
a | 
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BufferedReader.ready Method 


Determines whether the underlying stream is ready for reading. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean ready() throws java.io. IOException; 


Return Value 
true if the underlying stream is ready for reading; false otherwise. 
Example 


The following example demonstrates how to determine if a BufferedReader object is ready for reading. 
// bufferedreader_ready.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
try 
{ 
// Create a new instance of a BufferedReader object using 
// a StringReader. 
String s = "This is the internal StringReader buffer."; 
StringReader stringReader = new StringReader(s); 
BufferedReader bufReader = new BufferedReader (stringReader) ; 
// Read from the underlying StringReader. 
char[] arr = new char[s.length()]; 
if (bufReader.ready()) 
bufReader.read(arr, @, arr.length); 
} 
System.out.println(arr) ; 
// Close the BufferedReader object and the underlying 
// StringReader object. 
stringReader.close(); 
bufReader.close(); 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 
This is the internal StringReader buffer. 
*/ 
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BufferedReader.reset Method 


Resets the reader for the underlying stream such that the next character read is the character that is marked. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void reset() throws java.io. IOException; 


Example 


The following example demonstrates the effects that calling mark and reset have on a BufferedReader object. 


// bufferedreader_reset.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 
{ 
try 
{ 
// Create a new instance of a BufferedReader object using 
// a StringReader. 
String s = "This is the internal StringReader buffer."; 
StringReader stringReader = new StringReader(s) ; 
BufferedReader bufReader = new BufferedReader (stringReader) ; 


// Read from the underlying StringReader. 
char[] arr = new char[s.length()]; 
bufReader.read(arr, @, arr.length - 10); 


// Call mark after having read all but the last 10 
// characters from the StringReader. 
if (bufReader.markSupported()) 


bufReader.mark(s.length()); 
} 


// Read the rest of the data from the underlying 
// StringReader. 

bufReader.read(arr, arr.length - 10, 10); 
System.out.println(arr) ; 


// Call reset and then re-read from the underlying 
// StringReader. 

bufReader.reset(); 

char[] arr2 = new char[s.length()]; 
bufReader.read(arr2); 

System.out.println(arr2) ; 


// Close the BufferedReader object and the underlying 
// StringReader object. 

stringReader.close(); 

bufReader.close(); 


catch (IOException ex) 
{ 


} 


System.out.println(ex.toString()); 


/* 

Output: 

This is the internal StringReader buffer. 
er buffer. 

*/ 
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BufferedReader.skip Method 


Skips over the next n characters in the underlying stream or until the end of the stream, whichever is less. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public long skip( 
long n) throws java.io.IOException; 


Parameters 
n 


The number of characters to skip over. This value must be greater than zero. If this number is greater than the number of 
characters remaining in the stream, then only the number of remaining characters will be skipped. 


Return Value 
The number of characters skipped. 
Example 


The following example demonstrates how to skip characters when reading from the underlying input stream. 
// bufferedreader_skip.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
try 
{ 
// Create a new instance of a BufferedReader object using 
// a StringReader. 
String s = "This is the internal StringReader buffer."; 
StringReader stringReader = new StringReader(s); 
BufferedReader bufReader = new BufferedReader (stringReader ) ; 
// Read from the underlying StringReader. 
for (int i = @; i < s.length(); i++) 
{ 
if (bufReader.ready()) 
{ 
System.out.print((char)bufReader.read()); 
} 
// Skip over i characters. 
bufReader.skip(i); 
} 
// Close the BufferedReader object and the underlying 
// StringReader object. 
stringReader.close(); 
bufReader.close(); 
catch (IOException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 


/* 
Output: 


yd 
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BufferedWriter Class 


Provides an implementation of the abstract Writer class that buffers character data to another writer. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.Bufferedwriter 
extends java.io.Writer 


Example 

The following example demonstrates the close, flush, newLine, and write methods of the BufferedWriter class. 
// bufferedwriter_overview.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
try 
{ 
// Create a new instance of a BufferedWriter object using 
// a StringWriter. 
StringWriter stringWriter = new StringWriter(); 
BufferedwWriter bufWriter = new BufferedwWriter(stringwWriter) ; 
// Write to the underlying StringWriter. 
String s = "This is the string being written."; 
// Print out the first 12 characters. 
bufWriter.write(s, @, 12); 
// Print a newline character. 
bufWriter.newLine() ; 
// Print the rest of the string. 
bufWriter.write(s, 12, s.length() - 12); 
bufWriter.flush(); 
System.out.printin(stringWriter.getBuffer()); 
// Close the BufferedwWriter object and the underlying 
// StringWriter object. 
stringWriter.close(); 
bufWriter.close(); 
} 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 
This is the 
string being written. 
of 


Inheritance Hierarchy 


java.lang.Object 
java.io.Writer 
java.io.BufferedWriter 
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BufferedWriter Members 


Provides an implementation of the abstract Writer class that buffers character data to another writer. 


The following tables list the members exposed by the BufferedWriter type. 


Public Constructors 





Name Description 





BufferedWriter Overloaded. Initializes a new instance of a BufferedWriter object. 





Public Fields 
Name ___ Description 





lock The object used to synchronize operations on the writer.(inherited from Writer) 





Public Methods 
Name Description 


close Overridden. Closes the stream. Flushes and releases internal buffer. 
equals (inherited from Object ) 


flush Overridden. Flushes the contents of the internal buffer to the underlying writer. The underlying writer is also flushe 
d. 





hashCode |(inherited from Object ) 


getClass |(inherited from Object ) 

clone Creates a shallow copy of this reader. (inherited from Writer) 

newLine |Inserts a new line character into the underlying stream. 

toString |Displays a human readable representation of a Writer object. (inherited from Writer) 


write Overloaded. Writes the next character or characters to the underlying stream. 





Protected Methods 








Name Description 





finalize (inherited from Object ) 
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BufferedWriter Fields 


Public Fields 





Name |Description 





lock The object used to synchronize operations on the writer. (inherited from Writer ) 
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BufferedWriter Constructor 


Initializes a new instance of a BufferedWriter object. 


Overload List 


Name Description 


Initializes a new instance of a BufferedWriter object. The provided Writer object is the destination f 
or the data being buffered. 


BufferedWriter (Writer) 








BufferedWriter (Writer, int)|Initializes a new instance of a BufferedWriter object. The provided Writer object is the destination f 
or the data being buffered. The internal buffer is initialized to the given size. 
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BufferedWriter Constructor (Writer) 


Initializes a new instance of a BufferedWriter object. The provided Writer object is the destination for the data being buffered. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.Bufferedwriter( 
java.io.Writer out); 


Parameters 
out 


The destination for the data being buffered. 


See Also 
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BufferedWriter Constructor (Writer, Int32) 


Initializes a new instance of a BufferedWriter object. The provided Writer object is the destination for the data being buffered. 
The internal buffer is initialized to the given size. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.Bufferedwriter( 
java.io.Writer out, 
int size); 


Parameters 
out 


The destination for the data being buffered. 
size 
The size of the internal buffer. 


See Also 
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BufferedWriter Methods 


Public Methods 





Name Description 





close Overridden. Closes the stream. Flushes and releases internal buffer. 





equals (inherited from Object ) 





flush Overridden. Flushes the contents of the internal buffer to the underlying writer. The underlying writer is also flushe 
d. 


hashCode |(inherited from Object ) 


getClass |(inherited from Object ) 

clone Creates a shallow copy of this reader. (inherited from Writer ) 

newLine_ |Inserts a new line character into the underlying stream. 

toString |Displays a human readable representation of a Writer object. (inherited from Writer ) 


write Overloaded. Writes the next character or characters to the underlying stream. 


Protected Methods 





Name Description 





finalize (inherited from Object ) 
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BufferedWriter.close Method 


Closes the stream. Flushes and releases internal buffer. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void 


Example 


close() throws java.io. IOException; 


The following example demonstrates how to close a BufferedWriter object. 


// bufferedwriter_close.jsl 


import java. 
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public class Program 


public static void main(String[] args) 


// Create a new instance of a BufferedWriter object using 
// a StringWriter. 

StringWriter stringWriter = new StringWriter(); 
Bufferedwriter bufWriter = new BufferedwWriter(stringwWriter) ; 


// Write to the underlying StringWriter. 
String s = "This is the string being written."; 
bufWriter.write(s); 

bufWriter.flush(); 
System.out.println(stringWriter.getBuffer()); 


// Close the BufferedwWriter object and the underlying 
// StringWriter object. 

stringWriter.close(); 

bufWriter.close(); 


catch (IOException ex) 


{ 
try 
{ 
{ 
} 
ie 
i 
/* 
Output: 
This is the 
*/ 
See Also 
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System.out.println(ex.toString()); 


string being written. 
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BufferedWriter.flush Method 


Flushes the contents of the internal buffer to the underlying writer. The underlying writer is also flushed. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void flush() throws java.io. IOException; 


Example 

The following example demonstrates how to flush the internal buffer of a BufferedWriter object. 
// bufferedwriter_flush.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 


{ 
try 
{ 
// Create a new instance of a BufferedWriter object using 
// a StringWriter. 
StringWriter stringWriter = new StringWriter(); 
Bufferedwriter bufWriter = new BufferedwWriter(stringwWriter) ; 
// Write to the underlying StringWriter. 
String s = "This is the string being written."; 
bufWriter.write(s); 
bufWriter.flush(); 
System.out.println(stringWriter.getBuffer()); 
// Close the BufferedwWriter object and the underlying 
// StringWriter object. 
stringWriter.close(); 
bufWriter.close(); 
catch (IOException ex) 
{ 
System. out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 
This is the string being written. 
*/ 
See Also 
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BufferedWriter.newLine Method 


Inserts a new line character into the underlying stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void newLine() throws java.io. IOException; 


Example 

The following example demonstrates how to insert a newline character into the underlying output stream. 
// bufferedwriter_newline.jsl 
import java.io.*; 


public class Program 


i 
public static void main(String[] args) 
{ 
try 
{ 
// Create a new instance of a BufferedWriter object using 
// a StringWriter. 
StringWriter stringWriter = new StringWriter(); 
BufferedwWriter bufWriter = new BufferedwWriter(stringwWriter) ; 
// Write to the underlying StringWriter. 
String s = "This is the string being written."; 
// Print out the first 12 characters. 
bufWriter.write(s, @, 12); 
// Print a newline character. 
bufWriter.newLine() ; 
// Print the rest of the string. 
bufWriter.write(s, 12, s.length() - 12); 
bufWriter.flush(); 
System.out.println(stringWriter.getBuffer()); 
// Close the BufferedwWriter object and the underlying 
// StringWriter object. 
stringWriter.close(); 
bufWriter.close(); 
} 
catch (IOException ex) 
{ 
System. out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 
This is the 
string being written. 
*/ 
See Also 


Reference 


BufferedWriter Class 
Concepts 

BufferedWriter Members 
java.io Package 


Visual J# Reference 


BufferedWriter.write Method 


Writes the next character or characters to the underlying stream. 


Overload List 


Name Description 

BufferedWriter.write (char[]) Places the given array of characters into the internal buffer holding the characters. 
BufferedWriter.write (int) Writes the next character to the underlying stream. 

BufferedWriter.write (String) Places the given string into the internal buffer holding characters. 


BufferedWriter.write (char{], int, int) |\Writes len characters from the provided buffer, starting at an offset, to the underlying stre 
am. 


BufferedWriter.write (String, int, int)|\Writes len characters from the provided string, starting at an offset, to the underlying stre 
am. 














See Also 

Reference 
BufferedWriter Class 
Concepts 

BufferedWriter Members 
java.io Package 


Visual J# Reference 


BufferedWriter.write Method (Int32) 


Writes the next character to the underlying stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
int b) throws java.io. IOException; 


Parameters 


b 
The character to write to the underlying stream. 
Example 
The following example demonstrates how to write a single character at a time to the underlying output stream. 
// bufferedwriter_write.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 


{ 
try 
{ 
// Create a new instance of a BufferedWriter object using 
// a StringWriter. 
StringWriter stringWriter = new StringWriter(); 
BufferedwWriter bufWriter = new BufferedwWriter(stringwWriter) ; 
// Write to the underlying StringWriter. 
String s = "This is the string being written."; 
for (int i = @; i < s.length(); i++) 
bufWriter.write((char)s.charAt(i)); 
bufWriter.flush(); 
System.out.println(stringWriter.getBuffer()); 
// Close the BufferedwWriter object and the underlying 
// StringWriter object. 
stringWriter.close(); 
bufWriter.close(); 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
/ * 
Output: 
This is the string being written. 
af 
See Also 
Reference 


BufferedWriter Class 


Concepts 
BufferedWriter Members 
java.io Package 
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BufferedWriter.write Method (Char[], Int32, Int32) 


Writes len characters from the provided buffer, starting at an offset, to the underlying stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
char[] b, 
int off, 
int len) throws java.io. IOException; 


Parameters 
b 
An array of characters to write to the underlying stream. 


off 


An offset into the provided array. This value represents the index of the first character in the array to be read. This value must 
be greater than zero. 


len 


The number of characters to be read starting from the offset. This value plus the offset must be less than the overall length of 
the provided array. 


Example 

The following example demonstrates how to write an array of data to the underlying output stream. 
// bufferedwriter_write_2.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
a4 
try 
{ 
// Create a new instance of a BufferedWriter object using 
// a StringWriter. 
StringWriter stringWriter = new StringWriter(); 
BufferedwWriter bufWriter = new BufferedwWriter(stringwWriter) ; 
// Write to the underlying StringWriter. 
String s = "This is the string being written."; 
char[] arr = s.toCharArray(); 
bufWriter.write(arr, @, arr.length); 
bufWriter.flush(); 
System.out.println(stringWriter.getBuffer() ); 
// Close the BufferedwWriter object and the underlying 
// StringWriter object. 
stringWriter.close(); 
bufWriter.close(); 
catch (IOException ex) 
{ 
System. out.println(ex.toString()); 
} 
} 


/* 

Output: 

This is the string being written. 
sf 





See Also 

Reference 
BufferedWriter Class 
Concepts 

BufferedWriter Members 
java.io Package 
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BufferedWriter.write Method (String, Int32, Int32) 


Writes len characters from the provided string, starting at an offset, to the underlying stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
java.lang.String str, 
int off, 
int len) throws java.io.IOException; 


Parameters 
str 
A string to write to the underlying stream. 


off 


An offset into the provided string. This value represents the index of the first character in the string to be read. This value 
must be greater than zero. 


len 


The number of characters to be read starting from the offset. This value plus the offset must be less than the overall length of 
the provided string. 


Example 

The following example demonstrates how to write a string to the underlying output stream. 
// bufferedwriter_write_3.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
a4 
try 
{ 
// Create a new instance of a BufferedWriter object using 
// a StringWriter. 
StringWriter stringWriter = new StringWriter(); 
BufferedwWriter bufWriter = new BufferedwWriter(stringwWriter) ; 
// Write to the underlying StringWriter. 
String s = "This is the string being written."; 
bufWriter.write(s, @, s.length()); 
bufWriter.flush(); 
System.out.println(stringWriter.getBuffer()); 
// Close the BufferedwWriter object and the underlying 
// StringWriter object. 
stringWriter.close(); 
bufWriter.close(); 
catch (IOException ex) 
af 
System. out.print1ln(ex.toString()); 
} 
} 


/* 
Output: 


This is the string being written. 
7 





See Also 

Reference 
BufferedWriter Class 
Concepts 

BufferedWriter Members 
java.io Package 
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ByteArraylnputStream Class 


Contains an internal buffer that stores the bytes read from the input stream. By using a counter, it keeps track of the next byte 
to be read. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.ByteArrayInputStream 
extends java.io.InputStream 





Inheritance Hierarchy 

java.lang.Object 
java.io.InputStream 
java.io.ByteArraylnputStream 


See Also 

Concepts 

ByteArraylnputStream Members 
java.io Package 
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ByteArraylnputStream Members 


Contains an internal buffer that stores the bytes read from the input stream. By using a counter, it keeps track of the next byte 
to be read. 


The following tables list the members exposed by the ByteArraylnputStream type. 


Public Constructors 





ByteArraylnputStream Overloaded. 


Public Fields 





Name |Description 





buf A byte array that stores the data. 
count |An integer that represents the index one greater than the last valid character in the input buffer. 
mark |The currently marked position in the stream. 


pos The index of the next character to read from the input stream buffer. 





Public Methods 














Name Description 

available Overridden. Returns the number of bytes that can be read from the input stream without being blocked. 
close (inherited from InputStream ) 

equals (inherited from Object ) 





hashCode (inherited from Object ) 





getClass (inherited from Object ) 





mark Overridden. Sets the current marked position in the ByteArraylnputStream object. By default, the ByteArraylnp 
utStream object is marked at position zero. By using this method, you can mark it at any other position. 


markSupported|Overridden. Checks if the mark is supported by the input stream. 


clone (inherited from InputStream ) 
read Overloaded. Overridden. 
reset Overridden. Resets the buffer to the marked position. Unless the position was marked otherwise, its default po 


sition is zero. Specifying an offset in the constructor can also change the marked position. 


skip Overridden. Skips a specified amount of bytes from the input stream 





toString (inherited from InputStream ) 


Protected Methods 
Name Description 




















finalize (inherited from Object ) 














See Also 

Reference 
ByteArraylnputStream Class 
Concepts 

java.io Package 


Visual J# Reference 


ByteArraylnputStream Fields 


Public Fields 


























Name |Description 

buf A byte array that stores the data. 

count |An integer that represents the index one greater than the last valid character in the input buffer. 
mark |The currently marked position in the stream. 

pos The index of the next character to read from the input stream buffer. 

See Also 

Reference 

ByteArraylnputStream Class 

Concepts 


java.io Package 





Visual J# Reference 


ByteArraylnputStream.buf Field 


A byte array that stores the data. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





protected byte[] buf; 





See Also 

Reference 
ByteArraylnputStream Class 
Concepts 

ByteArraylnputStream Members 
java.io Package 
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ByteArraylnputStream.count Field 


An integer that represents the index one greater than the last valid character in the input buffer. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected int count; 


See Also 

Reference 
ByteArraylnputStream Class 
Concepts 

ByteArraylnputStream Members 
java.io Package 
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ByteArraylnputStream.mark Field 


The currently marked position in the stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected int mark; 


See Also 

Reference 
ByteArraylnputStream Class 
Concepts 

ByteArraylnputStream Members 
java.io Package 
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ByteArraylnputStream.pos Field 


The index of the next character to read from the input stream buffer. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





protected int pos; 





See Also 

Reference 
ByteArraylnputStream Class 
Concepts 

ByteArraylnputStream Members 
java.io Package 


Visual J# Reference 


ByteArraylnputStream Constructor 


Overload List 





Name Description 





ByteArraylnputStream (byte[]) Constructs a ByteArraylnputStream object and uses the field buf as its buffer. 





ByteArraylnputStream (byte[], int, int) — |Constructs a ByteArraylnputStream object and uses the field buf as its buffer. 











See Also 

Reference 
ByteArraylnputStream Class 
Concepts 

ByteArraylnputStream Members 
java.io Package 
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ByteArraylnputStream Constructor (SByte[ ]) 


Constructs a ByteArraylnputStream object and uses the field buf as its buffer. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.ByteArrayInputStream( 
byte[] b); 


Parameters 


b 

The buffer array. 
Remarks 
The initial pos is zero. 


See Also 

Reference 
ByteArraylnputStream Class 
Concepts 

ByteArraylnputStream Members 
java.io Package 
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ByteArrayInputStream Constructor (SByte[ ], Int32, Int32) 


Constructs a ByteArraylnputStream object and uses the field buf as its buffer. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.ByteArrayInputStream( 
byte[] b, 
int off, 
int len); 


Parameters 


b 
The buffer array. 
off 
The offset of the first byte in the buffer. 
len 
The maximum number of bytes to be read from the buffer. 
Remarks 
The initial value of pos is off. 


See Also 

Reference 
ByteArraylnputStream Class 
Concepts 

ByteArraylnputStream Members 
java.io Package 
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ByteArraylInputStream Methods 


Public Methods 


















































Name Description 

available Overridden. Returns the number of bytes that can be read from the input stream without being blocked. 

close (inherited from InputStream ) 

equals (inherited from Object ) 

hashCode (inherited from Object ) 

getClass (inherited from Object ) 

mark Overridden. Sets the current marked position in the ByteArraylnputStream object. By default, the ByteArraylnp 
utStream object is marked at position zero. By using this method, you can mark it at any other position. 

markSupported|Overridden. Checks if the mark is supported by the input stream. 

clone (inherited from InputStream ) 

read Overloaded. Overridden. 

reset Overridden. Resets the buffer to the marked position. Unless the position was marked otherwise, its default po 
sition is zero. Specifying an offset in the constructor can also change the marked position. 

skip Overridden. Skips a specified amount of bytes from the input stream 

toString (inherited from InputStream ) 

Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 


ByteArraylnputStream Class 


Concepts 
java.io Package 
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ByteArraylnputStream.available Method 


Returns the number of bytes that can be read from the input stream without being blocked. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int available(); 


Return Value 
The number of bytes that can be read from the ByteArraylnputStream without being blocked. 


See Also 

Reference 
ByteArraylnputStream Class 
Concepts 

ByteArraylnputStream Members 
java.io Package 
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ByteArraylnputStream.mark Method 


Sets the current marked position in the ByteArraylnputStream object. By default, the ByteArraylnputStream object is marked at 
position zero. By using this method, you can mark it at any other position. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized void mark( 
int readlimit); 


Parameters 
readlimit 


The maximum number of bytes that can be read before the marked position becomes invalid. 


See Also 

Reference 
ByteArraylnputStream Class 
Concepts 

ByteArraylnputStream Members 
java.io Package 
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ByteArraylnputStream.markSupported Method 


Checks if the mark is supported by the input stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean markSupported(); 


Return Value 

true if supported; false otherwise. 

Remarks 

For ByteArraylnputStream objects this method always return true. 


See Also 

Reference 
ByteArraylnputStream Class 
Concepts 

ByteArraylnputStream Members 
java.io Package 
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ByteArraylInputStream.read Method 


Overload List 
Name 





Description 





ByteArraylnputStream.read () Reads the next byte of data from the current ByteArraylnputStream. 





ByteArraylnputStream.read (byte[]) 





ByteArraylnputStream.read (bytel], int, int)/Reads up to total number of bytes of data into a byte array from the current input s 











See Also 
Reference 


ByteArraylnputStream Class 
Concepts 

ByteArraylnputStream Members 
java.io Package 
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ByteArraylnputStream.read Method () 


Reads the next byte of data from the current ByteArraylnputStream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized int read(); 


Return Value 

An int value between 0 and 255 or -1 If the end of the stream has been reached. 
Remarks 

Might throw an IOException. 


See Also 

Reference 
ByteArraylnputStream Class 
Concepts 

ByteArraylnputStream Members 
java.io Package 
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ByteArraylnputStream.read Method (SByte[], Int32, Int32) 


Reads up to total number of bytes of data into a byte array from the current input stream object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized int read( 
byte[] b, 
int off, 
int len); 


Parameters 


b 
The buffer of the input data. 
off 
The starting offset of the data. 
len 
The total number of bytes read into the buffer, or -1 if the end of the stream has been reached. 
Return Value 


If pos is greater than or equal count, -1 is returned. If len equals 0, zero is returned to indicate end of file. Otherwise, the 
number of bytes read is equal to the minimum of len and count-pos. 


Remarks 
The parameters are not validated and any runtime exception may be raised in a System.arraycopy call. 


See Also 

Reference 
ByteArraylnputStream Class 
Concepts 

ByteArraylnputStream Members 
java.io Package 
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ByteArraylnputStream.reset Method 


Resets the buffer to the marked position. Unless the position was marked otherwise, its default position is zero. Specifying an 
offset in the constructor can also change the marked position. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized void reset(); 


See Also 

Reference 
ByteArraylnputStream Class 
Concepts 

ByteArraylnputStream Members 
java.io Package 
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ByteArraylnputStream.skip Method 


Skips a specified amount of bytes from the input stream 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized long skip( 
long n); 


Parameters 
n 

The number of bytes to skip. 
Return Value 
The number of bytes to skip. 
Remarks 


If the end of the stream is reached, a fewer number of bytes might be skipped. The actual number of skipped bytes is equal to 
the minimum of n and count-pos. 


See Also 

Reference 
ByteArraylnputStream Class 
Concepts 

ByteArraylnputStream Members 
java.io Package 
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ByteArrayOutputStream Class 


Extends the OutputStream class in which the data is written into a byte array. It contains a buffer that automatically grows as 
data is written to it. It also contains methods to retrieve and convert data. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.ByteArrayOutputStream 
extends java.io.OutputStream 


Inheritance Hierarchy 

java.lang.Object 
java.io.OutputStream 
java.io.ByteArrayOutputStream 


See Also 

Concepts 

ByteArrayOutputStream Members 
java.io Package 
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ByteArrayOutputStream Members 


Extends the OutputStream class in which the data is written into a byte array. It contains a buffer that automatically grows as 
data is written to it. It also contains methods to retrieve and convert data. 


The following tables list the members exposed by the ByteArrayOutputStream type. 


Public Constructors 





ByteArrayOutputStream Overloaded. 


Public Fields 
Name _ Description 








buf The data buffer of the ByteArrayOutputStream object. 


count |The counter that stores the number of bytes in the ByteArrayOutputStream buffer. 





Public Methods 














Name Description 

close (inherited from OutputStream ) 
equals (inherited from Object ) 

flush (inherited from OutputStream ) 





hashCode _ |(inherited from Object ) 





getClass (inherited from Object ) 








clone (inherited from OutputStream ) 
reset Resets the count field of the current ByteArrayOutputStream to zero discarding the data that exists in the output st 
ream. 


size Returns the number of the bytes that have been written to the current ByteArrayOutputStream object since its mo 


st reset or since it was created, if it has never been reset. 









toByteArray/Allocates and returns new byte array and copies the buffer contents to it. 











toString Overridden. Returns the string representation of the buffer's data for the current ByteArrayOutputStream object. 
write Overloaded. Overridden. 
writeTo Writes the entire contents of the current ByteArrayOutputStream object to a specified output stream. 


Protected Methods 




















Name Description 
finalize (inherited from Object ) 
See Also 


Reference 


ByteArrayOutputStream Class 
Concepts 
java.io Package 


Visual J# Reference 


ByteArrayOutputStream Fields 


Public Fields 





Name _ Description 





buf The data buffer of the ByteArrayOutputStream object. 





count |The counter that stores the number of bytes in the ByteArrayOutputStream buffer. 











See Also 

Reference 
ByteArrayOutputStream Class 
Concepts 

java.io Package 


Visual J# Reference 


ByteArrayOutputStream.buf Field 


The data buffer of the ByteArrayOutputStream object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





protected byte[] buf; 





See Also 

Reference 
ByteArrayOutputStream Class 
Concepts 

ByteArrayOutputStream Members 
java.io Package 
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ByteArrayOutputStream.count Field 


The counter that stores the number of bytes in the ByteArrayOutputStream buffer. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





protected int count; 





See Also 

Reference 
ByteArrayOutputStream Class 
Concepts 

ByteArrayOutputStream Members 
java.io Package 


Visual J# Reference 


ByteArrayOutputStream Constructor 


Overload List 





Name 


Description 





ByteArrayOutputStream () 


Constructs a new ByteArrayOutputStream object with a default initial buffer size. 





ByteArrayOutputStream (int) 








Constructs a new ByteArrayOutputStream object with a specified initial buffer size. 





See Also 
Reference 


ByteArrayOutputStream Class 
Concepts 


ByteArrayOutputStream Members 


java.io Package 
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ByteArrayOutputStream Constructor () 


Constructs a new ByteArrayOutputStream object with a default initial buffer size. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.ByteArrayOutputStream() ; 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
ByteArrayOutputStream Class 
Concepts 

ByteArrayOutputStream Members 
java.io Package 
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ByteArrayOutputStream Constructor (Int32) 


Constructs a new ByteArrayOutputStream object with a specified initial buffer size. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.ByteArrayOutputStream( 
int size); 


Parameters 
size 

The initial buffer size. 
Remarks 


Throws an IlIlegalArgumentException if the buffer size is negative. 


See Also 

Reference 
ByteArrayOutputStream Class 
Concepts 

ByteArrayOutputStream Members 
java.io Package 
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ByteArrayOutputStream Methods 


Public Methods 























toString 


write 


writeTo 


Name Description 

close (inherited from OutputStream ) 

equals (inherited from Object ) 

flush (inherited from OutputStream ) 

hashCode _ |(inherited from Object ) 

getClass (inherited from Object ) 

clone (inherited from OutputStream ) 

reset Resets the count field of the current ByteArrayOutputStream to zero discarding the data that exists in the output st 
ream. 

size Returns the number of the bytes that have been written to the current ByteArrayOutputStream object since its mo 


toByteArray/Allocates and returns new byte array and copies the buffer contents to it. 


Protected Methods 


st reset or since it was created, if it has never been reset. 


Overridden. Returns the string representation of the buffer's data for the current ByteArrayOutputStream object. 
Overloaded. Overridden. 


Writes the entire contents of the current ByteArrayOutputStream object to a specified output stream. 




















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


ByteArrayOutputStream Class 


Concepts 


java.io Package 
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ByteArrayOutputStream.reset Method 


Resets the count field of the current ByteArrayOutputStream to zero discarding the data that exists in the output stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public synchronized void reset(); 





See Also 

Reference 
ByteArrayOutputStream Class 
Concepts 

ByteArrayOutputStream Members 
java.io Package 
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ByteArrayOutputStream.size Method 


Returns the number of the bytes that have been written to the current ByteArrayOutputStream object since its most reset or 
since it was created, if it has never been reset. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int size(); 
| 


Return Value 
The buffer size of the ByteArrayOutputStream. 


See Also 

Reference 
ByteArrayOutputStream Class 
Concepts 

ByteArrayOutputStream Members 
java.io Package 
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ByteArrayOutputStream.toByteArray Method 


Allocates and returns new byte array and copies the buffer contents to it. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized byte[] toByteArray(); 


Return Value 
A byte array that contains the buffer data of the current ByteArrayOutputStream object. 


See Also 

Reference 
ByteArrayOutputStream Class 
Concepts 

ByteArrayOutputStream Members 
java.io Package 
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ByteArrayOutputStream.toString Method 


Overload List 
Name Description 








ByteArrayOutputStream.toString (int) | |Returns the string that represents the current contents of the 
ByteArrayOutputStream object. The size of the string is the same as that of the buffer 
. The characters of the resulting string are constructed from the elements of the byte 
array. 





ByteArrayOutputStream.toString (String)/Returns the string representation of the buffer's contents for the current ByteArrayO 
utputStream object. The string conversion is performed using a specified character e 
ncoding. 





See Also 

Reference 
ByteArrayOutputStream Class 
Concepts 

ByteArrayOutputStream Members 
java.io Package 
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ByteArrayOutputStream.toString Method (Int32) 


Returns the string that represents the current contents of the ByteArrayOutputStream object. The size of the string is the same 
as that of the buffer. The characters of the resulting string are constructed from the elements of the byte array. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toString( 
int hibyte); 


Parameters 


hibyte 
The high byte of the resulting character. 
Return Value 
The string that represents the current contents of the ByteArrayOutputStream object. 


See Also 

Reference 
ByteArrayOutputStream Class 
Concepts 

ByteArrayOutputStream Members 
java.io Package 
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ByteArrayOutputStream.toString Method (String) 


Returns the string representation of the buffer's contents for the current ByteArrayOutputStream object. The string conversion 
is performed using a specified character encoding. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toString( 
java.lang.String enc) throws java.io.UnsupportedEncodingException; 


Parameters 
enc 


The character encoding. 
Return Value 
The string representation of the buffer's data using the specified character encoding. 


See Also 

Reference 
ByteArrayOutputStream Class 
Concepts 

ByteArrayOutputStream Members 
java.io Package 
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ByteArrayOutputStream.toString Method (J#) 


Returns the string representation of the buffer's data for the current ByteArrayOutputStream object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toString(); 


Return Value 
The string representation of the buffer's data. 


See Also 

Reference 
ByteArrayOutputStream Class 
Concepts 

ByteArrayOutputStream Members 
java.io Package 
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ByteArrayOutputStream.write Method 


Overload List 
Name Description 








ByteArrayOutputStream.write (int) Writes a byte to the current ByteArrayOutputStream object. 





ByteArrayOutputStream.write (byte[]) 





ByteArrayOutputStream.write (byte[], int, int)|Writes a specific number of bytes from a byte array to the current ByteArrayOutp 
utStream object starting at a specified offset. 











See Also 

Reference 
ByteArrayOutputStream Class 
Concepts 

ByteArrayOutputStream Members 
java.io Package 
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ByteArrayOutputStream.write Method (Int32) 


Writes a byte to the current ByteArrayOutputStream object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized void write( 
int b); 


Parameters 


b 
The byte to be written. 


See Also 

Reference 
ByteArrayOutputStream Class 
Concepts 

ByteArrayOutputStream Members 
java.io Package 
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ByteArrayOutputStream.write Method (SByte[], Int32, Int32) 


Writes a specific number of bytes from a byte array to the current ByteArrayOutputStream object starting at a specified offset. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized void write( 
byte[] b, 
int off, 
int len); 


Parameters 


b 
The data byte array. 
off 
The offset to start at. 
len 
The number of bytes to be written. 


See Also 

Reference 
ByteArrayOutputStream Class 
Concepts 

ByteArrayOutputStream Members 
java.io Package 
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ByteArrayOutputStream.writeTo Method 


Writes the entire contents of the current ByteArrayOutputStream object to a specified output stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized void writeTo( 
java.io.OutputStream out) throws java.io. IOException; 


Parameters 
out 


The output stream. 


See Also 

Reference 
ByteArrayOutputStream Class 
Concepts 

ByteArrayOutputStream Members 
java.io Package 
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CharArrayReader Class 


Provides an implementation of the abstract Reader class specific to reading arrays of characters. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.CharArrayReader 
extends java.io.Reader 


Example 


The following example demonstrates the close, mark, markSupported, read, and reset methods of the CharArrayReader class. 


// chararrayreader_overview. jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
try 
{ 
// Create a new CharArrayReader. 
char[] arr = new char[] { 'H', ‘e', ‘l', ‘l', 'o' }; 
CharArrayReader reader = new CharArrayReader(arr) ; 


// Read from the underlying array one at a time. 
char firstLetter = (char)reader.read(); 


// Set the mark. 
if (reader.markSupported()) 


// The @ is ignored. 
reader.mark(@); 


} 


// Continue reading from the array. 

char secondLetter = (char)reader.read(); 
char thirdLetter = (char)reader.read(); 
char fourthLetter = (char)reader.read(); 
char fifthLetter = (char)reader.read(); 


// Reset the CharArrayReader. 
reader.reset(); 


// Get the first character read after the reset. 

char nextLetter = (char)reader.read(); 

System.out.println("The next letter read after reset is: + 
nextLetter) ; 


// Close the CharArrayReader. 
reader.close(); 


catch (IOException ex) 


i 
} 


System.out.println(ex.toString()); 


/* 


Output: 
The next letter read after reset is: 


ur 





Inheritance Hierarchy 

java.lang.Object 
java.io.Reader 
java.io.CharArrayReader 


See Also 

Concepts 

CharArrayReader Members 
java.io Package 
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CharArrayReader Members 


Provides an implementation of the abstract Reader class specific to reading arrays of characters. 


The following tables list the members exposed by the CharArrayReader type. 


Public Constructors 





Name Description 





CharArrayReader Overloaded. Initializes a new instance of a CharArrayReader object. 





Public Fields 











Name Description 

buf The array of characters being read. 

count The number of characters in the array buf. 

lock The object used to synchronize operations on the reader.(inherited from Reader) 





markedPos The currently marked position in the array of characters. 





pos The index of the next character to be read from the array of characters. 





Public Methods 


Name Description 
close Overridden. Closes the reader once the array of characters has been processed. 
equals (inherited from Object ) 


hashCode (inherited from Object ) 
getClass (inherited from Object ) 
mark Overridden. Sets the mark to the next character in the array of characters to be read. 


markSupported/Overridden. Determines whether the current position of the array of characters can be marked. 





clone Creates a shallow copy of the object. (inherited from Reader) 

read Overloaded. Overridden. Reads the next character or characters in the array. 

ready Overridden. Determines whether the array of characters is ready for reading. 

reset Overridden. Resets the reader for the array of characters such that the next character read is the character that 
is marked. 

skip Overridden. Skips over the next n characters in the array of characters or until the end of the array, whichever 
is less. 

toString Displays a human readable representation of the reader. (inherited from Reader) 








Protected Methods 
Name Description 











finalize (inherited from Object ) 


See Also 

Reference 
CharArrayReader Class 
Concepts 

java.io Package 
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CharArrayReader Fields 


Public Fields 














Name Description 

buf The array of characters being read. 

count The number of characters in the array buf. 

lock The object used to synchronize operations on the reader. (inherited from Reader ) 





markedPos The currently marked position in the array of characters. 





pos The index of the next character to be read from the array of characters. 











See Also 

Reference 
CharArrayReader Class 
Concepts 

java.io Package 
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CharArrayReader.buf Field 


The array of characters being read. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





protected char[] buf; 





See Also 

Reference 
CharArrayReader Class 
Concepts 

CharArrayReader Members 
java.io Package 
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CharArrayReader.count Field 


The number of characters in the array buf. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





protected int count; 





See Also 

Reference 
CharArrayReader Class 
Concepts 

CharArrayReader Members 
java.io Package 
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CharArrayReader.markedPos Field 


The currently marked position in the array of characters. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected int markedPos; 


See Also 

Reference 
CharArrayReader Class 
Concepts 

CharArrayReader Members 
java.io Package 
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CharArrayReader.pos Field 


The index of the next character to be read from the array of characters. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





protected int pos; 





See Also 

Reference 
CharArrayReader Class 
Concepts 

CharArrayReader Members 
java.io Package 
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CharArrayReader Constructor 


Initializes a new instance of a CharArrayReader object. 


Overload List 


Name Description 


CharArrayReader (char[]) Initializes a new instance of a CharArrayReader object using the given array of characters. 





CharArrayReader (char[], int, int)|Initializes a new instance of a CharArrayReader object using the given array of characters, off 
set, and length. 








See Also 

Reference 
CharArrayReader Class 
Concepts 

CharArrayReader Members 
java.io Package 
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CharArrayReader Constructor (CharT ]) 


Initializes a new instance of a CharArrayReader object using the given array of characters. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.CharArrayReader( 
char[] b); 


Parameters 


b 
The array of characters to be read. 


See Also 

Reference 
CharArrayReader Class 
Concepts 

CharArrayReader Members 
java.io Package 
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CharArrayReader Constructor (Char[ ], Int32, Int32) 


Initializes a new instance of a CharArrayReader object using the given array of characters, offset, and length. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.CharArrayReader( 
char[] b, 
int off, 
int len); 


Parameters 


b 


The array of characters to be read. 


off 


An offset into the array of characters. This value represents the index of the first character in the array to be read. This value 
must be greater than zero. 


len 


The number of characters to be read starting from the offset. This value plus the offset must be less than the overall length of 
the array. 


See Also 

Reference 
CharArrayReader Class 
Concepts 

CharArrayReader Members 
java.io Package 
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CharArrayReader Methods 


Public Methods 









































Name Description 

close Overridden. Closes the reader once the array of characters has been processed. 

equals (inherited from Object ) 

hashCode (inherited from Object ) 

getClass (inherited from Object ) 

mark Overridden. Sets the mark to the next character in the array of characters to be read. 

markSupported/Overridden. Determines whether the current position of the array of characters can be marked. 

clone Creates a shallow copy of the object. (inherited from Reader ) 

read Overloaded. Overridden. Reads the next character or characters in the array. 

ready Overridden. Determines whether the array of characters is ready for reading. 

reset Overridden. Resets the reader for the array of characters such that the next character read is the character that 
is marked. 

skip Overridden. Skips over the next n characters in the array of characters or until the end of the array, whichever 
is less. 

toString Displays a human readable representation of the reader. (inherited from Reader ) 

Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 


CharArrayReader Class 


Concepts 
java.io Package 
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CharArrayReader.close Method 


Closes the reader once the array of characters has been processed. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void close(); 


Example 


The following example demonstrates how to close a CharArrayReader object. 


// chararrayreader_close.jsl 


import java. 


io.*; 


public class Program 


public static void main(String[] args) 


// Create a new CharArrayReader. 
char[] arr = new char[] { 'H', ‘e', ‘l', ‘l', 'o' }; 
CharArrayReader reader = new CharArrayReader(arr) ; 


// Read from the underlying array. 

char[] newArr = new char[arr.length]; 

reader.read(newArr) ; 

System.out.println("The new array contains: " + 
newArr) ; 


// Close the CharArrayReader. 
reader.close(); 


catch (IOException ex) 


System.out.println(ex.toString()); 


The new array contains: Hello 


{ 
try 
{ 
} 
{ 
ie 
} 
i 
/* 
Output: 
*/ 
See Also 
Reference 


CharArrayReader Class 


Concepts 


CharArrayReader Members 


java.io Package 
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CharArrayReader.mark Method 


Sets the mark to the next character in the array of characters to be read. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void mark( 
int readlimit) throws java.io. IOException; 


Parameters 
readlimit 


Ignored. 
Example 


The following example demonstrates the effect that the mark method has when you call reset. 


// chararrayreader_mark.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 
{ 
try 
{ 
// Create a new CharArrayReader. 
char[] arr = new char[] { 'H', ‘e', ‘l', ‘l', 'o' }; 
CharArrayReader reader = new CharArrayReader(arr) ; 


// Read from the underlying array one at a time. 
char firstLetter = (char)reader.read(); 


// Set the mark. 
if (reader.markSupported()) 


// The @ is ignored. 
reader.mark(@); 


} 


// Continue reading from the array. 

char secondLetter = (char)reader.read(); 
char thirdLetter = (char)reader.read(); 
char fourthLetter = (char)reader.read(); 
char fifthLetter = (char)reader.read(); 


// Reset the CharArrayReader. 
reader.reset(); 


// Get the first character read after the reset. 

char nextLetter = (char)reader.read(); 

System.out.println("The next letter read after reset is: 
nextLetter) ; 


// Close the CharArrayReader. 
reader.close(); 


} 
catch (IOException ex) 


{ 
} 


System.out.println(ex.toString()); 


} 


/* 
Output: 
The next letter read after reset is: 


*/ 





e 





See Also 

Reference 
CharArrayReader Class 
Concepts 

CharArrayReader Members 
java.io Package 
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CharArrayReader.markSupported Method 


Determines whether the current position of the array of characters can be marked. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean markSupported(); 


Return Value 
Always true. 


Example 


The following example demonstrates the effect that the mark method has when you call reset. 


// chararrayreader_marksupported.jsl 


import java. 


io.*; 


public class Program 


public static void main(String[] args) 


// Create a new CharArrayReader. 
char[] arr = new char[] { 'H', ‘e', ‘l', 'l', ‘'o' }; 
CharArrayReader reader = new CharArrayReader(arr) ; 


// Read from the underlying array one at a time. 
char firstLetter = (char)reader.read(); 


// Set the mark. 
if (reader.markSupported()) 


// The @ is ignored. 
reader.mark(@) ; 


} 


// Continue reading from the array. 

char secondLetter = (char)reader.read(); 
char thirdLetter = (char)reader.read(); 
char fourthLetter = (char)reader.read(); 
char fifthLetter = (char)reader.read(); 


// Reset the CharArrayReader. 
reader.reset(); 


// Get the first character read after the reset. 
char nextLetter = (char)reader.read(); 


System.out.println("The next letter read after reset is: 


nextLetter) ; 


// Close the CharArrayReader. 
reader.close(); 


catch (IOException ex) 


{ 
if 
try 
{ 
{ 
} 
} 


System.out.printin(ex.toString()); 


/* 
Output: 


The next letter read after reset is: 


*/ 


e 





See Also 

Reference 
CharArrayReader Class 
Concepts 

CharArrayReader Members 
java.io Package 
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CharArrayReader.read Method 


Reads the next character or characters in the array. 


Overload List 


Name Description 
CharArrayReader.read () Reads the next character in the array. 
CharArrayReader.read (char[]) Reads the characters in the array starting at an offset for the length specified and stores 


them in the provided array of characters. 





CharArrayReader.read (char[], int, int)|Reads the characters in the underlying array for the length specified and stores them in t 
he provided array of characters, starting at an offset. 





See Also 

Reference 
CharArrayReader Class 
Concepts 

CharArrayReader Members 
java.io Package 
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CharArrayReader.read Method () 


Reads the next character in the array. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read() throws java.io. IOException; 


Return Value 


The numeric value of the character read from the underlying character array, or -1 if there are no more characters to read. 


Example 


The following example demonstrates how to read one character at a time from the CharArrayReader buffer. 


// chararrayreader_read.jsl 
import java.io.*; 


public class Program 


{ 


public static void main(String[] args) 


if 
try 


{ 


// Create a new CharArrayReader. 
char[] arr = new char[] { 'H', ‘e', ‘l', ‘l', ‘'o' }; 
CharArrayReader reader = new CharArrayReader(arr) ; 


// Read from the underlying array. 
for (int i = @; i < arr.length; i++) 


{ 
if (reader.ready()) 


{ 


char charRead = (char)reader.read(); 
System.out.println(charRead) ; 


} 


else 


break; 


} 


// Close the CharArrayReader. 
reader.close(); 


catch (IOException ex) 


{ 
System.out.println(ex.toString()); 


See Also 

Reference 
CharArrayReader Class 
Concepts 

CharArrayReader Members 
java.io Package 
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CharArrayReader.read Method (Char[], Int32, Int32) 


Reads the characters in the underlying array for the length specified and stores them in the provided array of characters, 
starting at an offset. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read( 
char[] b, 
int off, 
int len) throws java.io.IOException; 


Parameters 


b 


The array of characters to store the characters read. 


off 


An offset into the array of characters. This value represents the index of the first character in the array to be written. This 
value must be greater than zero. 


len 


The number of characters to be read from the underlying array. This value plus the offset must be less than the overall length 
of the array. 


Return Value 
The number of characters read. 
Example 


The following example demonstrates how to read from the CharArrayReader buffer and populate an already existing array 
with the contents just read. 


// chararrayreader_read_2.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 
{ 
try 
{ 
// Create a new CharArrayReader. 
char[] arr = new char[] { 'H', ‘e', ‘l', ‘l', 'o' }; 
CharArrayReader reader = new CharArrayReader(arr) ; 


// Read from the underlying array. 

char[] newArr = new char[arr.length + 6]; 
newArr[6] = ‘W' 

newArr[7] = 'o 
newArr[8] = 'r 
newArr[9] = '1' 
newArr[1@] = ‘'d'; 


J 
3 
) 
3 

1 


reader.read(newArr, @, arr.length); 
System.out.println("The new array contains: " + 
newArr) ; 


// Close the CharArrayReader. 
reader.close(); 


catch (IOException ex) 


: System.out.printlin(ex.toString()); 
} 
} 
} 
/* 
Output: 


The new array contains: Hello World 
aa 





See Also 

Reference 
CharArrayReader Class 
Concepts 

CharArrayReader Members 
java.io Package 
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CharArrayReader.ready Method 


Determines whether the array of characters is ready for reading. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean ready() throws java.io. IOException; 


Return Value 
true if the array of characters is ready for reading; false otherwise. 


Example 


The following example demonstrates how to determine if a CharArrayReader object is ready for reading. 


// chararrayreader_ready.jsl 
import java.io.*; 


public class Program 


{ 


public static void main(String[] args) 


if 
try 


{ 


// Create a new CharArrayReader. 
char[] arr = new char[] { 'H', ‘e', ‘l', ‘l', ‘'o' }; 
CharArrayReader reader = new CharArrayReader(arr) ; 


// Read from the underlying array. 
for (int i = @; i < arr.length; i++) 


{ 
if (reader.ready()) 


{ 


char charRead = (char)reader.read(); 
System.out.println(charRead) ; 


} 


else 


break; 


} 


// Close the CharArrayReader. 
reader.close(); 


catch (IOException ex) 


{ 
System.out.println(ex.toString()); 


See Also 

Reference 
CharArrayReader Class 
Concepts 

CharArrayReader Members 
java.io Package 
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CharArrayReader.reset Method 


Resets the reader for the array of characters such that the next character read is the character that is marked. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void reset() throws java.io. IOException; 


Example 


The following example demonstrates the effect that the mark method has when you call reset. 


// chararrayreader_reset.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 
{ 
try 
{ 
// Create a new CharArrayReader. 
char[] arr = new char[] { 'H', ‘e', ‘l', ‘l', 'o' }; 
CharArrayReader reader = new CharArrayReader(arr) ; 


// Read from the underlying array one at a time. 
char firstLetter = (char)reader.read(); 


// Set the mark. 
if (reader.markSupported()) 


// The @ is ignored. 
reader.mark(@) ; 


} 


// Continue reading from the array. 

char secondLetter = (char)reader.read(); 
char thirdLetter = (char)reader.read(); 
char fourthLetter = (char)reader.read(); 
char fifthLetter = (char)reader.read(); 


// Reset the CharArrayReader. 
reader.reset(); 


// Get the first character read after the reset. 

char nextLetter = (char)reader.read(); 

System.out.println("The next letter read after reset is: + 
nextLetter) ; 


// Close the CharArrayReader. 
reader.close(); 


} 
catch (IOException ex) 


{ 
} 


System.out.printin(ex.toString()); 


} 


/* 
Output: 


The next letter read after reset is: e 
oy 


See Also 

Reference 
CharArrayReader Class 
Concepts 

CharArrayReader Members 
java.io Package 
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CharArrayReader.skip Method 


Skips over the next n characters in the array of characters or until the end of the array, whichever is less. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public long skip( 
long n) throws java.io.IOException; 


Parameters 


n 


The number of characters to skip over. This value must be greater than zero. If this number is greater than the number of 
characters remaining in the array, then only the number of remaining characters will be skipped. 


Return Value 

The number of characters skipped. 

Example 

The following example demonstrates how to skip over character while you are performing a read operation ona 


CharArrayReader object. 


// chararrayreader_skip.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
1 
try 
{ 


// Create a new CharArrayReader. 
char[] arr = new char[] { 'H', ‘e', ‘l', ‘l', 'o' }; 
CharArrayReader reader = new CharArrayReader(arr) ; 


// Read from the underlying array. 
for (int i = @; i < arr.length; i++) 


if (reader.ready()) 


{ 
char charRead = (char)reader.read(); 
System.out.println(charRead) ; 
// Skip over one character. 
long num = reader.skip(1); 
System.out.printlin("skipping " + num); 
} 
else 
{ 
break; 
} 


// Close the CharArrayReader. 
reader.close(); 


catch (IOException ex) 
{ 


i 


System.out.println(ex.toString()); 


} 


/* 

Output: 

H 

skipping 1 
dl 


skipping 1 
fo) 
skipping @ 
? 
skipping @ 
? 


skipping @ 
i 





See Also 
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CharArrayWriter Class 


Provides an implementation of the abstract Writer class specific to writing into an array of characters. The array can be used to 
retrieve the written character data as a character array or a string or to write the character buffer to another instance of a 
Writer object. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.CharArraywWriter 
extends java.io.Writer 


Example 


The following example demonstrates the close, flush, reset, toCharArray, write, and writeTo methods of the CharArrayWriter 
class. 


// chararraywriter_overview. jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
try 
{ 


// Create a CharArrayWriter object that can hold 11 
// characters. 
CharArrayWriter writer = new CharArrayWriter(11) ; 


// Write some data to the CharArrayWriter object. 

// Start with the 7th character and write to the end. 
String s = "Hello World"; 

writer.write("Hello World", 6, s.length() - 6); 


// Write the contents of the CharArrayWriter object to 
// a String Writer object. 

StringWriter sWriter = new StringWriter(); 
writer.writeTo(sWriter) ; 


// Print out the contents of the CharArrayWriter buffer. 
System.out.printlin("The CharArrayWriter buffer contains: " + 
writer.toString()); 


// Print out the contents of the StringWriter buffer. 
System.out.println("The StringWriter buffer contains: " + 
sWriter.toString()); 


// Now flush the buffer we just populated. 
writer.flush(); 


// Print out the contents of the CharArrayWriter buffer. 
System.out.println("The post-flush CharArrayWriter buffer " + 
"contains: " + writer.toCharArray()); 


// Now reset the buffer we just populated. 
writer.reset(); 


// Print out the contents of the CharArrayWriter buffer. 
System.out.println("The post-reset CharArrayWriter buffer " + 
"contains: " + writer.toCharArray()); 


writer.close(); 
sWriter.close(); 


} 
catch (IOException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 
} 
/* 
Output: 


The CharArrayWriter buffer contains: World 
The StringWriter buffer contains: World 


ef 





Inheritance Hierarchy 

java.lang.Object 
java.io.Writer 
java.io.CharArrayWriter 


See Also 

Concepts 

CharArrayWriter Members 
java.io Package 


The post-flush CharArrayWriter buffer contains: 
The post-reset CharArrayWriter buffer contains: 


// Close the CharArrayWriter and StringWriter buffers. 


World 
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CharArrayWriter Members 


Provides an implementation of the abstract Writer class specific to writing into an array of characters. The array can be used to 
retrieve the written character data as a character array or a string or to write the character buffer to another instance of a 
Writer object. 


The following tables list the members exposed by the CharArrayWriter type. 


Public Constructors 
Name Description 








CharArrayWriter Overloaded. Initializes a new instance of a CharArrayWriter object. 








Public Fields 





Name ___ |Description 





buf An internal buffer that stores the array of characters being written. 





count The number of characters stored in the internal array buf. 





lock The object used to synchronize operations on the writer.(inherited from Writer) 





Public Methods 


Name Description 

close Overridden. Closes the writer once the array of characters has been processed. 
equals (inherited from Object ) 

flush Overridden. Flushes the buffer representing the array of characters to be written. 


hashCode ___|(inherited from Object ) 


getClass (inherited from Object ) 


clone Creates a shallow copy of this reader. (inherited from Writer) 

reset Resets the buffer holding the array of characters. All data currently in the buffer is discarded. 

size Returns the number of character in the buffer holding the array of characters since the object was created or last r 
eset. 





toCharArray|Populates an array of characters with the data held in the internal buffer. 





toString Overridden. Displays a human readable representation of a CharArrayWriter object. The contents of the buffer hol 
ding the array of characters is returned. 





write Overloaded. Writes the next character or characters into the array. 





writeTo Writes the contents of this CharArrayWriter object to another Writer object. 








Protected Methods 


Name Description 


finalize (inherited from Object ) 











See Also 

Reference 
CharArrayWriter Class 
Concepts 

java.io Package 
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CharArrayWriter Fields 


Public Fields 





Name |Description 





buf An internal buffer that stores the array of characters being written. 





count |The number of characters stored in the internal array buf. 





lock The object used to synchronize operations on the writer. (inherited from Writer ) 














See Also 

Reference 
CharArrayWriter Class 
Concepts 

java.io Package 
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CharArrayWriter.buf Field 


An internal buffer that stores the array of characters being written. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





protected char[] buf; 





See Also 

Reference 
CharArrayWriter Class 
Concepts 

CharArrayWriter Members 
java.io Package 


Visual J# Reference 


CharArrayWriter.count Field 


The number of characters stored in the internal array buf. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





protected int count; 





See Also 

Reference 
CharArrayWriter Class 
Concepts 

CharArrayWriter Members 
java.io Package 
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CharArrayWriter Constructor 


Initializes a new instance of a CharArrayWriter object. 


Overload List 
Name Description 


CharArrayWriter () _ |Initializes a new instance of a CharArrayWriter object. 


CharArrayWriter (int)|Initializes a new instance of a CharArrayWriter object. The buffer containing the array of characters is init 
ialized to the given size. 











See Also 
Reference 


CharArrayWriter Class 
Concepts 

CharArrayWriter Members 
java.io Package 
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CharArrayWriter Constructor () 


Initializes a new instance of a CharArrayWriter object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public java.io.CharArrayWriter(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
CharArrayWriter Class 
Concepts 

CharArrayWriter Members 
java.io Package 
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CharArrayWriter Constructor (Int32) 


Initializes a new instance of a CharArrayWriter object. The buffer containing the array of characters is initialized to the given 
size. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.CharArraywWriter( 
int size); 


Parameters 
size 


The length for the buffer that will store the array of characters. This value must be greater than zero. 


See Also 

Reference 
CharArrayWriter Class 
Concepts 

CharArrayWriter Members 
java.io Package 
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CharArrayWriter Methods 


Public Methods 












































Name Description 

close Overridden. Closes the writer once the array of characters has been processed. 

equals (inherited from Object ) 

flush Overridden. Flushes the buffer representing the array of characters to be written. 

hashCode ___|(inherited from Object ) 

getClass (inherited from Object ) 

clone Creates a shallow copy of this reader. (inherited from Writer ) 

reset Resets the buffer holding the array of characters. All data currently in the buffer is discarded. 

size Returns the number of character in the buffer holding the array of characters since the object was created or last r 
eset. 

toCharArray|Populates an array of characters with the data held in the internal buffer. 

toString Overridden. Displays a human readable representation of a CharArrayWriter object. The contents of the buffer hol 
ding the array of characters is returned. 

write Overloaded. Writes the next character or characters into the array. 

writeTo Writes the contents of this CharArrayWriter object to another Writer object. 

Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 


CharArrayWriter Class 


Concepts 


java.io Package 
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CharArrayWriter.close Method 


Closes the writer once the array of characters has been processed. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void close(); 


Example 


The following example demonstrates how to close a CharArrayWriter object. 


// chararraywriter_close.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 

{ 
// Create a CharArrayWriter object that can hold 11 
// characters. 
CharArrayWriter writer = new CharArrayWriter(11) ; 


// Write some data to the CharArrayWriter object. 
char[] arr = new char[] {'H', ‘e', ‘l', 'l', 'o',7 
' "5 ‘W', ‘o',*, i eae ML rd }3 


for (int i = @; i < arr.length; i++) 


{ 
} 


// Print out the contents of the CharArrayWriter buffer. 
System.out.printlin("The CharArrayWriter buffer contains: 
writer.toCharArray()); 


writer.write(arr[i]); 


// Close the CharArrayWriter buffer. 
writer.close(); 


} 


/* 
Output: 
The CharArrayWriter buffer contains: Hello World 


7. 


Remarks 
This method does nothing for CharArrayWriter objects. 


See Also 

Reference 
CharArrayWriter Class 
Concepts 

CharArrayWriter Members 
java.io Package 
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CharArrayWriter.flush Method 


Flushes the buffer representing the array of characters to be written. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void flush(); 


Example 


The following example demonstrates that the flush method for CharArrayWriter objects has no effect on the underlying buffer. 


// chararraywriter_flush.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 


{ 
// Create a CharArrayWriter object that can hold 11 


// characters. 
CharArrayWriter writer = new CharArrayWriter(11) ; 


// Write some data to the CharArrayWriter object. 
char[] arr = new char[] {'H', ‘e', ‘l', 'l', 'o',7 
' "5 ‘W', ‘o',*, i eae ML rd }3 


for (int i = @; i < arr.length; i++) 


{ 
} 


// Print out the contents of the CharArrayWriter buffer. 
System.out.println("The CharArrayWriter buffer contains: " + 
writer.toCharArray()); 


writer.write(arr[i]); 


// Now flush the buffer we just populated. 
writer.flush(); 


// Print out the contents of the CharArrayWriter buffer. 
System.out.println("The post-flush CharArrayWriter buffer " + 
"contains: " + writer.toCharArray()); 


// Close the CharArrayWriter buffer. 
writer.close(); 


} 


/* 

Output: 

The CharArrayWriter buffer contains: Hello World 

The post-flush CharArrayWriter buffer contains: Hello World 
aa 4 


Remarks 


This method does nothing for CharArrayWriter objects. 


See Also 
Reference 
CharArrayWriter Class 


Concepts 
CharArrayWriter Members 
java.io Package 
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CharArrayWriter.reset Method 


Resets the buffer holding the array of characters. All data currently in the buffer is discarded. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void reset(); 


Example 


The following example demonstrates the effect of calling reset on a CharArrayWriter object. 


// chararraywriter_reset.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 

{ 
// Create a CharArrayWriter object that can hold 11 
// characters. 
CharArrayWriter writer = new CharArrayWriter(11) ; 


// Write some data to the CharArrayWriter object. 
char[] arr = new char[] {'H', ‘e', ‘l', 'l', 'o',7 
' "5 ‘W', ‘o',*, i eae ML rd }3 


for (int i = @; i < arr.length; i++) 


{ 
} 


// Print out the contents of the CharArrayWriter buffer. 
System.out.println("The CharArrayWriter buffer contains: " + 
writer.toCharArray()); 


writer.write(arr[i]); 


// Now reset the buffer we just populated. 
writer.reset(); 


// Print out the contents of the CharArrayWriter buffer. 
System.out.println("The post-reset CharArrayWriter buffer " + 
"contains: " + writer.toCharArray()); 


// Close the CharArrayWriter buffer. 
writer.close(); 


} 


/* 

Output: 

The CharArrayWriter buffer contains: Hello World 
The post-reset CharArrayWriter buffer contains: 


*/ 


See Also 

Reference 
CharArrayWriter Class 
Concepts 

CharArrayWriter Members 
java.io Package 
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CharArrayWriter.size Method 


Returns the number of character in the buffer holding the array of characters since the object was created or last reset. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int size(); 


Return Value 
The number of character in the buffer holding the array of characters since the object was created or last reset. 
Example 
The following example prints out the size of a CharArrayWriter buffer. 
// chararraywriter_size.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
try 
{ 
// Create a CharArrayWriter object that can hold 11 
// characters. 
CharArrayWriter writer = new CharArrayWriter(11) ; 
// Fill the buffer with some data. 
writer.write("E=mc2") ; 
// Display the size of the CharArrayWriter buffer. 
System.out.println("The size of the bufer is " + 
writer.size()); 
// Close the CharArrayWriter buffer. 
writer.close(); 
catch (IOException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 
} 
/* 
Output: 
The size of the bufer is 5 
=f 
See Also 
Reference 
CharArrayWriter Class 
Concepts 


CharArrayWriter Members 
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CharArrayWriter.toCharArray Method 


Populates an array of characters with the data held in the internal buffer. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public char[] toCharArray(); 


Return Value 
An array of characters holding the data contained in the internal buffer. 
Example 


The following example shows how to display the contents of the CharArrayWriter buffer. 
// chararraywriter_tochararray.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a CharArraywWriter object that can hold 11 
// characters. 
CharArrayWriter writer = new CharArrayWriter(11) ; 
// Write some data to the CharArrayWriter object. 
char[] arr = new char[] {'H', ‘e', ‘l', 'l', ‘'o',7 
' Oy ‘W', "0" pe, Ly "d' }3 
for (int i = @; i < arr.length; i++) 
i 
writer.write(arr[i]); 
// Print out the contents of the CharArrayWriter buffer. 
System.out.printin("The CharArrayWriter buffer contains: 
writer.toCharArray()); 
// Close the CharArrayWriter buffer. 
writer.close(); 
} 
} 
/* 
Output: 
The CharArrayWriter buffer contains: Hello World 
sa 
See Also 
Reference 
CharArrayWriter Class 
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CharArrayWriter.toString Method 


Displays a human readable representation of a CharArrayWriter object. The contents of the buffer holding the array of 
characters is returned. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toString(); 


Return Value 


A human readable representation of a CharArrayWriter object. The contents of the buffer holding the array of characters is 
returned. 


See Also 

Reference 
CharArrayWriter Class 
Concepts 

CharArrayWriter Members 
java.io Package 
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CharArrayWriter.write Method 


Writes the next character or characters into the array. 


Overload List 


Name Description 

CharArrayWriter.write (char[]) Places the given array of characters into the internal buffer holding the characters. 
CharArrayWriter.write (int) Places a character into the next position of the array of characters. 
CharArrayWriter.write (String) Places the given string into the internal buffer holding characters. 


CharArrayWriter.write (char[], int, int) Places the given array of characters, starting from the offset and for the length specified, 
into the internal buffer holding the array of characters. 


CharArrayWriter.write (String, int, int)/Places the given string, starting from the offset and for the length specified, into the inte 
rnal buffer holding the array of characters. 














See Also 

Reference 
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CharArrayWriter.write Method (Int32) 


Places a character into the next position of the array of characters. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
int b); 


Parameters 


b 
The character to be placed into the next position of the array. 
Example 
The following example shows how to write one character at a time to a CharArrayWriter object. 
// chararraywriter_write.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 


{ 
// Create a CharArrayWriter object that can hold 11 
// characters. 
CharArrayWriter writer = new CharArrayWriter(11) ; 
// Write some data to the CharArrayWriter object. 
char[] arr = new char[] {'H', ‘e', ‘l', 'l', ‘'o',7 
' m5 'W', ‘o',*, MIA 5 el aa ‘d' }3 
for (int i = @; i < arr.length; i++) 
{ 
writer.write(arr[i]); 
} 
// Print out the contents of the CharArrayWriter buffer. 
System.out.printin("The CharArrayWriter buffer contains: " + 
writer.toCharArray()); 
// Close the CharArrayWriter buffer. 
writer.close(); 
} 
} 
/* 
Output: 
The CharArrayWriter buffer contains: Hello World 
*/ 
See Also 
Reference 
CharArrayWriter Class 
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CharArrayWriter.write Method (Char[], Int32, Int32) 


Places the given array of characters, starting from the offset and for the length specified, into the internal buffer holding the 
array of characters. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
char[] b, 
int off, 
int len); 


Parameters 


b 


The array of characters to be written to the internal buffer. 


off 


An offset into the array of characters. This value represents the index of the first character in the array to be written to the 
internal buffer. This value must be greater than zero. 


len 


The number of characters to be written to the internal buffer starting from the offset. This value plus the offset must be less 
than the overall length of the array. 


Example 


The following example shows how to write an array of characters to an underlying CharArrayWriter buffer. 


// chararraywriter_write_2.jsl 
import java.io.*; 


public class Program 


{ 


public static void main(String[] args) 


1 
// Create a CharArraywWriter object that can hold 11 


// characters. 
CharArrayWriter writer = new CharArrayWriter(11) ; 


// Write some data to the CharArrayWriter object. 
char[] arr = new char[] {'H', ‘e', ‘l', 'l', 'o',7 
' ‘5 ‘W', ‘o',*, a aa oe a ‘d' }3 


// Start with the 7th character and write to the end. 
writer.write(arr, 6, arr.length - 6); 


// Print out the contents of the CharArrayWriter buffer. 
System.out.println("The CharArrayWriter buffer contains: + 
writer.toCharArray()); 


// Close the CharArrayWriter buffer. 
writer.close(); 


} 


/* 
Output: 
The CharArrayWriter buffer contains: World 


*/ 





See Also 
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CharArrayWriter.write Method (String, Int32, Int32) 


Places the given string, starting from the offset and for the length specified, into the internal buffer holding the array of 
characters. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
java.lang.String str, 
int off, 
int len); 


Parameters 
str 
The string to be written to the internal buffer. 


off 


An offset into the string. This value represents the index of the first character in the string to be written to the internal buffer. 
This value must be greater than zero. 


len 


The number of characters to be written to the internal buffer starting from the offset. This value plus the offset must be less 
than the overall length of the array. 


Example 

The following example shows how to write a string to an underlying CharArrayWriter buffer. 
// chararraywriter_write_3.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
1 
// Create a CharArrayWriter object that can hold 11 
// characters. 
CharArrayWriter writer = new CharArrayWriter(11) ; 
// Write some data to the CharArrayWriter object. 
// Start with the 7th character and write to the end. 
String s = "Hello World"; 
writer.write("Hello World", 6, s.length() - 6); 
// Print out the contents of the CharArrayWriter buffer. 
System.out.println("The CharArrayWriter buffer contains: " + 
writer.toCharArray()); 
// Close the CharArrayWriter buffer. 
writer.close(); 
} 
} 
/* 
Output: 
The CharArrayWriter buffer contains: World 
ef 


See Also 
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CharArrayWriter.writeTo Method 


Writes the contents of this CharArrayWriter object to another Writer object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void writeTo( 
java.io.Writer out) throws java.io. IOException; 


Parameters 
out 


The Writer object to write to. 
Example 
The following example shows how to write the contents of a CharArrayWriter object to a StringWriter object. 
// chararraywriter_writeto.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
try 
{ 
// Create a CharArrayWriter object that can hold 11 
// characters. 
CharArrayWriter writer = new CharArrayWriter(11) ; 
// Write some data to the CharArrayWriter object. 
// Start with the 7th character and write to the end. 
String s = "Hello World"; 
writer.write("Hello World", 6, s.length() - 6); 
// Write the contents of the CharArrayWriter object to 
// a String Writer object. 
StringWriter sWriter = new StringWriter(); 
writer.writeTo(swWriter) ; 
// Print out the contents of the StringWriter buffer. 
System.out.println("The StringWriter buffer contains: " + 
sWriter.toString()); 
// Close the CharArrayWriter and StringWriter buffers. 
writer.close(); 
sWriter.close(); 
} 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 


The StringWriter buffer contains: World 
ef 


See Also 
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CharConversionException Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.CharConversionException 
extends java.io.IOException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.io.IOException 
java.io.CharConversionException 


See Also 

Concepts 

CharConversionException Members 
java.io Package 
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CharConversionException Members 


The following tables list the members exposed by the CharConversionException type. 


Public Constructors 
Name 


CharConversionException 


Description 





Public Properties (see also Protected Properties ) 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 
Message 
Source 
StackTrace 


TargetSite 


Protected Properties 


(inherited from Exception ) 


(inherited from Exception ) 


(inherited from Exception ) 


(inherited from Exception ) 


(inherited from Exception ) 





Name 


Description 





HResult 





(inherited from Exception ) 





Public Methods 
Name 


equals 


filllnStackTrace 


GetBaseException 


hashCode 


getLocalizedMessage 


Description 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Exception ) 


(inherited from Object ) 


(inherited from Throwable ) 








getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 

clone (inherited from Throwable ) 





printStackTrace 


Overloaded. (inherited from Throwable ) 





toString 





(inherited from Throwable ) 








Protected Methods 
Name ——iescription —eeeess—Cs—SS 





See Also 

Reference 
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Concepts 
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CharConversionException Constructor 


Overload List 





Name 


Description 





CharConversionException () 





CharConversionException (String) 





CharConversionException (SerializationInfo, StreamingContext) 





CharConversionException (String, Exception) 








See Also 

Reference 
CharConversionException Class 
Concepts 

CharConversionException Members 
java.io Package 
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CharConversionException Constructor () 


Initializes a new instance of the CharConversionException Class . 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.CharConversionException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
CharConversionException Class 
Concepts 

CharConversionException Members 
java.io Package 
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CharConversionException Constructor (String) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.CharConversionException( 
java.lang.String s); 


Parameters 
S 


See Also 

Reference 
CharConversionException Class 
Concepts 

CharConversionException Members 
java.io Package 


Visual J# Reference 


CharConversionException Constructor (SerializationInfo, 
StreamingContext) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected java.io.CharConversionException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


context 


See Also 

Reference 
CharConversionException Class 
Concepts 

CharConversionException Members 
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CharConversionException Constructor (String. Exception) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.CharConversionException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
S 


inner 


See Also 

Reference 
CharConversionException Class 
Concepts 

CharConversionException Members 
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CharConversionException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 
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CharConversionException Class 


Concepts 
java.io Package 
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CharConversionException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 


CharConversionException Class 


Concepts 
java.io Package 
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Datalnput Interface 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public interface java.io.DataInput 





See Also 

Concepts 

Datalnput Members 
java.io Package 
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Datalnput Members 


The following tables list the members exposed by the Datalnput type. 


Public Methods 
Name 


readBoolean 


readByte 


readChar 


readDouble 


Description 





readFloat 





readFully 


Overloaded. 





readint 





readLine 





readLong 





readShort 





readUnsignedByte 





readUnsignedShort 





readUTF 





skipBytes 








See Also 
Reference 
Datalnput Interface 
Concepts 

java.io Package 
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Datalnput Methods 


Public Methods 





Name 


Description 





readBoolean 





readByte 





readChar 





readDouble 





readFloat 


readFully 


readint 


readLine 


readLong 


readShort 


readUnsignedByte 


readUnsignedShort 


readUTF 


skipBytes 





See Also 
Reference 
Datalnput Interface 
Concepts 

java.io Package 


Overloaded. 
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Datalnput.readBoolean Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean readBoolean() throws java.io. IOException; 


See Also 

Reference 
Datalnput Interface 
Concepts 

Datalnput Members 
java.io Package 
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Datalnput.readByte Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract byte readByte() throws java.io. IOException; 


See Also 

Reference 
Datalnput Interface 
Concepts 

Datalnput Members 
java.io Package 
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Datalnput.readChar Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract char readChar() throws java.io. IOException; 


See Also 

Reference 
Datalnput Interface 
Concepts 

Datalnput Members 
java.io Package 


Visual J# Reference 


Datalnput.readDouble Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract double readDouble() throws java.io. IOException; 


See Also 

Reference 
Datalnput Interface 
Concepts 

Datalnput Members 
java.io Package 
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Datalnput.readFloat Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract float readFloat() throws java.io. IOException; 


See Also 

Reference 
Datalnput Interface 
Concepts 

Datalnput Members 
java.io Package 
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Datalnput.readFully Method 


Overload List 





Name 


Description 





Datalnput.readFully (byte[]) 





Datalnput.readFully (bytef], int, int) 











See Also 
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Concepts 

Datalnput Members 
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Datalnput.readFully Method (SByte[]) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract void readFully( 
byte[] buffer) throws java.io. IOException; 


Parameters 


buffer 


See Also 

Reference 
Datalnput Interface 
Concepts 

Datalnput Members 
java.io Package 
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Datalnput.readFully Method (SByte [], Int32, Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract void readFully( 
byte[] buffer, 
int offset, 
int count) throws java.io. IOException; 


Parameters 


buffer 
offset 
count 


See Also 

Reference 
Datalnput Interface 
Concepts 

Datalnput Members 
java.io Package 
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Datalnput.readint Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract int readInt() throws java.io. IOException; 


See Also 

Reference 
Datalnput Interface 
Concepts 

Datalnput Members 
java.io Package 
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Datalnput.readLine Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String readLine() throws java.io. IOException; 


See Also 

Reference 
Datalnput Interface 
Concepts 

Datalnput Members 
java.io Package 


Visual J# Reference 


Datalnput.readLong Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract long readLong() throws java.io. IOException; 


See Also 

Reference 
Datalnput Interface 
Concepts 

Datalnput Members 
java.io Package 
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Datalnput.readShort Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract short readShort() throws java.io. IOException; 


See Also 

Reference 
Datalnput Interface 
Concepts 

Datalnput Members 
java.io Package 
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Datalnput.readUnsignedByte Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract int readUnsignedByte() throws java.io. IOException; 


See Also 

Reference 
Datalnput Interface 
Concepts 

Datalnput Members 
java.io Package 
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Datalnput.readUnsignedShort Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract int readUnsignedShort() throws java.io. IOException; 


See Also 

Reference 
Datalnput Interface 
Concepts 

Datalnput Members 
java.io Package 
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Datalnput.readUTF Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String readUTF() throws java.io. IOException; 


See Also 

Reference 
Datalnput Interface 
Concepts 

Datalnput Members 
java.io Package 
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Datalnput.skipBytes Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract int skipBytes( 
int count) throws java.io. IOException; 


Parameters 
count 


See Also 

Reference 
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DatalnputStream Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public class java.io.DataInputStream 
extends java.io.FilterInputStream 
implements java.io.DataInput 





Inheritance Hierarchy 
java.lang.Object 
java.io.InputStream 
java.io.FilterInputStream 
java.io.DatalnputStream 


See Also 

Concepts 

DatalnputStream Members 
java.io Package 
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DatalnputStream Members 


The following tables list the members exposed by the DatalnputStream type. 


Public Constructors 
Name 


DatalnputStream 





Public Fields 





Name Description 





in (inherited from FilterInputStream ) 





Public Methods 
































Name Description 

available (inherited from FilterlnputStream ) 
close (inherited from FilterInputStream ) 
equals (inherited from Object ) 

hashCode (inherited from Object ) 

getClass (inherited from Object ) 

mark (inherited from FilterInputStream ) 
markSupported (inherited from FilterInputStream ) 
clone (inherited from InputStream ) 

read Overloaded. Overridden. 





readBoolean 





readByte 





readChar 





readDouble 





readFloat 





readFully Overloaded. 


readint 


readLine 


readLong 











readShort 





readUnsignedByte 


readUnsignedShort 
readUTF 

reset 

skip 

skipBytes 


toString 


Overloaded. 


(inherited from FilterInputStream ) 


(inherited from FilterInputStream ) 


(inherited from InputStream ) 





Name 


finalize 





See Also 
Reference 


DatalnputStream Class 


Concepts 
java.io Package 


Protected Methods 





(inherited from Object ) 
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DatalnputStream Fields 


Public Fields 

















Name Description 

in (inherited from FilterInputStream ) 
See Also 

Reference 

DatalnputStream Class 

Concepts 


java.io Package 


Visual J# Reference 


DatalnputStream Constructor 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.DataInputStream( 
java.io.InputStream in); 





Parameters 
in 


See Also 

Reference 
DatalnputStream Class 
Concepts 

DatalnputStream Members 
java.io Package 


Visual J# Reference 


DatalnputStream Methods 


Public Methods 




















Name Description 

available (inherited from FilterInputStream ) 
close (inherited from FilterInputStream ) 
equals (inherited from Object ) 

hashCode (inherited from Object ) 

getClass (inherited from Object ) 

mark (inherited from FilterInputStream ) 
markSupported (inherited from FilterInputStream ) 
clone (inherited from InputStream ) 

read Overloaded. Overridden. 


readBoolean 

readByte 

readChar 

readDouble 

readFloat 

readFully Overloaded. 
readint 

readLine 

readLong 

readShort 


readUnsignedByte 











readUnsignedShort 
readUTF Overloaded. 
reset (inherited from FilterlnputStream ) 





skip (inherited from FilterlInputStream ) 














skipBytes 





toString 


(inherited from InputStream ) 





Protected Methods 
Name 


finalize 





See Also 

Reference 
DatalnputStream Class 
Concepts 

java.io Package 





(inherited from Object ) 





Visual J# Reference 


DatalnputStream.read Method 


Overload List 





Name 


Description 





DatalnputStream.read () 





DatalnputStream.read (byte[]) 





DatalnputStream.read (byte[], int, int) 











See Also 

Reference 
DatalnputStream Class 
Concepts 

DatalnputStream Members 
java.io Package 





Visual J# Reference 


DatalnputStream.read Method () 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final int read() throws java.io. IOException; 


See Also 

Reference 
DatalnputStream Class 
Concepts 

DatalnputStream Members 
java.io Package 
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DatalnputStream.read Method (SByte[]) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final int read( 
byte[] b) throws java.io. IOException; 


Parameters 


b 


See Also 

Reference 
DatalnputStream Class 
Concepts 

DatalnputStream Members 
java.io Package 
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DatalnputStream.read Method (SByte[], Int32, Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final int read( 
byte[] b, 
int off, 
int len) throws java.io. IOException; 


Parameters 


b 


off 
len 


See Also 

Reference 
DatalnputStream Class 
Concepts 

DatalnputStream Members 
java.io Package 
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DatalnputStream.readBoolean Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final boolean readBoolean() throws java.io. IOException; 


See Also 

Reference 
DatalnputStream Class 
Concepts 

DatalnputStream Members 
java.io Package 
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DatalnputStream.readByte Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final byte readByte() throws java.io. IOException; 


See Also 

Reference 
DatalnputStream Class 
Concepts 

DatalnputStream Members 
java.io Package 
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DatalnputStream.readChar Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final char readChar() throws java.io. IOException; 


See Also 

Reference 
DatalnputStream Class 
Concepts 

DatalnputStream Members 
java.io Package 
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DatalnputStream.readDouble Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final double readDouble() throws java.io. IOException; 


See Also 

Reference 
DatalnputStream Class 
Concepts 

DatalnputStream Members 
java.io Package 


Visual J# Reference 


DatalnputStream.readFloat Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final float readFloat() throws java.io. IOException; 


See Also 

Reference 
DatalnputStream Class 
Concepts 

DatalnputStream Members 
java.io Package 
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DatalnputStream.readFully Method 


Overload List 





Name 


Description 





DatalnputStream.readFully (byte[]) 





DatalnputStream.readFully (byte[], int, int) 











See Also 

Reference 
DatalnputStream Class 
Concepts 

DatalnputStream Members 
java.io Package 
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DatalnputStream.readFully Method (SByte [ ]) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final void readFully( 
byte[] b) throws java.io. IOException; 


Parameters 


b 


See Also 

Reference 
DatalnputStream Class 
Concepts 

DatalnputStream Members 
java.io Package 


Visual J# Reference 


DatalnputStream.readFully Method (SByte [ J, Int32, Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final void readFully( 
byte[] b, 
int off, 
int len) throws java.io. IOException; 


Parameters 


b 


off 
len 


See Also 

Reference 
DatalnputStream Class 
Concepts 

DatalnputStream Members 
java.io Package 
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DatalnputStream.readiInt Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final int readInt() throws java.io. IOException; 


See Also 

Reference 
DatalnputStream Class 
Concepts 

DatalnputStream Members 
java.io Package 


Visual J# Reference 


DatalnputStream.readLine Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final java.lang.String readLine() throws java.io. IOException; 


See Also 

Reference 
DatalnputStream Class 
Concepts 

DatalnputStream Members 
java.io Package 


Visual J# Reference 


DatalnputStream.readLong Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final long readLong() throws java.io. IOException; 


See Also 

Reference 
DatalnputStream Class 
Concepts 

DatalnputStream Members 
java.io Package 


Visual J# Reference 


DatalnputStream.readShort Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final short readShort() throws java.io. IOException; 


See Also 

Reference 
DatalnputStream Class 
Concepts 

DatalnputStream Members 
java.io Package 


Visual J# Reference 


DatalnputStream.readUnsignedByte Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final int readUnsignedByte() throws java.io. IOException; 


See Also 

Reference 
DatalnputStream Class 
Concepts 

DatalnputStream Members 
java.io Package 


Visual J# Reference 


DatalnputStream.readUnsignedShort Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final int readUnsignedShort() throws java.io. IOException; 


See Also 

Reference 
DatalnputStream Class 
Concepts 

DatalnputStream Members 
java.io Package 
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DatalnputStream.readUTF Method 


Overload List 





Name Description 





DatalnputStream.readUTF () 





DatalnputStream.readUTF (Datalnput) 











See Also 

Reference 
DatalnputStream Class 
Concepts 

DatalnputStream Members 
java.io Package 
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DatalnputStream.readUTF Method () 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final java.lang.String readUTF() throws java.io. IOException; 


See Also 

Reference 
DatalnputStream Class 
Concepts 

DatalnputStream Members 
java.io Package 
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DatalnputStream.readUTF Method (Datalnput) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.String readUTF( 
java.io.DataInput din) throws java.io. IOException; 


Parameters 


din 


See Also 

Reference 
DatalnputStream Class 
Concepts 

DatalnputStream Members 
java.io Package 
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DatalnputStream.skipBytes Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final int skipBytes( 
int n) throws java.io.IOException; 


Parameters 
n 


See Also 

Reference 
DatalnputStream Class 
Concepts 

DatalnputStream Members 
java.io Package 
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DataOutput Interface 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public interface java.io.DataOutput 





See Also 

Concepts 

DataOutput Members 
java.io Package 


Visual J# Reference 


DataOutput Members 


The following tables list the members exposed by the DataOutput type. 


Public Methods 
Name Description 


write Overloaded. 
writeBoolean 
writeByte 


writeBytes 





writeChar 





writeChars 





writeDouble 





writeFloat 





writelnt 





writeLong 





writeShort 





writeUTF 














See Also 

Reference 
DataOutput Interface 
Concepts 

java.io Package 


Visual J# Reference 


DataOutput Methods 


Public Methods 





Name Description 





write Overloaded. 





writeBoolean 





writeByte 





writeBytes 





writeChar 


writeChars 


writeDouble 


writeFloat 


writelnt 


writeLong 


writeShort 


writeUTF 








See Also 

Reference 
DataOutput Interface 
Concepts 

java.io Package 
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DataOutput.write Method 


Overload List 





Name 


Description 





DataOutput.write (int) 





DataOutput.write (byte[]) 





DataOutput.write (bytel[], int, int) 











See Also 

Reference 
DataOutput Interface 
Concepts 

DataOutput Members 
java.io Package 
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DataOutput.write Method (Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract void write( 
int oneByte) throws java.io.IOException; 


Parameters 
oneByte 


See Also 

Reference 
DataOutput Interface 
Concepts 

DataOutput Members 
java.io Package 


Visual J# Reference 


DataOutput.write Method (SByte[]) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract void write( 
byte[] buffer) throws java.io. IOException; 


Parameters 


buffer 


See Also 

Reference 
DataOutput Interface 
Concepts 

DataOutput Members 
java.io Package 
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DataOutput.write Method (SByte[], Int32, Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract void write( 
byte[] buffer, 
int offset, 
int count) throws java.io. IOException; 


Parameters 


buffer 
offset 
count 


See Also 

Reference 
DataOutput Interface 
Concepts 

DataOutput Members 
java.io Package 
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DataOutput.writeBoolean Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract void writeBoolean( 
boolean val) throws java.io. IOException; 


Parameters 
val 


See Also 

Reference 
DataOutput Interface 
Concepts 

DataOutput Members 
java.io Package 
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DataOutput.writeByte Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract void writeByte( 
int val) throws java.io.IOException; 


Parameters 
val 


See Also 

Reference 
DataOutput Interface 
Concepts 

DataOutput Members 
java.io Package 
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DataOutput.writeBytes Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract void writeBytes( 
java.lang.String str) throws java.io. IOException; 


Parameters 
str 


See Also 

Reference 
DataOutput Interface 
Concepts 

DataOutput Members 
java.io Package 
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DataOutput.writeChar Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract void writeChar( 
int val) throws java.io. IOException; 


Parameters 
val 


See Also 

Reference 
DataOutput Interface 
Concepts 

DataOutput Members 
java.io Package 
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DataOutput.writeChars Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract void writeChars( 
java.lang.String str) throws java.io. IOException; 


Parameters 
str 


See Also 

Reference 
DataOutput Interface 
Concepts 

DataOutput Members 
java.io Package 
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DataOutput.writeDouble Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract void writeDouble( 
double val) throws java.io. IOException; 


Parameters 
val 


See Also 

Reference 
DataOutput Interface 
Concepts 

DataOutput Members 
java.io Package 
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DataOutput.writeFloat Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract void writeFloat( 
float val) throws java.io. IOException; 


Parameters 
val 


See Also 

Reference 
DataOutput Interface 
Concepts 

DataOutput Members 
java.io Package 
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DataOutput.writelnt Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract void writeInt( 
int val) throws java.io.IOException; 


Parameters 
val 


See Also 

Reference 
DataOutput Interface 
Concepts 

DataOutput Members 
java.io Package 
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DataOutput.writeLong Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract void writeLong( 
long val) throws java.io.IOException; 


Parameters 
val 


See Also 

Reference 
DataOutput Interface 
Concepts 

DataOutput Members 
java.io Package 
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DataOutput.writeShort Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract void writeShort( 
int val) throws java.io. IOException; 


Parameters 
val 


See Also 

Reference 
DataOutput Interface 
Concepts 

DataOutput Members 
java.io Package 
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DataOutput.writeUTF Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract void writeUTF( 
java.lang.String str) throws java.io. IOException; 


Parameters 
str 


See Also 

Reference 
DataOutput Interface 
Concepts 

DataOutput Members 
java.io Package 
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DataOutputStream Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public class java.io.DataOutputStream 
extends java.io.FilterOutputStream 
implements java.io.DataOutput 





Inheritance Hierarchy 
java.lang.Object 
java.io.OutputStream 
java.io.FilterOutputStream 
java.io.DataOutputStream 


See Also 

Concepts 

DataOutputStream Members 
java.io Package 
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DataOutputStream Members 


The following tables list the members exposed by the DataOutputStream type. 


Public Constructors 
Name 


DataOutputStream 





Public Fields 











Name Description 
out (inherited from FilterOutputStream ) 
written 








Public Methods 



































Name Description 

close (inherited from FilterOutputStream ) 
equals (inherited from Object ) 

flush Overridden. 

hashCode (inherited from Object ) 

getClass (inherited from Object ) 

clone (inherited from OutputStream ) 

size 

toString (inherited from OutputStream ) 
write Overloaded. Overridden. 





writeBoolean 





writeByte 





writeBytes 





writeChar 





writeChars 


writeDouble 


writeFloat 


writelnt 











writeLong 





writeShort 


writeUTF 








Protected Methods 








Name Description 





finalize (inherited from Object ) 














See Also 

Reference 
DataOutputStream Class 
Concepts 

java.io Package 


Visual J# Reference 


DataOutputStream Fields 


Public Fields 





Name Description 





out (inherited from FilterOutputStream ) 





written 














See Also 

Reference 
DataOutputStream Class 
Concepts 

java.io Package 


Visual J# Reference 


DataOutputStream.written Field 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected int written; 


See Also 

Reference 
DataOutputStream Class 
Concepts 

DataOutputStream Members 
java.io Package 
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DataOutputStream Constructor 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.DataOutputStream( 
java.io.OutputStream out); 





Parameters 
out 


See Also 

Reference 
DataOutputStream Class 
Concepts 

DataOutputStream Members 
java.io Package 
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DataOutputStream Methods 


Public Methods 




















Name Description 

close (inherited from FilterOutputStream ) 
equals (inherited from Object ) 

flush Overridden. 

hashCode (inherited from Object ) 

getClass (inherited from Object ) 

clone (inherited from OutputStream ) 

size 

toString (inherited from OutputStream ) 
write Overloaded. Overridden. 


writeBoolean 


writeByte 


writeBytes 


writeChar 


writeChars 


writeDouble 


writeFloat 


writelnt 


writeLong 


writeShort 


writeUTF 





Protected Methods 


Name Description 


finalize (inherited from Object ) 








See Also 
Reference 


DataOutputStream Class 





Concepts 
java.io Package 
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DataOutputStream.flush Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void flush() throws java.io. IOException; 


See Also 

Reference 
DataOutputStream Class 
Concepts 

DataOutputStream Members 
java.io Package 


Visual J# Reference 


DataOutputStream.size Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final int size(); 


See Also 

Reference 
DataOutputStream Class 
Concepts 

DataOutputStream Members 
java.io Package 


Visual J# Reference 


DataOutputStream.write Method 


Overload List 





Name Description 





DataOutputStream.write (int) 





DataOutputStream.write (byte[]) 





DataOutputStream.write (byte[], int, int) 











See Also 

Reference 
DataOutputStream Class 
Concepts 

DataOutputStream Members 
java.io Package 
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DataOutputStream.write Method (Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized void write( 
int b) throws java.io. IOException; 


Parameters 


b 


See Also 

Reference 
DataOutputStream Class 
Concepts 

DataOutputStream Members 
java.io Package 
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DataOutputStream.write Method (SByte[], Int32, Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized void write( 
byte[] b, 
int off, 
int len) throws java.io.IOException; 


Parameters 


b 


off 
len 


See Also 

Reference 
DataOutputStream Class 
Concepts 

DataOutputStream Members 
java.io Package 
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DataOutputStream.writeBoolean Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final void writeBoolean( 
boolean v) throws java.io. IOException; 


Parameters 
V 


See Also 

Reference 
DataOutputStream Class 
Concepts 

DataOutputStream Members 
java.io Package 


Visual J# Reference 


DataOutputStream.writeByte Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final void writeByte( 
int v) throws java.io. IOException; 


Parameters 
V 


See Also 

Reference 
DataOutputStream Class 
Concepts 

DataOutputStream Members 
java.io Package 
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DataOutputStream.writeBytes Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final void writeBytes( 
java.lang.String s) throws java.io. IOException; 


Parameters 
S 


See Also 

Reference 
DataOutputStream Class 
Concepts 

DataOutputStream Members 
java.io Package 


Visual J# Reference 


DataOutputStream.writeChar Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final void writeChar ( 
int v) throws java.io.IOException; 


Parameters 
V 


See Also 

Reference 
DataOutputStream Class 
Concepts 

DataOutputStream Members 
java.io Package 
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DataOutputStream.writeChars Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final void writeChars( 
java.lang.String s) throws java.io. IOException; 


Parameters 
S 


See Also 

Reference 
DataOutputStream Class 
Concepts 

DataOutputStream Members 
java.io Package 
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DataOutputStream.writeDouble Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final void writeDouble( 
double v) throws java.io. IOException; 


Parameters 
V 


See Also 

Reference 
DataOutputStream Class 
Concepts 

DataOutputStream Members 
java.io Package 
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DataOutputStream.writeFloat Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final void writeFloat( 
float v) throws java.io. IOException; 


Parameters 
V 


See Also 

Reference 
DataOutputStream Class 
Concepts 

DataOutputStream Members 
java.io Package 
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DataOutputStream.writelnt Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final void writeInt( 
int v) throws java.io. IOException; 


Parameters 
V 


See Also 

Reference 
DataOutputStream Class 
Concepts 

DataOutputStream Members 
java.io Package 
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DataOutputStream.writeLong Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final void writeLong( 
long v) throws java.io.IOException; 


Parameters 
V 


See Also 

Reference 
DataOutputStream Class 
Concepts 

DataOutputStream Members 
java.io Package 
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DataOutputStream.writeShort Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final void writeShort( 
int v) throws java.io. IOException; 


Parameters 
V 


See Also 

Reference 
DataOutputStream Class 
Concepts 

DataOutputStream Members 
java.io Package 


Visual J# Reference 


DataOutputStream.writeUTF Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final void writeUTF( 
java.lang.String s) throws java.io. IOException; 


Parameters 
S 


See Also 

Reference 
DataOutputStream Class 
Concepts 

DataOutputStream Members 
java.io Package 
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EOFException Class 


The exception that is thrown when an attempt is made to read past the end of a file. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public class java.io.EOFException 
extends java.io.IOException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.io.IOException 
java.io.EOFException 


See Also 

Concepts 

EOFException Members 
java.io Package 
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EOFException Members 


The exception that is thrown when an attempt is made to read past the end of a file. 


The following tables list the members exposed by the EOFException type. 


Public Constructors 





Name Description 








EOFException Overloaded. Initializes a new instance of an EOFException object. 





Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 





Description 


(inherited from Exception ) 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 








printStackTrace 





getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 

clone (inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 








toString 


(inherited from Throwable ) 





Protected Methods 
Name 


finalize 





See Also 
Reference 
EOFException Class 
Concepts 

java.io Package 





(inherited from Object ) 
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EOFException Constructor 


Initializes a new instance of an EOFException object. 


Overload List 


Name Description 

EOFException () Initializes a new instance of an EOFException object. 

EOFException (String) Initializes a new instance of an EOFException object with the given messag 
e. 





EOFException (SerializationInfo, StreamingContext)|Initializes a new instance of an EOFException object during deserialization. 





EOFException (String, Exception) Initializes a new instance of an EOFException object with the given messag 
e and inner exception. 














See Also 

Reference 
EOFException Class 
Concepts 

EOFException Members 
java.io Package 
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EOFException Constructor () 


Initializes a new instance of an EOFException object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public java.io.EOFException(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
EOFException Class 
Concepts 

EOFException Members 
java.io Package 
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EOFException Constructor (String) 


Initializes a new instance of an EOFException object with the given message. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io. EOFException( 
java.lang.String s); 


Parameters 
Ss 


A message describing the exceptional condition. 


See Also 

Reference 
EOFException Class 
Concepts 

EOFException Members 
java.io Package 
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EOFException Constructor (SerializationInfo, 
StreamingContext) 


Initializes a new instance of an EOFException object during deserialization. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected java.io.EOFException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
EOFException Class 
Concepts 

EOFException Members 
java.io Package 
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EOFException Constructor (String, Exception) 


Initializes a new instance of an EOFException object with the given message and inner exception. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io. EOFException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the exceptional condition. 
inner 
An inner exception that led to the EOFException. 


See Also 

Reference 
EOFException Class 
Concepts 

EOFException Members 
java.io Package 
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EOFException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


EOFException Class 
Concepts 
java.io Package 
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EOFException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 
EOFException Class 
Concepts 

java.io Package 
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File Class 


Contains methods to access, create, or edit files and folders on disk. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.File 

extends java.lang.Object 

implements java.io.Serializable, java.lang.Comparable, System.Runtime.Serialization.ISe 
rializable 


Example 


The following example demonstrates the createNewFile, deleteOnExit, exists, getAbsolutePath, getCanonicalPath, getName, 
getParent, getPath, isDirectory, isFile, isHidden, lastModified, length, listRoots, renameTo, and toURL methods of the File class. 


// file_overview.jsl 
import java.io.*; 
import java.net.*; 


import java.util.Date; 


public class Program 


{ 
public static void main(String[] args) 
{ 
try 
{ 


// Create a file object using C:\AnyFile.txt. 
File anyFile = new File("C:\\Windows\\..\\AnyFile.txt"); 


// If the file doesn't exist, create it now. 
if (!anyFile.exists()) 


if (!anyFile.createNewFile()) 
System.out.println("Unable to create file " + 
anyFile.getAbsolutePath() + "!"); 


} 


// Delete the file when we no longer need it. 
anyFile.deleteOnExit(); 


// Display some useful information about this file. 
System.out.println( 
"getAbsolutePath: " + anyFile.getAbsolutePath() + "\n" + 
"getCanonicalPath: " + anyFile.getCanonicalPath() + "\n" + 
"getName: " + anyFile.getName() + "\n" + 
"getParent: " + anyFile.getParent() + "\n" + 
"getPath: " + anyFile.getPath() + "\n" + 
"isDirectory: " + anyFile.isDirectory() + "\n" + 
"“isFile: " + anyFile.isFile() + "\n" + 
"isHidden: " + anyFile.isHidden() + "\n" + 
"lastModified: " + new Date( 
anyFile.lastModified()).toString() + "\n" + 
"length: " + anyFile.length() + "\n" + 
"toURL: " + anyFile.toURL().toString()); 


// List the root directories of the system. 
File[] roots = anyFile.listRoots(); 
System.out.print("listRoots: "); 


for (int i = @; i < roots.length; i++) 


{ 
} 


// Rename the file. 
File newName = new File("C:\\NewName.txt"); 
if (!anyFile.renameTo(newName) ) 


System.out.print(roots[i].getAbsolutePath() + " "); 


if 
System.out.printin("\nError renaming " + 
anyFile.getAbsolutePath() + " to " + 
newName.getAbsolutePath()); 
} 
else 
1 
System.out.println("\nrenameTo: " + 
newName.getAbsolutePath()); 
} 
} 
catch (IOException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 
} 
/* 
Output: 


getAbsolutePath: C:\Windows\..\AnyFile.txt 
getCanonicalPath: C:\AnyFile.txt 

getName: AnyFile.txt 

getParent: C:\Windows\.. 

getPath: C:\Windows\..\AnyFile.txt 
isDirectory: false 

isFile: true 

isHidden: false 

lastModified: Fri Sep 17 13:14:37 PDT 2004 
length: @ 

toURL: file:/C:/AnyFile.txt 

listRoots: A:\ C:\ D:\ J:\ 

renameTo: C:\NewName.txt 


*/ 
Inheritance Hierarchy 
java.lang.Object 


java.io.File 


See Also 
Concepts 

File Members 
java.io Package 
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File Members 


Contains methods to access, create, or edit files and folders on disk. 


The following tables list the members exposed by the File type. 


Public Constructors 





Name Description 





File Overloaded. Initializes a new instance of a File object. 








Public Fields 
Name Description 


pathSeparator Represents the string used to separate elements in the PATH environment variable. On Windows, this is re 
presented by a semicolon (;). On Unix, it is represented by a colon (:). 


pathSeparatorChar/Represents the character used to separate elements in the PATH environment variable. On Windows, this is 
represented by a semicolon (;). On Unix, it is represented by a colon (:). 





separator Represents the string used to separate directories. On Windows, this is represented by a backslash (\). On 
Unix, it is represented by a forward slash (/). 


separatorChar Represents the character used to separate directories. On Windows, this is represented by a backslash (\). 
On Unix, it is represented by a forward slash (/). 





Public Methods 


Name Description 
canRead Determines whether a file or folder can be read. 
canWrite Determines whether a file or folder can be written to. 


compareTo Overloaded. Compares two File objects for equality. 

createNewFile —/Creates on disk the file or folder that is represented by the File object. 

createTempFile |Overloaded. Creates on disk a temporary file or folder. 
delete Deletes the file or folder represented by the File object. 


deleteOnExit Deletes the file or folder when the object is no longer needed and the system reclaims the object through ga 
rbage collection. 








equals Overridden. Compares two File objects for equality. 

exists Determines whether the file or folder exists on disk. 

finalize Overridden. Reclaims the memory associated with a File object when it is no longer needed by the applicatio 
n. 





getAbsoluteFile |Creates a new instance of a File object representing the file located at the absolute path of the current File ob 
ject. 


getAbsolutePath |Displays the absolute path of the file. 














getCanonicalFile 


Creates a new instance of a File object representing the file located at the absolute path of the current File ob 
jject. All '.' and '..' references will be resolved. 





getCanonicalPath 


Displays the absolute path of the file. All '.' and '..' references will be resolved. 














hashCode Overridden. Returns a hash value that is suitable for use in hashing algorithms. 
getName Retrieves the name of the file without the directory. 

GetObjectData [Retrieves the data to be serialized. 

getParent Retrieves the path name of the parent directory of the file. 





getParentFile 


Creates a new instance of a File object representing the parent directory of the file. 




















getPath Displays the directory of the file. 

getClass (inherited from Object ) 

isAbsolute Determines whether the pathname of the file or folder is absolute. 

isDirectory Determines whether the pathname of the object represented by a File object is a directory. 

isFile Determines whether the pathname of the object represented by a File object is a file. 

isHidden Determines whether the file or folder is hidden. 

lastModified Retrieves the time of the last modification to the file or folder, in milliseconds since epoch. 

length Retrieves the size of the file or folder, in bytes. 

list Overloaded. Lists the files or folders in the directory represented by this object. 

listFiles Overloaded. Creates instances of new File objects representing all the files or folders in the directory represe 
nted by this object. 

listRoots Creates instances of new File objects representing all the base, or root, paths of the system. 

clone Creates a shallow copy of the current File object. 

mkdir Creates the directory on disk represented by this object. 

mkdirs Creates the directory and all parent directories on disk represented by this object. 

renameTo Renames the file or folder to the name of the destination file or folder. 


setLastModified 


setReadOnly 


toString 


toURL 


Sets the time of the last modification to the file or folder. 


Sets the value indicating whether the file or folder is read-only. 


Overridden. Displays a human readable representation of a file or folder. 


Converts a file or folder into a URL (Uniform Resource Locator). 








See Also 
Reference 

File Class 
Concepts 
java.io Package 
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File Fields 


Public Fields 
Name Description 








pathSeparator Represents the string used to separate elements in the PATH environment variable. On Windows, this is re 
presented by a semicolon (;). On Unix, it is represented by a colon (:). 





pathSeparatorChar/Represents the character used to separate elements in the PATH environment variable. On Windows, this is 
represented by a semicolon (;). On Unix, it is represented by a colon (:). 











separator Represents the string used to separate directories. On Windows, this is represented by a backslash (\). On 
Unix, it is represented by a forward slash (/). 

separatorChar Represents the character used to separate directories. On Windows, this is represented by a backslash (\). 
On Unix, it is represented by a forward slash (/). 

See Also 

Reference 

File Class 

Concepts 


java.io Package 
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File.pathSeparator Field 


Represents the string used to separate elements in the PATH environment variable. On Windows, this is represented by a 
semicolon (;). On Unix, it is represented by a colon (:). 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.String pathSeparator; 


See Also 
Reference 

File Class 
Concepts 

File Members 
java.io Package 
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File.pathSeparatorChar Field 


Represents the character used to separate elements in the PATH environment variable. On Windows, this is represented by a 
semicolon (;). On Unix, it is represented by a colon (:). 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public static final char pathSeparatorChar; 


See Also 
Reference 

File Class 
Concepts 

File Members 
java.io Package 
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File.separator Field 


Represents the string used to separate directories. On Windows, this is represented by a backslash (\). On Unix, it is 
represented by a forward slash (/). 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.String separator; 


See Also 
Reference 

File Class 
Concepts 

File Members 
java.io Package 
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File.separatorChar Field 


Represents the character used to separate directories. On Windows, this is represented by a backslash (\). On Unix, it is 
represented by a forward slash (/). 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public static final char separatorChar; 


See Also 
Reference 

File Class 
Concepts 

File Members 
java.io Package 
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File Constructor 


Initializes a new instance of a File object. 


Overload List 





Name Description 
File (String) Initializes a new instance of a File object at the given path. 
File (File, String) Initializes a new instance of a File object at the given directory and with the given na 


me. 





File (SerializationInfo, StreamingContext)|Initializes a new instance of a File object during deserialization. 














File (String, String) Initializes a new instance of a File object at the given directory and with the given na 
me. 

See Also 

Reference 

File Class 

Concepts 


File Members 
java.io Package 
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File Constructor (String) 


Initializes a new instance of a File object at the given path. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.File( 
java.lang.String path); 


Parameters 


path 
The name of the file or folder to be accessed or created. This can be an absolute or relative value. 


See Also 
Reference 

File Class 
Concepts 

File Members 
java.io Package 
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File Constructor (File, String) 


Initializes a new instance of a File object at the given directory and with the given name. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.File( 
java.io.File dir, 
java.lang.String name); 


Parameters 


dir 
A File object containing the directory of the file or folder. 
name 
The name of the file or folder to be accessed or created in the given directory. 


See Also 
Reference 

File Class 
Concepts 

File Members 
java.io Package 
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File Constructor (SerializationInfo, StreamingContext) 


Initializes a new instance of a File object during deserialization. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected java.io.File( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 
Reference 

File Class 
Concepts 

File Members 
java.io Package 
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File Constructor (String, String) 


Initializes a new instance of a File object at the given directory and with the given name. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.File( 
java.lang.String dirPath, 
java.lang.String name); 


Parameters 


dirPath 
The directory containing the file or folder. 
name 
The name of the file or folder to be accessed or created in the given directory. 


See Also 
Reference 

File Class 
Concepts 

File Members 
java.io Package 
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File Meth 


ods 


Public Methods 














Name Description 

canRead Determines whether a file or folder can be read. 
canWrite Determines whether a file or folder can be written to. 
compareTo Overloaded. Compares two File objects for equality. 





createNewFile 


Creates on disk the file or folder that is represented by the File object. 





createTempFile 


delete 


deleteOnExit 


Overloaded. Creates on disk a temporary file or folder. 


Deletes the file or folder represented by the File object. 


Deletes the file or folder when the object is no longer needed and the system reclaims the object through ga 
rbage collection. 











getAbsoluteFile 


equals Overridden. Compares two File objects for equality. 
exists Determines whether the file or folder exists on disk. 
finalize Overridden. Reclaims the memory associated with a File object when it is no longer needed by the applicatio 


n. 


Creates a new instance of a File object representing the file located at the absolute path of the current File ob 
ject. 





getAbsolutePath 


Displays the absolute path of the file. 





getCanonicalFile 


getCanonicalPath 


hashCode 


getName 


GetObjectData 


getParent 


Creates a new instance of a File object representing the file located at the absolute path of the current File ob 
jject. All '.' and '.." references will be resolved. 


Displays the absolute path of the file. All '.' and '..' references will be resolved. 
Overridden. Returns a hash value that is suitable for use in hashing algorithms. 
Retrieves the name of the file without the directory. 

Retrieves the data to be serialized. 


Retrieves the path name of the parent directory of the file. 





getParentFile 


Creates a new instance of a File object representing the parent directory of the file. 














getPath Displays the directory of the file. 
getClass (inherited from Object ) 
isAbsolute Determines whether the pathname of the file or folder is absolute. 












































isDirectory Determines whether the pathname of the object represented by a File object is a directory. 

isFile Determines whether the pathname of the object represented by a File object is a file. 

isHidden Determines whether the file or folder is hidden. 

lastModified Retrieves the time of the last modification to the file or folder, in milliseconds since epoch. 

length Retrieves the size of the file or folder, in bytes. 

list Overloaded. Lists the files or folders in the directory represented by this object. 

listFiles Overloaded. Creates instances of new File objects representing all the files or folders in the directory represe 
nted by this object. 

listRoots Creates instances of new File objects representing all the base, or root, paths of the system. 

clone Creates a shallow copy of the current File object. 

mkdir Creates the directory on disk represented by this object. 

mkdirs Creates the directory and all parent directories on disk represented by this object. 

renameTo Renames the file or folder to the name of the destination file or folder. 





setLastModified 


Sets the time of the last modification to the file or folder. 





setReadOnly 


Sets the value indicating whether the file or folder is read-only. 





toString 


Overridden. Displays a human readable representation of a file or folder. 





toURL 








Converts a file or folder into a URL (Uniform Resource Locator). 





See Also 
Reference 

File Class 
Concepts 
java.io Package 
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File.canRead Method 


Determines whether a file or folder can be read. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean canRead(); 


Return Value 


true if the file or folder can be read; false otherwise. 


Example 


The following code example demonstrates how to determine if a file is readable. 


// File_ 


canread.jsl 


import java.io.*; 


public class Program 


{ 


public static void main(String[] args) 


A 


r 


/* 
Output: 


// Open the file C:\MyFile.txt as read-write. 
File myFile = new File("C:\\MyFile.txt"); 


// Determine if this file is readable. 
if (myFile.canRead()) 
{ 
System.out.println(myFile.getAbsolutePath() + 
"is a readable file."); 


C:\MyFile.txt is a readable file. 


*/ 


See Also 
Reference 
File Class 
Concepts 

File Members 


java.io Package 
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File.canWrite Method 


Determines whether a file or folder can be written to. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean canwrite(); 


Return Value 
true if the file or folder can be written to; false otherwise. 
Example 


The following example demonstrates how to determine if a file has read-write access. 
// file_canwrite.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Open the file C:\MyFile.txt as read-write. 
File myFile = new File("C:\\MyFile.txt"); 
// If this file is read-write, set it to read-only. 
if (myFile.canwWrite()) 
{ 
myFile.setReadOnly(); 
System.out.println(myFile.getAbsolutePath() + 
"is now read-only."); 
} 
} 
/ * 
Output: 
C:\MyFile.txt is now read-only. 
*/ 
See Also 
Reference 
File Class 
Concepts 


File Members 
java.io Package 
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File.clone Method 


Creates a shallow copy of the current File object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





Return Value 
A shallow copy of the current File object. 


See Also 
Reference 

File Class 
Concepts 

File Members 
java.io Package 
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File.compareTo Method 


Compares two File objects for equality. 


Overload List 


File.compareTo (File) Compares one File object with another File object. 





File.ccompareTo (Object) Compares one File object with another object. 


See Also 
Reference 

File Class 
Concepts 

File Members 
java.io Package 
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File.compareTo Method (File) 


Compares one File object with another File object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int compareTo( 
java.io.File pathname) ; 


Parameters 
pathname 


A File object representing a file or folder to compare against. 
Return Value 


Less than zero if the path and name of the object calling compareTo is alphabetically less than pathname, 0 if the path and 
name of the object calling compareTo is alphabetically equal to pathname, and greater than zero if the path and name of the 
object calling compareTo is alphabetically greater than pathname. 


Example 


The following example demonstrates how to compare two file names alphabetically. 


// ile_compareto.jsl 
import java.io.*; 


public class Program 
{ 
public static void main(String[] args) 
1 
// Open the file C:\MyFile.txt. 
File myFile = new File("C:\\MyFile.txt"); 


// Open the file C:\YourFile.txt. 
File yourFile = new File("C:\\YourFile.txt"); 


if (myFile.exists() && yourFile.exists()) 


{ 
// Compare the two files alphabetically. 


int compareResult = myFile.compareTo(yourFile) ; 


// Display the results of the comparison. 
if (compareResult < @) 


{ 

System.out.println(myFile.getAbsolutePath() + 
"is less than " + 
yourFile.getAbsolutePath()); 

else if (compareResult == Q) 
{ 

System.out.println(myFile.getAbsolutePath() + 
"is equal to " + 
yourFile.getAbsolutePath()); 

i 
else 
{ 

System.out.println(myFile.getAbsolutePath() + 
"is greater than " + 
yourFile.getAbsolutePath()); 

} 


} 


/* 

Output: 

C:\MyFile.txt is less than C:\YourFile.txt 
* 











See Also 
Reference 

File Class 
Concepts 

File Members 
java.io Package 
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File.compareTo Method (Object) 


Compares one File object with another object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int compareTo( 
java.lang.Object o); 


Parameters 
Oo 
An object representing a file or folder to compare against. 


Return Value 


Less than zero if the path and name of the object calling compareTo is alphabetically less than the object 0, 0 if the path and 
name of the object calling compareTo is alphabetically equal to the object o, and greater than zero if the path and name of the 


object calling compareTo is alphabetically greater than the object o. 
Example 


The following example demonstrates how to compare two file names alphabetically. 


// file_compareto_2.jsl 
import java.io.*; 


public class Program 
{ 
public static void main(String[] args) 
1 
// Open the file C:\MyFile.txt. 
Object myFile = new File("C:\\MyFile.txt"); 


// Open the file C:\YourFile.txt. 
Object yourFile = new File("C:\\YourFile.txt"); 


if (myFile instanceof File && 
yourFile instanceof File && 
((File)myFile).exists() && ((File)yourFile).exists()) 


// Compare the two files alphabetically. 
int compareResult = ((File)myFile).compareTo(yourFile) ; 


// Display the results of the comparison. 
if (compareResult < @) 


{ 

System.out.println(((File)myFile).getAbsolutePath() + 
"is less than " + 
((File)yourFile).getAbsolutePath() ); 

else if (compareResult == @Q) 
{ 

System.out.println(((File)myFile).getAbsolutePath() + 
"is equal to " + 
((File)yourFile).getAbsolutePath()); 

else 
{ 


System.out.println(((File)myFile).getAbsolutePath() + 


is greater than " + 
((File)yourFile).getAbsolutePath() ); 


} 
} 
} 
/* 
Output: 


C:\MyFile.txt is less than C:\YourFile.txt 
sr 











See Also 
Reference 

File Class 
Concepts 

File Members 
java.io Package 
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File.createNewFile Method 


Creates on disk the file or folder that is represented by the File object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean createNewFile() throws java.io. IOException; 


Return Value 
true if the file or folder was successfully created; false if the file or folder already exists or there was an error creating it. 
Example 


The following example shows how to create a file that does not yet exist. 
// file_createnewfile.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
try 
{ 


// Open the file C:\MyFile.txt. 
File myFile = new File("C:\\MyFile.txt"); 
if (myFile.exists()) 


{ 
System.out.println(myFile.getAbsolutePath() + 
"already exists."); 
} 
else 
{ 
if (myFile.createNewFile()) 
{ 
System.out.println("Created file " + 
myFile.getAbsolutePath()); 
} 
else 
{ 
System.out.println("Unable to create file " + 
myFile.getAbsolutePath()); 
} 
} 


// Open the file C:\DoesNotExist.txt. 
File noFile = new File ("C:\\DoesNotExist.txt"); 
if (noFile.exists()) 


si 
System.out.println(noFile.getAbsolutePath() + 
"already exists."); 
} 
else 


if (noFile.createNewFile()) 


{ 
System.out.println("Created file " + 
noFile.getAbsolutePath()); 
} 
else 


System.out.println("Unable to create file " + 
noFile.getAbsolutePath()); 


} 
} 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 


C:\MyFile.txt already exists. 
Created file C:\DoesNotExist.txt 
*/ 











See Also 
Reference 

File Class 
Concepts 

File Members 
java.io Package 


Visual J# Reference 


File.createTempFile Method 


Creates on disk a temporary file or folder. 


Overload List 
Name 


File.createTempFile (String, String) Creates on disk a temporary file or folder with the given prefix (name) and suffix (exten 


sion). 








File.createTempFile (String, String, File)|Creates on disk a temporary file with the given prefix (name) and suffix (extension) loca 
ted in the given directory. 





See Also 
Reference 

File Class 
Concepts 

File Members 
java.io Package 
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File.createTempFile Method (String, String) 


Creates on disk a temporary file or folder with the given prefix (name) and suffix (extension). 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public static java.io.File createTempFile( 
java.lang.String prefix, 
java.lang.String suffix) throws java.io. IOException; 


Parameters 


prefix 


The name of the temporary file to create. This value will be modified to add a trailing string of random characters when it is 
written to disk. 


suffix 
The extension, or type, of the file to create. This suffix should include the leading period or it will not be added. 
Return Value 


A File object representing the newly created temporary file. The temporary file is created in the directory represented by 
GetTempPath. 


Example 

The following example shows how to create a temporary file. 
// file_createtempfile.jsl 
import java.io.*; 


public class Program 


if 
public static void main(String[] args) 
1 
try 
{ 
// Create a temp file named ATempFile.tmp. 
File tempFile = File.createTempFile("ATempFile", ".tmp"); 
// Determine where this file was created. 
if (tempFile.exists()) 
if 
System.out.println("A temporary file was created at " + 
tempFile.getAbsolutePath()); 
} 
} 
catch (IOException ex) 
{ 
System.out.printin(ex.toString()); 
; 
} 
} 
Yh 
Output: 
A temporary file was created at C:\Documents and Settings\yourname\Local Settings\Temp\ATem 
pFiletmp3 


2B244356857.tmp 
*/ 


See Also 
Reference 

File Class 
Concepts 

File Members 
java.io Package 
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File.createTempFile Method (String, String, File) 


Creates on disk a temporary file with the given prefix (name) and suffix (extension) located in the given directory. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public static java.io.File createTempFile( 
java.lang.String prefix, 
java.lang.String suffix, 
java.io.File directory) throws java.io. IOException; 


Parameters 


prefix 


The name of the temporary file to create. This value will be modified to add a trailing string of random characters when it is 
written to disk. 


suffix 
The extension, or type, of the file to create. This suffix should include the leading period or it will not be added. 
directory 
The directory where the temporary file is to be created. 
Return Value 
A File object representing the newly created temporary file. 
Example 


The following example shows how to create a temporary file in the C:\ directory. 
// file_createtempfile_2.jsl 
import java.io.*; 


public class Program 


af 
public static void main(String[] args) 
1 
try 
{ 
// Create a temp file named ATempFile.tmp. 
File dir = new File("C:\\"); 
if (dir.exists()) 
{ 
File tempFile = File.createTempFile("ATempFile", ".tmp", dir); 
// Determine where this file was created. 
if (tempFile.exists()) 
System.out.println("A temporary file was created at " + 
tempFile.getAbsolutePath()); 
} 
} 
catch (IOException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 


/* 
Output: 


A temporary file was created at C:\ATempFiletmp32E1187765574.tmp 
a 
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File.delete Method 


Deletes the file or folder represented by the File object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean delete(); 


Return Value 
true if the file or folder was successfully deleted; false if the file or folder does not exist or could not be deleted. 
Example 
The following example shows how to delete a file. 
// file_delete.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Open the file C:\MyFile.txt. 
File myFile = new File("C:\\MyFile.txt"); 
String path = myFile.getAbsolutePath() ; 
// If the file exists, delete it. 
if (myFile.exists()) 
if (myFile.delete()) 
System.out.printin("Successfully deleted " + 
path); 
} 
else 
{ 
System.out.println("Unable to delete file " + 
path) ; 
} 
} 
} 
/ * 
Output: 
Successfully deleted C:\MyFile.txt 
=f 
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File.deleteOnExit Method 


Deletes the file or folder when the object is no longer needed and the system reclaims the object through garbage collection. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void deleteOnExit(); 


Example 

The following example shows how to delete a file once the system is no longer using it. 
// file_deleteonexit.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 


{ 
// Open the file C:\MyFile.txt. 
File myFile = new File("C:\\MyFile.txt"); 
String path = myFile.getAbsolutePath() ; 
// If the file exists, delete it when garbage collection 
// runs on the myFile object. 
if (myFile.exists()) 
: 
myFile.deleteOnExit(); 
} 
} 
} 
See Also 
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File.equals Method 


Compares two File objects for equality. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean equals( 
java.lang.Object obj); 


Parameters 


obj 
An object representing a file or folder to compare against. 
Return Value 
true if the two File objects represent the same file or folder; false otherwise. 
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File.exists Method 


Determines whether the file or folder exists on disk. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean exists(); 


Return Value 
true if the file or folder represented by the File object exists on disk; false otherwise. 
Example 


The following example shows how to determine if a file exists. 
// file_exists.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Open the file C:\MyFile.txt. 
File myFile = new File("C:\\MyFile.txt"); 
String path = myFile.getAbsolutePath(); 
// If the file exists, display it's full path. 
if (myFile.exists()) 
System.out.println(path + " exists!"); 
} 
else 
{ 
System.out.println(path + " does NOT exist!"); 
} 
} 
} 
/ * 
Output: 
C:\MyFile.txt exists! 
of: 
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File.finalize Method 


Reclaims the memory associated with a File object when it is no longer needed by the application. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected void finalize(); 
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File.getAbsoluteFile Method 


Creates a new instance of a File object representing the file located at the absolute path of the current File object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.File getAbsoluteFile(); 


Return Value 
A new instance of a File object representing the file located at the absolute path of the current File object. 
Example 


The following example shows how to create a new File object by calling getAbsoluteFile. 
// file_getabsolutefile.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Open the file C:\MyFile.txt. 
File myFile = new File("C:\\MyFile.txt"); 
File myFile2 = myFile.getAbsoluteFile(); 
String path = myFile2.getAbsolutePath(); 
// If the file exists, display it's full path. 
if (myFile2.exists()) 
System.out.println(path + " exists!"); 
} 
else 
{ 
System.out.println(path + " does not exist!"); 
} 
} 
} 
/ * 
Output: 
C:\MyFile.txt exists! 
mf 
See Also 
Reference 
File Class 
Concepts 


File Members 
java.io Package 


Visual J# Reference 


File.getAbsolutePath Method 


Displays the absolute path of the file. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getAbsolutePath(); 


Return Value 
The absolute path of the file represented by the File object. 
Example 
The following example displays the absolute path for a file. 
// file_getabsolutepath.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Open the file C:\MyFile.txt. 
File myFile = new File("C:\\Windows\\..\\MyFile.txt"); 
String path = myFile.getAbsolutePath(); 
// If the file exists, display it's full path. 
if (myFile.exists()) 
System.out.println(path + " exists!"); 
} 
else 
{ 
System.out.println(path + " does NOT exist!"); 
} 
} 
} 
/ * 
Output: 
C:\Windows\..\MyFile.txt exists! 
=f 
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File.getCanonicalFile Method 


Creates a new instance of a File object representing the file located at the absolute path of the current File object. All '.' and '.. 


references will be resolved. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java. 


Return Value 


A new instance of a File object representing the file located at the absolute path of the current File object. 


Example 


io.File getCanonicalFile() throws java.io. IOException; 


The following example shows how to create a new File object by calling getCanonicalFile. 


// file_getcanonicalfile.jsl 


import java. 


io.*; 


public class Program 


{ 


public static void main(String[] args) 


{ 
try 


{ 


// Open the file C:\MyFile.txt. 

File myFile = new File("C:\\MyFile.txt"); 
File myFile2 = myFile.getCanonicalFile(); 
String path = myFile2.getAbsolutePath(); 


// If the file exists, display it's full path. 
if (myFile2.exists()) 
{ 


System.out.println(path + " exists!"); 


} 


else 


d 
} 


System.out.println(path + " does not exist!"); 


catch (IOException ex) 


{ 
, 
} 


/* 
Output: 


System.out.println(ex.toString()); 


C:\MyFile.txt exists! 


aA 
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File.getCanonicalPath Method 


Displays the absolute path of the file. All '.' and '..' references will be resolved. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getCanonicalPath() throws java.io. IOException; 


Return Value 
The absolute path of the file represented by the File object. 
Example 


The following example displays the canonical path for a file. 
// file_getcanonicalpath.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
try 
{ 
// Open the file C:\MyFile.txt. 
File myFile = new File("C:\\Windows\\..\\MyFile.txt"); 
String path = myFile.getCanonicalPath(); 
// If the file exists, display it's full path. 
if (myFile.exists()) 
System.out.println(path + " exists!"); 
} 
else 
{ 
System.out.println(path + " does NOT exist!"); 
} 
catch (IOException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 
} 
/ * 
Output: 
C:\MyFile.txt exists! 
ef 
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File hashCode Method 


Returns a hash value that is suitable for use in hashing algorithms. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int hashCode(); 


Return Value 
A hash value that is suitable for use in hashing algorithms. 


See Also 
Reference 

File Class 
Concepts 

File Members 
java.io Package 


Visual J# Reference 


File.getName Method 


Retrieves the name of the file without the directory. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public java.lang.String getName(); 





Return Value 
The name of the file represented by the File object without the directory. 
Example 


The following example displays the name of a file. 





// file_getname.jsl 
import java.io.*; 
public class Program 
{ 
public static void main(String[] args) 
// Create a File object using C:\MyFile.txt. 
File myFile = new File("C:\\MyFile.txt"); 
// Display the name of the file. 
System.out.printin("The file's name is " + 
myFile.getName()); 
} 
} 
f® 
Output: 
The file's name is MyFile.txt 
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File.GetObjectData Method 


Retrieves the data to be serialized. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void GetObjectData( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization process. 
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File.getParent Method 


Retrieves the path name of the parent directory of the file. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getParent(); 


Return Value 
The path name of the parent directory of the file represented by the File object. 
Example 


The following example displays the parent of a file. 
// file_getparent.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
// Create a File object using C:\MyFile.txt. 
File myFile = new File("C:\\MyFile.txt"); 
// Display the name of the file and the parent. 
System.out.printlin("The file's name is " + 
myFile.getName() + ".\nThe parent's name is " + 
myFile.getParent()); 
} 
} 
/* 
Output: 


The file's name is MyFile.txt. 
The parent's name is C:\ 


*/ 
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File.getParentFile Method 


Creates a new instance of a File object representing the parent directory of the file. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.File getParentFile(); 


Return Value 


A new instance of a File object representing the parent directory of the file represented by the File object, or null if the parent 
directory does not exist. 


Example 


The following example demonstrates how to create a new File object representing the parent of a given File object. 


// file_getparentfile.jsl 
import java.io.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Create a File object using C:\MyFile.txt. 
File myFile = new File("C:\\MyFile.txt"); 
File parentFile = myFile.getParentFile(); 


// Display the name of the file and the parent. 
if (myFile.exists() && 
(parentFile != null) && 
parentFile.exists()) 
System.out.printlin("The file's name is " + 
myFile.getName() + ".\nThe parent's path is " + 
parentFile.getAbsolutePath()); 


} 


/* 

Output: 

The file's name is MyFile.txt. 
The parent's path is C:\ 

ad 
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File.getPath Method 


Displays the directory of the file. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getPath(); 


Return Value 
The directory of the file represented by the File object. 
Example 


The following example shows how to display the path for a file. 
// file_getpath.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Open the file C:\MyFile.txt. 
File myFile = new File("C:\\Windows\\..\\MyFile.txt"); 
String path = myFile.getPath(); 
// If the file exists, display it's full path. 
if (myFile.exists()) 
System.out.println(path + " exists!"); 
} 
else 
{ 
System.out.println(path + " does NOT exist!"); 
} 
} 
} 
/ * 
Output: 
C:\Windows\..\MyFile.txt exists! 
=f 
See Also 
Reference 
File Class 
Concepts 


File Members 
java.io Package 


Visual J# Reference 


File.isAbsolute Method 


Determines whether the pathname of the file or folder is absolute. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean isAbsolute(); 


Return Value 
true if the pathname of the file or folder represented by the File object is absolute; false otherwise. 
Example 


The following example shows how to determine if a file path is absolute. 
// file_isabsolute.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a File object using C:\MyFile.txt. 
File myFile = new File("C:\\MyFile.txt"); 
// Create a File using YourFile.txt. 
File yourFile = new File("YourFile.txt"); 
// Which of these files have absolute paths? 
if (myFile.isAbsolute()) 
System.out.println(myFile.getName() + 
"is absolute."); 
} 
else 
{ 
System.out.println(myFile.getName() + 
"is NOT absolute."); 
} 
if (yourFile.isAbsolute()) 
{ 
System.out.println(yourFile.getName() + 
"is absolute."); 
} 
else 
{ 
System.out.println(yourFile.getName() + 
"is NOT absolute."); 
} 
} 
Yi 
Output: 


MyFile.txt is absolute. 
YourFile.txt is NOT absolute. 
ay 
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File.isDirectory Method 


Determines whether the pathname of the object represented by a File object is a directory. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean isDirectory(); 


Return Value 
true if the object represented by the File object exists and is a directory; false otherwise. 
Example 


The following example demonstrates how to determine if a File object is representing a directory (folder). 
// file_isdirectory.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a File object using C:\MyFile.txt. 
File myFile = new File("C:\\MyFile.txt"); 
// Get the parent of MyFile.txt. 
File parentFile = myFile.getParentFile(); 
// Which of these is a file and which is a directory? 
if (myFile.isDirectory()) 
System.out.println(myFile.getAbsolutePath() + 
"is a directory."); 
} 
else 
{ 
System.out.println(myFile.getAbsolutePath() + 
"is NOT a directory."); 
} 
if (parentFile.isDirectory()) 
{ 
System.out.println(parentFile.getAbsolutePath() + 
"is a directory."); 
} 
else 
{ 
System.out.println(parentFile.getAbsolutePath() + 
"is NOT a directory."); 
} 
} 
/* 
Output: 


C:\MyFile.txt is NOT a directory. 
C:\ is a directory. 
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File.isFile Method 


Determines whether the pathname of the object represented by a File object is a file. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean isFile(); 


Return Value 
true if the object represented by the File object exists and is a file; false otherwise. 
Example 


The following example demonstrates how to determine if a File object is representing a file (rather than a directory). 
// file_isfile.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a File object using C:\MyFile.txt. 
File myFile = new File("C:\\MyFile.txt"); 
// Get the parent of MyFile.txt. 
File parentFile = myFile.getParentFile(); 
// Which of these is a file and which is a directory? 
if (myFile.isFile()) 
{ 
System.out.println(myFile.getAbsolutePath() + 
"is a file."); 
} 
else 
{ 
System.out.println(myFile.getAbsolutePath() + 
"is NOT a file."); 
} 
if (parentFile.isFile()) 
{ 
System.out.println(parentFile.getAbsolutePath() + 
"is a file."); 
} 
else 
{ 
System.out.println(parentFile.getAbsolutePath() + 
"is NOT a file."); 
} 
} 
/* 
Output: 


C:\MyFile.txt is a file. 
C:\ is NOT a file. 
*/ 
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File.isHidden Method 


Determines whether the file or folder is hidden. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean isHidden(); 


Return Value 
true if the file or folder represented by the File object is hidden; false otherwise. 
Example 


The following example demonstrates how to determine if a file is hidden. 
// file_ishidden.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a File object using C:\MyFile.txt. 
File myFile = new File("C:\\MyFile.txt"); 
// Determine if the file is hidden. 
if (myFile.isHidden()) 
{ 
System.out.println(myFile.getAbsolutePath() + 
"is a hidden file."); 
} 
else 
{ 
System.out.println(myFile.getAbsolutePath() + 
"is NOT a hidden file."); 
} 
} 
} 
/ * 
Output: 
C:\MyFile.txt is NOT a hidden file. 
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File.lastModified Method 


Retrieves the time of the last modification to the file or folder, in milliseconds since epoch. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public long lastModified(); 


Return Value 


The time of the last modification to the file represented by the File object, in milliseconds since epoch, or -1 if the file or folder 
does not exist. 


Example 
The following example displays the time of the last modification on a file. 
// file_lastmodified.jsl 


import java.io.*; 
import java.util.Date; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a File object using C:\MyFile.txt. 
File myFile = new File("C:\\MyFile.txt"); 
// Determine the last modification time of the file. 
long modTime = myFile.lastModified(); 
Date d = new Date(modTime) ; 
System.out.println(myFile.getAbsolutePath() + 
"was last modified on " + d.toString()); 
} 
} 
/ * 
Output: 
C:\MyFile.txt was last modified on Fri Sep 17 10:51:45 PDT 2004 
*/ 
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File.length Method 


Retrieves the size of the file or folder, in bytes. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public long length(); 





Return Value 
The size of the file or folder represented by the File object, in bytes, or 0 if the file or folder does not exist. 
Example 


The following example displays the length of a file in bytes. 





// file_length.jsl 
import java.io.*; 
public class Program 
{ 
public static void main(String[] args) 
if 
// Create a File object using C:\MyFile.txt. 
File myFile = new File("C:\\MyFile.txt"); 
// Determine the length of the file. 
long length = myFile.length(); 
System.out.println(myFile.getAbsolutePath() + 
"contains " + length + " bytes."); 
} 
} 
EF 
Output: 
C:\MyFile.txt contains 66 bytes. 
*/ 
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File.list Method 


Lists the files or folders in the directory represented by this object. 


Overload List 


File.list () Lists the files or folders in the directory represented by this object. 





File.list (FilenameFilter) |Lists the files or folders in the directory represented by this object that meet the filtering criteria. 


See Also 
Reference 

File Class 
Concepts 

File Members 
java.io Package 


Visual J# Reference 


File.list Method () 


Lists the files or folders in the directory represented by this object. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String[] list(); 


Return Value 


An array of all the files or folders in the directory represented by this object, or null if the object does not exist or is not a 


directory. 


Example 


The following example displays the contents of the C:\ directory. 


// file_list.jsl 


import java.io.*; 


public class Program 


public static void main(String[] args) 


{ 
{ 
} 
} 
/* 
Output: 


// Create a File object using C:\MyFile.txt. 
File myFile = new File("C:\\MyFile.txt"); 


// Determine all the other folders and files in the 
// same directory as myFile. 
String[] contents = myFile.getParentFile().list(); 


System.out.println("The parent directory of " + 
myFile.getPath() + 
"contains files and folders:"); 

for (int i = @; i < contents.length; i++) 


{ 
} 


System.out.printin("\t" + contents[i]); 


The parent directory of C:\MyFile.txt contains files and folders: 


dd 

dell 

Documents and Settings 
Drivers 

Inetpub 

MSOCache 

Perl 

Program Files 

Python23 

RECYCLER 

System Volume Information 
WINNT 

wmpub 

WUTemp 

AUTOEXEC. BAT 

boot.ini 

CONFIG.SYS 


DoesNotExist.txt 
InoSetRTThread. log 
I0.SYS 
MSDOS.SYS 
MyFile.txt 
NTDETECT.COM 
ntldr 
pagefile.sys 
YourFile.txt 

=f 
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File.list Method (FilenameFilter) 


Lists the files or folders in the directory represented by this object that meet the filtering criteria. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String[] list( 
java.io.FilenameFilter filter); 


Parameters 
filter 


A FilenameFilter that represents the filter to apply to all the files or folders in the directory represented by this object. 
Return Value 


An array of all the files or folders in the directory represented by this object that meet the filtering criteria, or null if the object 
does not exist or is not a directory. 


Example 


The following example displays the files in the C:\ directory that have a txt extension. 


// file_list_2.jsl 
import java.io.*; 


public class Program 
{ 
public static void main(String[] args) 
i 
// Create a File object using C:\MyFile.txt. 
File myFile = new File("C:\\MyFile.txt"); 


// Determine all the other folders and files in the 

// same directory as myFile. 

TxtFilenameFilter filter = new TxtFilenameFilter(); 
String[] contents = myFile.getParentFile().list(filter) ; 


System.out.println("The parent directory of " + 
myFile.getPath() + 
"contains files and folders:"); 

for (int i = @; i < contents.length; i++) 


{ 
} 


System.out.println("\t" + contents[i]); 


} 


public class TxtFilenameFilter implements FilenameFilter 
{ 
public boolean accept(File dir, String name) 
{ 
if (name != null && 
name. toLowerCase().endsWith(".txt")) 


{ 

return true; 
} 
else 
{ 

return false; 
} 


} 


/* 
Output: 
The parent directory of C:\MyFile.txt contains files and folders: 
DoesNotExist.txt 
MyFile.txt 
NewName.txt 
output.txt 
RandomFile.txt 
YourFile.txt 
aa 
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File.listFiles Method 


Creates instances of new File objects representing all the files or folders in the directory represented by this object. 


Overload List 
Name Description 


File.listFiles () Creates instances of new File objects representing all the files or folders in the directory represent 
ed by this object. 





File.listFiles (FileFilter) Creates instances of new File objects representing all the files or folders in the directory represent 
ed by this object that meet the file filtering criteria. 


File.listFiles (FilenameFilter)|Creates instances of new File objects representing all the files or folders in the directory represent 
ed by this object that meet the filename filtering criteria. 
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File.listFiles Method () 


Creates instances of new File objects representing all the files or folders in the directory represented by this object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.File[] listFiles(); 


Return Value 


An array of File objects representing all the files or folders in the directory represented by this object, or null if the object does 
not exist or is not a directory. 


Example 

The following example displays the contents of the C:\ directory. 
// file_listfiles.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
// Create a File object using C:\MyFile.txt. 
File myFile = new File("C:\\MyFile.txt"); 
// Determine all the other folders and files in the 
// same directory as myFile. 
File[] contents = myFile.getParentFile().listFiles(); 
System.out.println("The parent directory of " + 
myFile.getPath() + 
" contains files and folders:"); 
for (int i = 0; i < contents.length; i++) 
{ 
System.out.println("\t" + contents[i].getName()); 
} 
} 
} 
/* 
Output: 
The parent directory of C:\MyFile.txt contains files and folders: 
dd 
dell 
Documents and Settings 
Drivers 
Inetpub 
MSOCache 
Perl 
Program Files 
Python23 
RECYCLER 
System Volume Information 
WINNT 
wmpub 
WUTemp 
AUTOEXEC. BAT 
boot.ini 


CONFIG.SYS 


DoesNotExist.txt 
InoSetRTThread. log 
I0.SYS 
MSDOS.SYS 
MyFile.txt 
NTDETECT.COM 
ntldr 
pagefile.sys 
YourFile.txt 

=f 
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File.listFiles Method (FileFilter) 


Creates instances of new File objects representing all the files or folders in the directory represented by this object that meet 
the file filtering criteria. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.File[] listFiles( 
java.io.FileFilter filter); 


Parameters 
filter 


A FileFilter that represents the filter to apply to all the files or folders in the directory represented by this object. 
Return Value 


An array of File objects representing all the files or folders in the directory represented by this object that meet the filtering 
criteria, or null if the object does not exist or is not a directory. 


Example 


The following example displays the files in the C:\ directory that have a txt extension. 


// file_listfiles_2.jsl 
import java.io.*; 


public class Program 
{ 
public static void main(String[] args) 
1 
// Create a File object using C:\MyFile.txt. 
File myFile = new File("C:\\MyFile.txt"); 


// Determine all the other folders and files in the 

// same directory as myFile. 

TxtFileFilter filter = new TxtFileFilter(); 

File[] contents = myFile.getParentFile().listFiles(filter); 


System.out.println("The parent directory of " + 
myFile.getPath() + 
"contains files and folders:"); 

for (int i = @; i < contents.length; i++) 


{ 
} 


System.out.printlin("\t" + contents[i].getName()); 


I 


public class TxtFileFilter implements FileFilter 


{ 
public boolean accept(File f) 


{ 
if (f != null && 
f.getName().toLowerCase().endsWith(".txt")) 
{ 


} 
else 


{ 
} 


return true; 


return false; 


} 


public String getDescription() 


{ 
return "Filter for all txt files."; 
} 
} 
/* 
Output: 


The parent directory of C:\MyFile.txt contains files and folders: 
DoesNotExist.txt 
MyFile.txt 
NewName. txt 
output.txt 
RandomFile.txt 
YourFile.txt 
ars 
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File.listFiles Method (FilenameFilter) 


Creates instances of new File objects representing all the files or folders in the directory represented by this object that meet 
the filename filtering criteria. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.File[] listFiles( 
java.io.FilenameFilter filter); 


Parameters 
filter 


A FilenameFilter that represents the filter to apply to all the files or folders in the directory represented by this object. 
Return Value 


An array of File objects representing all the files or folders in the directory represented by this object that meet the filtering 
criteria, or null if the object does not exist or is not a directory. 


Example 


The following example displays the files in the C:\\ directory that have a txt extension. 


// file_listfiles_3.jsl 
import java.io.*; 


public class Program 
{ 
public static void main(String[] args) 
1 
// Create a File object using C:\MyFile.txt. 
File myFile = new File("C:\\MyFile.txt"); 


// Determine all the other folders and files in the 

// same directory as myFile. 

TxtFilenameFilter filter = new TxtFilenameFilter(); 

File[] contents = myFile.getParentFile().listFiles(filter) ; 


System.out.println("The parent directory of " + 
myFile.getPath() + 
"contains files and folders:"); 

for (int i = @; i < contents.length; i++) 


{ 
} 


System.out.printlin("\t" + contents[i].getName()); 


I 


public class TxtFilenameFilter implements FilenameFilter 


{ 


public boolean accept(File dir, String name) 


sf 
if (name != null && 
name.toLowerCase().endsWith(".txt")) 


{ 
} 
else 


{ 
} 


return true; 


return false; 


} 


/* 
Output: 
The parent directory of C:\MyFile.txt contains files and folders: 
DoesNotExist.txt 
MyFile.txt 
NewName.txt 
output.txt 
RandomFile.txt 
YourFile.txt 
af 
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File.listRoots Method 


Creates instances of new File objects representing all the base, or root, paths of the system. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public static java.io.File[] listRoots(); 


Return Value 


An array of File objects representing all the base, or root, paths of the system. Paths that the user does not have permission to 
access are not included in the array. 


Example 

The following example lists all the root paths of the system. 
// file_listroots.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
// Determine all the root paths for the system. 
File[] roots = File.listRoots(); 
System.out.println("The system contains root paths:"); 
for (int i = @; i < roots.length; i++) 
{ 
System.out.printin("\t" + roots[i].getAbsolutePath()); 
} 
} 
} 
/ * 
Output: 
The system contains root paths: 
A:\ 
C:\ 
D:\ 
J:\ 
ay 
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File.mkdir Method 


Creates the directory on disk represented by this object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean mkdir(); 


Return Value 
true if the directory was successfully created, false otherwise. 
Example 


The following example shows how to create the parent directory of a file. 
// file_mkdir.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a File object using C:\NewDirectory\MyFile.txt. 
File myFile = new File("C:\\NewDirectory", "MyFile.txt"); 
// Create "New Directory" if it doesn't exist. 
if (myFile.mkdir()) 
{ 
System.out.println(myFile.getParent() + 
"was successfully created."); 
} 
else 
{ 
System.out.println(myFile.getParent() + 
"was NOT created."); 
} 
} 
} 
/ * 
Output: 
C:\NewDirectory was successfully created. 
ar A 
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File.smkdirs Method 


Creates the directory and all parent directories on disk represented by this object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean mkdirs(); 


Return Value 
true if the directory was successfully created along with all parent directories, false otherwise. 
Example 


The following example shows how to create the parent directories of a file. 
// file_mkdirs.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
// Create a File object using C:\NewDirectory\MyFile.txt. 
File myFile = new File("C:\\NewDirectory1\\NewDirectory2", 
"MyFile.txt"); 
// Create "New Directory" if it doesn't exist. 
if (myFile.mkdir()) 
System.out.println(myFile.getParent() + 
"was successfully created."); 
} 
else 
{ 
System.out.println(myFile.getParent() + 
"was NOT created."); 
} 
} 
} 
/ * 
Output: 
C:\NewDirectory1\NewDirectory2 was successfully created. 
an A 
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File.renameTo Method 


Renames the file or folder to the name of the destination file or folder. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean renameTo( 
java.io.File dest); 


Parameters 
dest 

A File object representing the new name of the file or folder. 
Return Value 
true if the file or folder was successfully renamed; false otherwise. 
Example 


The following example shows how to rename a file. 
// file_renameto.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Open the file C:\MyFile.txt. 
File myFile = new File("C:\\Windows\\..\\MyFile.txt"); 
File newFile = new File("C:\\NewFile.txt"); 
// If the file exists, rename it. 
if (myFile.exists()) 
myFile.renameTo(newFile) ; 
System.out.println("The new name is: " + 
newFile.getAbsolutePath()); 
} 
else 
{ 
System.out.println(myFile.getAbsolutePath() + 
"does NOT exist!"); 
} 
} 
} 
/ * 
Output: 
The new name is: C:\NewFile.txt 
*/ 
See Also 
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File.setLastModified Method 


Sets the time of the last modification to the file or folder. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean setLastModified( 
long time); 


Parameters 
time 
A value representing the time of the last modification to the file or folder, in milliseconds since epoch 
Return Value 
true if the modification time of the file or folder was successfully changed; false otherwise. 
Example 


The following example shows how to change the last modification time for a file. 


// file_setlastmodified.jsl 


import java.io.*; 
import java.util.Date; 


public class Program 


4 
public static void main(String[] args) 
{ 
// Create a File object using C:\MyFile.txt. 
File myFile = new File("C:\\MyFile.txt"); 
// Change the last modification time of the file to the 
// current time. 
Date d = new Date(); 
System.out.println("Setting the date to " + 
d.toString()); 
boolean changed = myFile.setLastModified(d.getTime()); 
} 
} 
/ * 
Output: 
Setting the date to Fri Sep 17 12:42:24 PDT 2004 
nf 
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File.setReadOnly Method 


Sets the value indicating whether the file or folder is read-only. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean setReadOnly(); 


Return Value 
true if the file or folder was successfully set to read-only; false if the file or folder does not exist. 
Example 


The following example shows how to make a file read-only. 
// file_setreadonly.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a File object using C:\MyFile.txt. 
File myFile = new File("C:\\MyFile.txt"); 
// Set the file to be read-only. 
boolean changed = myFile.setReadOnly(); 
if (changed) 
{ 
System.out.println(myFile.getAbsolutePath() + 
"is now read-only."); 
} 
else 
{ 
System.out.println(myFile.getAbsolutePath() + 
" cannot be set to read-only."); 
} 
} 
} 
/ * 
Output: 
C:\MyFile.txt is now read-only. 
my 
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File.toString Method 


Displays a human readable representation of a file or folder. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toString(); 


Return Value 
A human readable representation of a file or folder. The value displayed is the path of the file or folder. 


See Also 
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File-toURL Method 


Converts a file or folder into a URL (Uniform Resource Locator). 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.net.URL toURL() throws java.net.MalformedURLException; 


Return Value 
A URL representing the file or folder. 
Example 


The following example prints the URL of a file. 


// file_tourl.jsl 


import java.io.*; 
import java.net.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
try 
{ 
// Open the file C:\MyFile.txt. 
File myFile = new File("C:\\Windows\\..\\MyFile.txt"); 
URL url = myFile.toURL(); 
// If the file exists, display it's full path. 
if (myFile.exists()) 
{ 
System.out.println(url.toString() + " exists!"); 
} 
else 
{ 
System.out.printin(url.toString() + " does NOT exist!"); 
} 
catch (MalformedURLException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
/ * 
Output: 
file:/C:/MyFile.txt exists! 
*/ 
See Also 
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FileDescriptor Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final class java.io.FileDescriptor 
extends java.lang.Object 





Inheritance Hierarchy 
java.lang.Object 
java.io.FileDescriptor 


See Also 
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FileDescriptor Members 


The following tables list the members exposed by the FileDescriptor type. 


Public Constructors 
Name 


FileDescriptor 





Public Fields 





Name Description 





err 





out 








Public Methods 








Name Description 





Equals (inherited from Object ) 





Finalize 





GetHashCode (inherited from Object ) 





GetType (inherited from Object ) 





sync 





valid 














See Also 
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FileDescriptor Fields 


Public Fields 





Name Description 





err 








out 














See Also 
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FileDescriptor Class 
Concepts 

java.io Package 


Visual J# Reference 


FileDescriptor.err Field 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public static final java.io.FileDescriptor err; 





See Also 
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FileDescriptor.in Field 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public static final java.io.FileDescriptor in; 





See Also 

Reference 
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FileDescriptor.out Field 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public static final java.io.FileDescriptor out; 





See Also 
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FileDescriptor Constructor 


Initializes a new instance of the FileDescriptor Class . 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public java.io.FileDescriptor(); 





Remarks 
The default constructor initializes any fields to their default values. 
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FileDescriptor Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





finalize 





hashCode 


(inherited from Object ) 





getClass 


(inherited from Object ) 





sync 


valid 
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FileDescriptor.clone Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 





See Also 
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FileDescriptor.finalize Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected void finalize() throws java.io. IOException; 


See Also 
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FileDescriptor.sync Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void sync() throws java.io.SyncFailedException; 


See Also 

Reference 
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FileDescriptor.valid Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean valid(); 


See Also 

Reference 
FileDescriptor Class 
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java.io Package 
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FileFilter Interface 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public interface java.io.FileFilter 





See Also 
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FileFilter Members 


The following tables list the members exposed by the FileFilter type. 


Public Methods 
Name ——CSDeesecription, ess 
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FileFilter Methods 


Public Methods 





Name 


Description 





accept 











See Also 
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FileFilter.accept Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean accept( 


java.io.File pathname) ; 





Parameters 
pathname 


See Also 
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FilelnputStream Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.FileInputStream 
extends java.io.InputStream 





Inheritance Hierarchy 

java.lang.Object 
java.io.InputStream 
java.io.FilelnputStream 


See Also 

Concepts 

FilelnputStream Members 
java.io Package 
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FilelnputStream Members 


The following tables list the members exposed by the FilelnputStream type. 


Public Constructors 




















Name 

FilelnputStream 

Public Methods 

Name Description 

available Overridden. 

close Overridden. 

equals (inherited from Object ) 
finalize Overridden. 

getFD 

hashCode (inherited from Object ) 
getClass (inherited from Object ) 

mark (inherited from InputStream ) 
markSupported (inherited from InputStream ) 
clone (inherited from InputStream ) 
read Overloaded. Overridden. 
reset (inherited from InputStream ) 
skip Overridden. 

toString (inherited from InputStream ) 
See Also 
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FilelnputStream Constructor 


Overload List 





Name 


Description 





FilelnputStream (File) 





FilelnputStream (FileDescriptor) 





FilelnputStream (String) 
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FilelnputStream Constructor (File) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.FileInputStream( 
java.io.File file) throws java.io.FileNotFoundException; 


Parameters 


file 


See Also 
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FilelnputStream Constructor (FileDescriptor) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.FileInputStream( 
java.io.FileDescriptor fd); 


Parameters 


fd 


See Also 

Reference 
FilelnputStream Class 
Concepts 

FilelnputStream Members 
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FilelnputStream Constructor (String) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.FileInputStream( 
java.lang.String path) throws java.io.FileNotFoundException; 


Parameters 


path 


See Also 

Reference 
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FilelnputStream Methods 


Public Methods 


























Name Description 

available Overridden. 

close Overridden. 

equals (inherited from Object ) 
finalize Overridden. 

getFD 

hashCode (inherited from Object ) 
getClass (inherited from Object ) 

mark (inherited from InputStream ) 
markSupported (inherited from InputStream ) 
clone (inherited from InputStream ) 
read Overloaded. Overridden. 
reset (inherited from InputStream ) 
skip Overridden. 

toString (inherited from InputStream ) 
See Also 
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FilelnputStream Class 
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FilelnputStream.available Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int available() throws java.io. IOException; 


See Also 

Reference 
FilelnputStream Class 
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FilelnputStream.close Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void close() throws java.io. IOException; 


See Also 

Reference 
FilelnputStream Class 
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FilelnputStream.finalize Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected void finalize() throws java.io. IOException; 


See Also 

Reference 
FilelnputStream Class 
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FilelnputStream.getFD Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final java.io.FileDescriptor getFD() throws java.io. IOException; 


See Also 

Reference 
FilelnputStream Class 
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FilelnputStream.read Method 


Overload List 





Name Description 





FilelnputStream.read () 





FilelnputStream.read (byte[]) 





FilelnputStream.read (byte[], int, int) 











See Also 
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FilelnputStream.read Method () 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read() throws java.io. IOException; 


See Also 

Reference 
FilelnputStream Class 
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FilelnputStream.read Method (SByte []) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read( 
byte[] buffer) throws java.io. IOException; 


Parameters 


buffer 


See Also 

Reference 
FilelnputStream Class 
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FilelnputStream.read Method (SByte[], Int32, Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read( 
byte[] buffer, 
int offset, 
int count) throws java.io. IOException; 


Parameters 


buffer 
offset 
count 


See Also 
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FilelnputStream Class 
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FilelnputStream.skip Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public long skip( 
long count) throws java.io.IOException; 


Parameters 
count 


See Also 

Reference 
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FilenameFilter Interface 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public interface java.io.FilenameFilter 


See Also 

Concepts 

FilenameFilter Members 
java.io Package 


Visual J# Reference 


FilenameFilter Members 


The following tables list the members exposed by the FilenameFilter type. 


Public Methods 
Name —CSDeesecription, ess 
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FilenameFilter Methods 


Public Methods 





Name 


Description 





accept 











See Also 
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FilenameFilter.accept Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean accept( 
java.io.File dir, 
java.lang.String name); 


Parameters 


dir 
name 


See Also 
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FilenameFilter Interface 
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FileNotFoundException Class 


The exception that is thrown when an attempt is made to access a file that does not exist. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public class java.io.FileNotFoundException 
extends java.io.IOException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.io.IOException 
java.io.FileNotFoundException 


See Also 
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FileNotFoundException Members 


The exception that is thrown when an attempt is made to access a file that does not exist. 


The following tables list the members exposed by the FileNotFoundException type. 


Public Constructors 





Name 


Description 





FileNotFoundException 


Overloaded. Initializes a new instance of a FileNotFoundException object. 





Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 





Description 


(inherited from Exception ) 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 








printStackTrace 





getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 

clone (inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 








toString 


(inherited from Throwable ) 





Protected Methods 
Name 


finalize 





See Also 
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FileNotFoundException Constructor 


Initializes a new instance of a FileNotFoundException object. 


Overload List 


Name Description 
FileNotFoundException () Initializes a new instance of a FileNotFoundException object. 
FileNotFoundException (String) Initializes a new instance of a FileNotFoundException object with 


the given message. 





FileNotFoundException (SerializationInfo, StreamingContext)|Initializes a new instance of a FileNotFoundException object durin 
g deserialization. 


FileNotFoundException (String, Exception) Initializes a new instance of a FileNotFoundException object with 
the given message and inner exception. 
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java.io Package 
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FileNotFoundException Constructor () 


Initializes a new instance of a File NotFoundException object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.FileNotFoundException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
FileNotFoundException Class 
Concepts 

FileNotFoundException Members 
java.io Package 
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FileNotFoundException Constructor (String) 


Initializes a new instance of a FileNotFoundException object with the given message. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.FileNotFoundException( 
java.lang.String s); 


Parameters 
Ss 


A message describing the exceptional condition. 


See Also 

Reference 
FileNotFoundException Class 
Concepts 

FileNotFoundException Members 
java.io Package 
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FileNotFoundException Constructor (SerializationInfo, 
StreamingContext) 


Initializes a new instance of a FileNotFoundException object during deserialization. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected java.io.FileNotFoundException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
FileNotFoundException Class 
Concepts 

FileNotFoundException Members 
java.io Package 
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FileNotFoundException Constructor (String, Exception) 


Initializes a new instance of a FileNotFoundException object with the given message and inner exception. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.FileNotFoundException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the exceptional condition. 
inner 
An inner exception that led to the FileNotFoundException. 


See Also 

Reference 
FileNotFoundException Class 
Concepts 

FileNotFoundException Members 
java.io Package 


Visual J# Reference 


FileNotFoundException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


FileNotFoundException Class 


Concepts 
java.io Package 
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FileNotFoundException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
FileNotFoundException Class 
Concepts 

java.io Package 
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FileOutputStream Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.FileOutputStream 
extends java.io.OutputStream 





Inheritance Hierarchy 

java.lang.Object 
java.io.OutputStream 
java.io.FileOutputStream 


See Also 

Concepts 

FileOutputStream Members 
java.io Package 
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FileOutputStream Members 


The following tables list the members exposed by the FileOutputStream type. 


Public Constructors 




















Name 

FileOutputStream 

Public Methods 

Name Description 

close Overridden. 

equals (inherited from Object ) 

finalize Overridden. 

flush (inherited from OutputStream ) 
getFD 

hashCode (inherited from Object ) 
getClass (inherited from Object ) 

clone (inherited from OutputStream ) 
toString (inherited from OutputStream ) 
write Overloaded. Overridden. 

See Also 

Reference 

FileOutputStream Class 

Concepts 


java.io Package 
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FileOutputStream Constructor 


Overload List 





Name 


Description 





FileOutputStream (File) 





FileOutputStream (FileDescriptor) 





FileOutputStream (String) 





FileOutputStream (String, boolean) 








See Also 

Reference 
FileOutputStream Class 
Concepts 

FileOutputStream Members 
java.io Package 
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FileOutputStream Constructor (File) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.FileOutputStream( 
java.io.File file) throws java.io. IOException; 


Parameters 


file 


See Also 

Reference 
FileOutputStream Class 
Concepts 

FileOutputStream Members 
java.io Package 
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FileOutputStream Constructor (FileDescriptor) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.FileOutputStream( 
java.io.FileDescriptor fd); 


Parameters 


fd 


See Also 

Reference 
FileOutputStream Class 
Concepts 

FileOutputStream Members 
java.io Package 
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FileOutputStream Constructor (String) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.FileOutputStream( 
java.lang.String path) throws java.io. IOException; 


Parameters 


path 


See Also 

Reference 
FileOutputStream Class 
Concepts 

FileOutputStream Members 
java.io Package 
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FileOutputStream Constructor (String, Boolean) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.FileOutputStream( 
java.lang.String path, 
boolean append) throws java.io. IOException; 


Parameters 


path 
append 


See Also 

Reference 
FileOutputStream Class 
Concepts 

FileOutputStream Members 
java.io Package 
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FileOutputStream Methods 


Public Methods 


























Name Description 

close Overridden. 

equals (inherited from Object ) 

finalize Overridden. 

flush (inherited from OutputStream ) 
getFD 

hashCode (inherited from Object ) 
getClass (inherited from Object ) 

clone (inherited from OutputStream ) 
toString (inherited from OutputStream ) 
write Overloaded. Overridden. 

See Also 

Reference 

FileOutputStream Class 

Concepts 


java.io Package 
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FileOutputStream.close Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void close() throws java.io. IOException; 


See Also 

Reference 
FileOutputStream Class 
Concepts 

FileOQutputStream Members 
java.io Package 
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FileOutputStream.finalize Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected void finalize() throws java.io. IOException; 


See Also 

Reference 
FileOutputStream Class 
Concepts 

FileOQutputStream Members 
java.io Package 
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FileOutputStream.getFD Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final java.io.FileDescriptor getFD() throws java.io. IOException; 


See Also 

Reference 
FileOutputStream Class 
Concepts 

FileOQutputStream Members 
java.io Package 
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FileOutputStream.write Method 


Overload List 





Name 


Description 





FileOutputStream.write (int) 





FileOutputStream.write (byte[]) 





FileOutputStream.write (byte[], int, int) 











See Also 

Reference 
FileOutputStream Class 
Concepts 

FileOutputStream Members 
java.io Package 
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FileOutputStream.write Method (Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
int b) throws java.io.IOException; 


Parameters 


b 


See Also 

Reference 
FileOutputStream Class 
Concepts 

FileOutputStream Members 
java.io Package 
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FileOutputStream.write Method (SByte[ ]) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
byte[] data) throws java.io. IOException; 


Parameters 
data 


See Also 

Reference 
FileOutputStream Class 
Concepts 

FileOutputStream Members 
java.io Package 
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FileOutputStream.write Method (SByte[ ], Int32, Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
byte[] buffer, 
int offset, 
int count) throws java.io. IOException; 


Parameters 


buffer 
offset 
count 


See Also 

Reference 
FileOutputStream Class 
Concepts 

FileOutputStream Members 
java.io Package 
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FileReader Class 


Provides an implementation of the abstract Reader class used to provide a character stream for files. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public class java.io.FileReader 
extends java.io.InputStreamReader 





Inheritance Hierarchy 
java.lang.Object 
java.io.Reader 
java.io.InputStream Reader 
java.io.FileReader 


See Also 

Concepts 

FileReader Members 
java.io Package 
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FileRead 


er Members 


Provides an implementation of the abstract Reader class used to provide a character stream for files. 


The following tables list the members exposed by the FileReader type. 


Public Constructors 





Name 


Description 





FileReader 


Overloaded. Initializes a new instance of a FileReader object. 








Public Fields 
Name 





Description 


lock The object used to synchronize operations on the reader.(inherited from Reader) 





Name 


close 


equals 


getEncoding 


Public Methods 
Description 


Closes the underlying InputStream and releases all internal buffers. (inherited from InputStreamReader) 
(inherited from Object ) 


Returns the character encoding of the underlying InputStream object. (inherited from InputStreamReader) 











hashCode (inherited from Object ) 

getClass (inherited from Object ) 

mark Sets the mark to the next character of the characters to be read. (inherited from Reader) 

markSupported|/Determines whether the current position of the character can be marked. (inherited from Reader) 

clone Creates a shallow copy of the object. (inherited from Reader) 

read Overloaded. Reads the next character or characters from the underlying InputStream. (inherited from 
InputStreamReader) 

ready Determines whether the underlying InputStream object is ready for reading. (inherited from 
InputStreamReader) 

reset Resets the reader for the characters such that the next character read is the character that is marked. (inherited 
from Reader) 

skip Skips over the next count characters of the characters being read or until the end of the array, whichever is les 
s. (inherited from Reader) 

toString 





Displays a human readable representation of the reader. (inherited from Reader) 


Protected Methods 





Name 


Description 





finalize 





(inherited from Object ) 











See Also 
Reference 
FileReader Class 
Concepts 
java.io Package 
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FileReader Fields 


Public Fields 





Name _ Description 





lock The object used to synchronize operations on the reader. (inherited from Reader ) 











See Also 
Reference 
FileReader Class 
Concepts 
java.io Package 
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FileReader Constructor 


Initializes a new instance of a FileReader object. 


Overload List 
Name Description 


FileReader (File) Initializes a new instance of a FileReader object using the file represented by a given File. 
FileReader (FileDescriptor) |Initializes a new instance of a FileReader object using the file represented by the FileDescriptor. 


FileReader (String) Initializes a new instance of a FileReader object using the given file name. 





See Also 
Reference 
FileReader Class 
Concepts 

FileReader Members 
java.io Package 
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FileReader Constructor (File) 


Initializes a new instance of a FileReader object using the file represented by a given File. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.FileReader( 
java.io.File file) throws java.io.FileNotFoundException; 


Parameters 


file 
A File object representing the file to be read. 


See Also 

Reference 
FileReader Class 
Concepts 

FileReader Members 
java.io Package 
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FileReader Constructor (FileDescriptor) 


Initializes a new instance of a FileReader object using the file represented by the FileDescriptor. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.FileReader( 
java.io.FileDescriptor fd); 


Parameters 


fd 
A FileDescriptor object representing the file to be read. 


See Also 

Reference 
FileReader Class 
Concepts 

FileReader Members 
java.io Package 


Visual J# Reference 


FileReader Constructor (String) 


Initializes a new instance of a FileReader object using the given file name. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.FileReader( 
java.lang.String filename) throws java.io.FileNotFoundException; 


Parameters 
filename 


The name of the file to be read. 


See Also 

Reference 
FileReader Class 
Concepts 

FileReader Members 
java.io Package 
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FileReader Methods 


Public Methods 












































Name Description 

close Closes the underlying InputStream and releases all internal buffers. (inherited from InputStreamReader ) 

equals (inherited from Object ) 

getEncoding Returns the character encoding of the underlying InputStream object. (inherited from InputStreamReader ) 

hashCode (inherited from Object ) 

getClass (inherited from Object ) 

mark Sets the mark to the next character of the characters to be read. (inherited from Reader ) 

markSupported/Determines whether the current position of the character can be marked. (inherited from Reader ) 

clone Creates a shallow copy of the object. (inherited from Reader ) 

read Overloaded. Reads the next character or characters from the underlying InputStream. (inherited from 
InputStreamReader ) 

ready Determines whether the underlying InputStream object is ready for reading. (inherited from 
InputStreamReader ) 

reset Resets the reader for the characters such that the next character read is the character that is marked. (inherited 
from Reader ) 

skip Skips over the next count characters of the characters being read or until the end of the array, whichever is les 
s. (inherited from Reader ) 

toString Displays a human readable representation of the reader. (inherited from Reader ) 

Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 

FileReader Class 

Concepts 


java.io Package 
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FileWriter Class 


Provides an implementation of the abstract Writer class specific to writing files. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public class java.io.FileWriter 
extends java.io.OutputStreamwWriter 





Inheritance Hierarchy 
java.lang.Object 
java.io.Writer 
java.io.OutputStreamWriter 
java.io.FileWriter 


See Also 

Concepts 

FileWriter Members 
java.io Package 
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FileWriter Members 


Provides an implementation of the abstract Writer class specific to writing files. 


The following tables list the members exposed by the FileWriter type. 


Public Constructors 





Name Description 





FileWriter Overloaded. Initializes a new instance of a FileWriter object. 








Public Fields 
Name ___ |Description 





lock The object used to synchronize operations on the writer.(inherited from Writer) 





Public Methods 


Name Description 

close Closes the underlying OutputStream and releases all internal buffers. (inherited from OutputStreamWriter) 
equals (inherited from Object ) 

flush Flushes the underlying OutputStream object. (inherited from OutputStreamWriter) 


getEncoding/Returns the character encoding being used on this instance. (inherited from OutputStreamWriter) 





hashCode __|(inherited from Object ) 





getClass (inherited from Object ) 











clone Creates a shallow copy of this reader. (inherited from Writer) 

toString Displays a human readable representation of a Writer object. (inherited from Writer) 

write Overloaded. Writes the next character or characters to the underlying OutputStream. (inherited from 
OutputStreamWriter) 





Protected Methods 








Name Description 





finalize (inherited from Object ) 














See Also 
Reference 
FileWriter Class 
Concepts 
java.io Package 
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FileWriter Fields 


Public Fields 





Name __ |Description 





lock The object used to synchronize operations on the writer. (inherited from Writer ) 














See Also 
Reference 
FileWriter Class 
Concepts 
java.io Package 
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FileWriter Constructor 


Initializes a new instance of 


Overload List 
Name 


FileWriter (File) 


FileWriter (FileDescriptor) 


FileWriter (String) 


FileWriter (String, boolean) 





See Also 
Reference 
FileWriter Class 
Concepts 

FileWriter Members 
java.io Package 





a FileWriter object. 


Description 


Initializes a new instance of a FileWriter object using the file represented by a given File. 


Initializes a new instance of a FileWriter object using the file represented by the FileDescriptor. 


Initializes a new instance of a FileWriter object using the given file name. 


Initializes a new instance of a FileWriter object using the given file name. The file can either be app 
ended or overwritten. 
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FileWriter Constructor (File) 


Initializes a new instance of a FileWriter object using the file represented by a given File. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.Filewriter( 
java.io.File file) throws java.io. IOException; 


Parameters 


file 
A File object representing the file to be written to. 


See Also 

Reference 
FileWriter Class 
Concepts 

FileWriter Members 
java.io Package 
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FileWriter Constructor (FileDescriptor) 


Initializes a new instance of a FileWriter object using the file represented by the FileDescriptor. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.Filewriter( 
java.io.FileDescriptor fd); 


Parameters 


fd 
A FileDescriptor object representing the file to be written to. 


See Also 

Reference 
FileWriter Class 
Concepts 

FileWriter Members 
java.io Package 
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FileWriter Constructor (String) 


Initializes a new instance of a FileWriter object using the given file name. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.FilewWriter( 
java.lang.String filename) throws java.io. IOException; 


Parameters 
filename 


The name of the file to be read. 


See Also 

Reference 
FileWriter Class 
Concepts 

FileWriter Members 
java.io Package 
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FileWriter Constructor (String, Boolean) 


Initializes a new instance of a FileWriter object using the given file name. The file can either be appended or overwritten. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.FilewWriter( 
java.lang.String filename, 
boolean append) throws java.io. IOException; 


Parameters 
filename 


The name of the file to be read. 
append 
true to append to the end of the file; false to replace the file. 


See Also 

Reference 
FileWriter Class 
Concepts 

FileWriter Members 
java.io Package 
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FileWriter Methods 


Public Methods 














Name Description 

close Closes the underlying OutputStream and releases all internal buffers. (inherited from OutputStreamWriter ) 
equals (inherited from Object ) 

flush Flushes the underlying OutputStream object. (inherited from OutputStreamWriter ) 





getEncoding/Returns the character encoding being used on this instance. (inherited from OutputStreamWriter ) 

















Protected Methods 


hashCode __|(inherited from Object ) 

getClass (inherited from Object ) 

clone Creates a shallow copy of this reader. (inherited from Writer ) 

toString Displays a human readable representation of a Writer object. (inherited from Writer ) 

write Overloaded. Writes the next character or characters to the underlying OutputStream. (inherited from 


OutputStreamWriter ) 





Name 


Description 





finalize 








(inherited from Object ) 





See Also 
Reference 
FileWriter Class 
Concepts 
java.io Package 
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FilterInputStream Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.FilterInputStream 
extends java.io.InputStream 





Inheritance Hierarchy 
java.lang.Object 
java.io.InputStream 
java.io.FilterInputStream 
Derived Classes 


See Also 

Concepts 

FilterInputStream Members 
java.io Package 
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FilterInputStream Members 


The following tables list the members exposed by the FilterlnputStream type. 


Public Constructors 







































































Name Description 
FilterInputStream 

Public Fields 

Name Description 

in 

Public Methods 

Name Description 

available Overridden. 

close Overridden. 

equals (inherited from Object ) 
hashCode (inherited from Object ) 
getClass (inherited from Object ) 

mark Overridden. 

markSupported Overridden. 

clone (inherited from InputStream ) 
read Overloaded. Overridden. 
reset Overridden. 

skip Overridden. 

toString (inherited from InputStream ) 
Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 

FilterInputStream Class 

Concepts 


java.io Package 
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FilterInputStream Fields 


Public Fields 





Name 


Description 





in 











See Also 
Reference 


FilterInputStream Class 


Concepts 
java.io Package 
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FilterInputStream.in Field 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 





protected java.io.InputStream in; 





See Also 

Reference 
FilterInputStream Class 
Concepts 

FilterInputStream Members 
java.io Package 
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FilterInputStream Constructor 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected java.io.FilterInputStream( 


java.io.InputStream in); 





Parameters 
in 


See Also 

Reference 
FilterInputStream Class 
Concepts 

FilterInputStream Members 
java.io Package 
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FilterInputStream Methods 


Public Methods 



































Name Description 

available Overridden. 

close Overridden. 

equals (inherited from Object ) 
hashCode (inherited from Object ) 
getClass (inherited from Object ) 

mark Overridden. 

markSupported Overridden. 

clone (inherited from InputStream ) 
read Overloaded. Overridden. 
reset Overridden. 

skip Overridden. 

toString (inherited from InputStream ) 
Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 


FilterInputStream Class 


Concepts 
java.io Package 
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FilterInputStream.available Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int available() throws java.io. IOException; 


See Also 

Reference 
FilterInputStream Class 
Concepts 

FilterInputStream Members 
java.io Package 
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FilterInputStream.close Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void close() throws java.io. IOException; 


See Also 

Reference 
FilterInputStream Class 
Concepts 

FilterInputStream Members 
java.io Package 
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FilterInputStream.mark Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized void mark( 
int readlimit); 


Parameters 
readlimit 


See Also 

Reference 
FilterInputStream Class 
Concepts 

FilterInputStream Members 
java.io Package 
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FilterInputStream.markSupported Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean markSupported(); 


See Also 

Reference 
FilterInputStream Class 
Concepts 

FilterInputStream Members 
java.io Package 
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FilterInputStream.read Method 


Overload List 





Name 


Description 





FilterInputStream.read () 





FilterInputStream.read (byte[]) 





FilterInputStream.read (bytef], int, int) 











See Also 

Reference 
FilterInputStream Class 
Concepts 

FilterInputStream Members 
java.io Package 
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FilterInputStream.read Method () 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read() throws java.io. IOException; 


See Also 

Reference 
FilterInputStream Class 
Concepts 

FilterInputStream Members 
java.io Package 
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FilterInputStream.read Method (SByte[ ]) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read( 
byte[] b) throws java.io. IOException; 


Parameters 


b 


See Also 

Reference 
FilterInputStream Class 
Concepts 

FilterInputStream Members 
java.io Package 
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FilterInputStream.read Method (SByte[ J], Int32, Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read( 
byte[] b, 
int off, 
int len) throws java.io. IOException; 


Parameters 


b 


off 
len 


See Also 

Reference 
FilterInputStream Class 
Concepts 

FilterInputStream Members 
java.io Package 
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FilterInputStream.reset Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized void reset() throws java.io. IOException; 


See Also 

Reference 
FilterInputStream Class 
Concepts 

FilterInputStream Members 
java.io Package 
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FilterInputStream.skip Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public long skip( 
long n) throws java.io.IOException; 


Parameters 
n 


See Also 

Reference 
FilterInputStream Class 
Concepts 

FilterInputStream Members 
java.io Package 
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FilterOutputStream Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.FilterOutputStream 
extends java.io.OutputStream 





Inheritance Hierarchy 
java.lang.Object 
java.io.OutputStream 
java.io.FilterOutputStream 
Derived Classes 


See Also 

Concepts 

FilterOutputStream Members 
java.io Package 
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FilterOutputStream Members 


The following tables list the members exposed by the FilterOutputStream type. 


Public Constructors 


Name Description 





FilterOutputStream 


Public Fields 





Name Description 





out 








Public Methods 





























Name Description 

close Overridden. 

equals (inherited from Object ) 

flush Overridden. 

hashCode (inherited from Object ) 
getClass (inherited from Object ) 

clone (inherited from OutputStream ) 
toString (inherited from OutputStream ) 
write Overloaded. Overridden. 








Protected Methods 


Name Description 


finalize (inherited from Object ) 








See Also 

Reference 
FilterOutputStream Class 
Concepts 

java.io Package 
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FilterOutputStream Fields 


Public Fields 





Name Description 








out 











See Also 

Reference 
FilterOutputStream Class 
Concepts 

java.io Package 
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FilterOutputStream.out Field 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 





protected java.io.OutputStream out; 





See Also 

Reference 
FilterOutputStream Class 
Concepts 

FilterOutputStream Members 
java.io Package 
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FilterOutputStream Constructor 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.FilterOutputStream( 


java.io.OutputStream out); 





Parameters 
out 


See Also 

Reference 
FilterOutputStream Class 
Concepts 

FilterOutputStream Members 
java.io Package 
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FilterOutputStream Methods 


Public Methods 






































Name Description 

close Overridden. 

equals (inherited from Object ) 

flush Overridden. 

hashCode (inherited from Object ) 
getClass (inherited from Object ) 

clone (inherited from OutputStream ) 
toString (inherited from OutputStream ) 
write Overloaded. Overridden. 
Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 


FilterOutputStream Class 


Concepts 
java.io Package 
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FilterOutputStream.close Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void close() throws java.io. IOException; 


See Also 

Reference 
FilterOutputStream Class 
Concepts 

FilterOutputStream Members 
java.io Package 
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FilterOutputStream.flush Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void flush() throws java.io. IOException; 


See Also 

Reference 
FilterOutputStream Class 
Concepts 

FilterOutputStream Members 
java.io Package 
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FilterOutputStream.write Method 


Overload List 





Name 


Description 





FilterOutputStream.write (int) 





FilterOutputStream.write (byte[]) 





FilterOutputStream.write (bytel], int, int) 











See Also 

Reference 
FilterOutputStream Class 
Concepts 

FilterOutputStream Members 
java.io Package 





Visual J# Reference 


FilterOutputStream.write Method (Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
int b) throws java.io.IOException; 


Parameters 


b 


See Also 

Reference 
FilterOutputStream Class 
Concepts 

FilterOutputStream Members 
java.io Package 


Visual J# Reference 


FilterOutputStream.write Method (SByte[ ]) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
byte[] b) throws java.io. IOException; 


Parameters 


b 


See Also 

Reference 
FilterOutputStream Class 
Concepts 

FilterOutputStream Members 
java.io Package 


Visual J# Reference 


FilterOutputStream.write Method (SByte[ J, Int32, Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
byte[] b, 
int off, 
int len) throws java.io.IOException; 


Parameters 


b 


off 
len 


See Also 

Reference 
FilterOutputStream Class 
Concepts 

FilterOutputStream Members 
java.io Package 


Visual J# Reference 


FilterReader Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract class java.io.FilterReader 
extends java.io.Reader 





Inheritance Hierarchy 
java.lang.Object 
java.io.Reader 
java.io.FilterReader 
java.io.PushbackReader 


See Also 

Concepts 

FilterReader Members 
java.io Package 


Visual J# Reference 


FilterReader Members 


The following tables list the members exposed by the FilterReader type. 


Public Constructors 
Name 


FilterReader 





Public Fields 





Name _ |Description 





in 





lock The object used to synchronize operations on the reader.(inherited from Reader) 








Public Methods 























Name Description 
close Overridden. 
equals (inherited from Object ) 
hashCode (inherited from Object ) 
getClass (inherited from Object ) 
mark Overridden. 





markSupported Overridden. 




















clone Creates a shallow copy of the object. (inherited from Reader) 

read Overloaded. Overridden. 

ready Overridden. 

reset Overridden. 

skip Overridden. 

toString Displays a human readable representation of the reader. (inherited from Reader) 














Protected Methods 
Name Description 





finalize (inherited from Object ) 














See Also 
Reference 
FilterReader Class 
Concepts 

java.io Package 


Visual J# Reference 


FilterReader Fields 


Public Fields 





Name _ Description 





in 





lock The object used to synchronize operations on the reader. (inherited from Reader ) 











See Also 
Reference 
FilterReader Class 
Concepts 

java.io Package 


Visual J# Reference 


FilterReader.in Field 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 





protected java.io.Reader in; 





See Also 

Reference 
FilterReader Class 
Concepts 

FilterReader Members 
java.io Package 


Visual J# Reference 


FilterReader Constructor 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected java.io.FilterReader( 


java.io.Reader in); 





Parameters 
in 


See Also 

Reference 
FilterReader Class 
Concepts 

FilterReader Members 
java.io Package 


Visual J# Reference 


FilterReader Methods 


Public Methods 



































Name Description 

close Overridden. 

equals (inherited from Object ) 

hashCode (inherited from Object ) 

getClass (inherited from Object ) 

mark Overridden. 

markSupported Overridden. 

clone Creates a shallow copy of the object. (inherited from Reader ) 
read Overloaded. Overridden. 

ready Overridden. 

reset Overridden. 

skip Overridden. 

toString Displays a human readable representation of the reader. (inherited from Reader ) 
Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 


FilterReader Class 


Concepts 
java.io Package 





Visual J# Reference 


FilterReader.close Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void close() throws java.io. IOException; 


See Also 

Reference 
FilterReader Class 
Concepts 

FilterReader Members 
java.io Package 


Visual J# Reference 


FilterReader.mark Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void mark( 
int readlimit) throws java.io. IOException; 


Parameters 
readlimit 


See Also 

Reference 
FilterReader Class 
Concepts 

FilterReader Members 
java.io Package 


Visual J# Reference 


FilterReader.markSupported Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean markSupported(); 


See Also 

Reference 
FilterReader Class 
Concepts 

FilterReader Members 
java.io Package 


Visual J# Reference 


FilterReader.read Method 


Overload List 





Name Description 





FilterReader.read () 





FilterReader.read (char[]) Reads the characters in the array starting at an offset for the length specified and stores them 
in the provided array of characters. 


FilterReader.read (char[], int, int) 








See Also 

Reference 
FilterReader Class 
Concepts 

FilterReader Members 
java.io Package 





Visual J# Reference 


FilterReader.read Method () 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read() throws java.io. IOException; 


See Also 

Reference 
FilterReader Class 
Concepts 

FilterReader Members 
java.io Package 


Visual J# Reference 


FilterReader.read Method (CharT J, Int32, Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read( 
char[] b, 
int off, 
int len) throws java.io.IOException; 


Parameters 


b 


off 
len 


See Also 

Reference 
FilterReader Class 
Concepts 

FilterReader Members 
java.io Package 


Visual J# Reference 


FilterReader.ready Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean ready() throws java.io. IOException; 


See Also 

Reference 
FilterReader Class 
Concepts 

FilterReader Members 
java.io Package 


Visual J# Reference 


FilterReader.reset Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void reset() throws java.io. IOException; 


See Also 

Reference 
FilterReader Class 
Concepts 

FilterReader Members 
java.io Package 


Visual J# Reference 


FilterReader.skip Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public long skip( 


long n) throws java.io.IOException; 





Parameters 
n 


See Also 

Reference 
FilterReader Class 
Concepts 

FilterReader Members 
java.io Package 


Visual J# Reference 


FilterWriter Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract class java.io.FilterwWriter 
extends java.io.Writer 





Inheritance Hierarchy 

java.lang.Object 
java.io.Writer 
java.io.FilterWriter 


See Also 

Concepts 

FilterWriter Members 
java.io Package 


Visual J# Reference 


FilterWriter Members 


The following tables list the members exposed by the FilterWriter type. 


Public Constructors 
Name 


FilterWriter 





Public Fields 
Name ___ Description 








lock The object used to synchronize operations on the writer.(inherited from Writer) 





out 











Public Methods 














Name Description 

close Overridden. 

equals (inherited from Object ) 
flush Overridden. 





hashCode (inherited from Object ) 














getClass (inherited from Object ) 

clone Creates a shallow copy of this reader. (inherited from Writer) 

toString Displays a human readable representation of a Writer object. (inherited from Writer) 
write Overloaded. 








Protected Methods 


Name Description 


finalize (inherited from Object ) 











See Also 
Reference 
FilterWriter Class 
Concepts 

java.io Package 


Visual J# Reference 


FilterWriter Fields 


Public Fields 





Name |Description 





lock The object used to synchronize operations on the writer. (inherited from Writer ) 





out 














See Also 
Reference 
FilterWriter Class 
Concepts 

java.io Package 


Visual J# Reference 


FilterWriter.out Field 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 





protected java.io.Writer out; 





See Also 

Reference 
FilterWriter Class 
Concepts 

FilterWriter Members 
java.io Package 


Visual J# Reference 


FilterWriter Constructor 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected java.io.Filterwriter( 


java.io.Writer out); 





Parameters 
out 


See Also 

Reference 
FilterWriter Class 
Concepts 

FilterWriter Members 
java.io Package 


Visual J# Reference 


FilterWriter Methods 


Public Methods 














Name Description 

close Overridden. 

equals (inherited from Object ) 
flush Overridden. 





hashCode (inherited from Object ) 





getClass (inherited from Object ) 

clone Creates a shallow copy of this reader. (inherited from Writer ) 

toString Displays a human readable representation of a Writer object. (inherited from Writer ) 
write Overloaded. 





Protected Methods 





Name Description 





finalize (inherited from Object ) 














See Also 
Reference 
FilterWriter Class 
Concepts 

java.io Package 


Visual J# Reference 


FilterWriter.close Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void close() throws java.io. IOException; 


See Also 

Reference 
FilterWriter Class 
Concepts 

FilterWriter Members 
java.io Package 


Visual J# Reference 


FilterWriter.flush Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void flush() throws java.io. IOException; 


See Also 

Reference 
FilterWriter Class 
Concepts 

FilterWriter Members 
java.io Package 


Visual J# Reference 


FilterWriter.write Method 


Overload List 
Name 





Description 





FilterWriter.write (char[]) Places the given array of characters into the internal buffer holding the characters. 





FilterWriter.write (int) 





FilterWriter.write (String) Places the given string into the internal buffer holding characters. 





FilterWriter.write (char[], int, int) 





FilterWriter.write (String, int, int) 











See Also 
Reference 


FilterWriter Class 
Concepts 


FilterWriter Members 
java.io Package 


Visual J# Reference 


FilterWriter.write Method (Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
int oneChar) throws java.io.IOException; 


Parameters 
oneChar 


See Also 

Reference 
FilterWriter Class 
Concepts 

FilterWriter Members 
java.io Package 
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FilterWriter.write Method (Char[ ], Int32, Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
char[] b, 
int offset, 
int count) throws java.io. IOException; 


Parameters 


count 


See Also 

Reference 
FilterWriter Class 
Concepts 

FilterWriter Members 
java.io Package 
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FilterWriter.write Method (String, Int32, Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
java.lang.String str, 
int offset, 
int count) throws java.io. IOException; 


Parameters 
str 


offset 
count 


See Also 

Reference 
FilterWriter Class 
Concepts 

FilterWriter Members 
java.io Package 
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InputStream Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract class java.io.InputStream 
extends java.lang.Object 





Inheritance Hierarchy 
java.lang.Object 
java.io.InputStream 


See Also 

Concepts 

InputStream Members 
java.io Package 


Visual J# Reference 


InputStream Members 


The following tables list the members exposed by the InputStream type. 


Public Constructors 
Name 


InputStream 


Public Methods 


Description 








Name 


Description 





available 





close 


equals 


hashCode 


getClass 


mark 


markSupported 


read 


reset 


skip 


Protected Methods 


(inherited from Object ) 


(inherited from Object ) 


(inherited from Object ) 


Overloaded. 





Name 


Description 





finalize 








(inherited from Object ) 





See Also 
Reference 
InputStream Class 
Concepts 

java.io Package 





Visual J# Reference 


InputStream Constructor 


Initializes a new instance of the InputStream Class . 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public java.io.InputStream(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
InputStream Class 
Concepts 

InputStream Members 
java.io Package 
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InputStream Methods 


Public Methods 





Name 


Description 





available 





close 





equals 


(inherited from Object ) 





hashCode 


(inherited from Object ) 





getClass 


mark 


markSupported 


read 


reset 


skip 





Protected Methods 


(inherited from Object ) 


Overloaded. 





Name 


Description 





finalize 








(inherited from Object ) 





See Also 
Reference 


InputStream Class 
Concepts 
java.io Package 








Visual J# Reference 


InputStream.available Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int available() throws java.io. IOException; 


See Also 

Reference 
InputStream Class 
Concepts 

InputStream Members 
java.io Package 


Visual J# Reference 


InputStream.close Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void close() throws java.io. IOException; 


See Also 

Reference 
InputStream Class 
Concepts 

InputStream Members 
java.io Package 


Visual J# Reference 


InputStream.mark Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized void mark( 
int readlimit); 





Parameters 
readlimit 


See Also 

Reference 
InputStream Class 
Concepts 

InputStream Members 
java.io Package 


Visual J# Reference 


InputStream.markSupported Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean markSupported(); 


See Also 

Reference 
InputStream Class 
Concepts 

InputStream Members 
java.io Package 


Visual J# Reference 


InputStream.read Method 


Overload List 





Name Description 





InputStream.read () 





InputStream.read (byte[]) 





InputStream.read (bytel], int, int) 











See Also 

Reference 
InputStream Class 
Concepts 

InputStream Members 
java.io Package 


Visual J# Reference 


InputStream.read Method () 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract int read() throws java.io. IOException; 


See Also 

Reference 
InputStream Class 
Concepts 

InputStream Members 
java.io Package 


Visual J# Reference 


InputStream.read Method (SByte[ ]) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read( 
byte[] b) throws java.io. IOException; 


Parameters 


b 


See Also 

Reference 
InputStream Class 
Concepts 

InputStream Members 
java.io Package 


Visual J# Reference 


InputStream.read Method (SByte[ ], Int32, Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read( 
byte[] b, 
int off, 
int count) throws java.io. IOException; 


Parameters 


b 


off 
count 


See Also 

Reference 
InputStream Class 
Concepts 

InputStream Members 
java.io Package 


Visual J# Reference 


InputStream.reset Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized void reset() throws java.io. IOException; 


See Also 

Reference 
InputStream Class 
Concepts 

InputStream Members 
java.io Package 


Visual J# Reference 


InputStream.skip Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public long skip( 
long count) throws java.io.IOException; 





Parameters 
count 


See Also 

Reference 
InputStream Class 
Concepts 

InputStream Members 
java.io Package 
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InputStreamReader Class 


Provides an implementation of the abstract Reader class specific to reading characters in an InputStream object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io. InputStreamReader 
extends java.io.Reader 


Example 


The following example demonstrates the close, getEncoding, read, and ready methods of the InputStreamReader class. 


// inputstreamreader_overview. jsl 
import java.io.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
try 
{ 
// Create a new instance of a InputStreamReader object 
// attached to a StringBufferInputStream. 
String s = "StringBufferInputStream" ; 
StringBufferInputStream buf = new StringBufferInputStream(s) ; 
InputStreamReader reader = new InputStreamReader (buf) ; 


// Read from the input stream. 
char[] arr = new char[s.length()]; 
if (reader.ready()) 

{ 


} 


System.out.println(arr) ; 


reader.read(arr, @, arr.length); 


// Display the encoding of the input stream. 
System.out.println("encoding: " + reader.getEncoding()); 


// Close the InputStreamReader and the 
// StringBufferInputStream objects. 
buf.close(); 

reader.close(); 


} 
catch (IOException ex) 


i 
} 


System.out.printin(ex.toString()); 


} 


/* 

Output: 
StringBufferInputStream 
encoding: Cp1252 

*/ 


Inheritance Hierarchy 


java.lang.Object 


java.io.Reader 
java.io.InputStream Reader 
java.io.FileReader 


See Also 

Concepts 

InputStreamReader Members 
java.io Package 


Visual J# Reference 


InputStreamReader Members 


Provides an implementation of the abstract Reader class specific to reading characters in an InputStream object. 


The following tables list the members exposed by the InputStreamReader type. 


Public Constructors 





Name 


Description 





InputStreamReader Overloaded. Initializes a new instance of an InputStreamReader object. 








Public Fields 
Name 





Description 


lock The object used to synchronize operations on the reader.(inherited from Reader) 





Name 


close 


equals 


getEncoding 


Public Methods 


Description 


Overridden. Closes the underlying InputStream and releases all internal buffers. 
(inherited from Object ) 


Returns the character encoding of the underlying InputStream object. 

















hashCode (inherited from Object ) 

getClass (inherited from Object ) 

mark Sets the mark to the next character of the characters to be read. (inherited from Reader) 

markSupported|/Determines whether the current position of the character can be marked. (inherited from Reader) 

clone Creates a shallow copy of the object. (inherited from Reader) 

read Overloaded. Overridden. Reads the next character or characters from the underlying InputStream. 

ready Overridden. Determines whether the underlying InputStream object is ready for reading. 

reset Resets the reader for the characters such that the next character read is the character that is marked. (inherited 
from Reader) 

skip Skips over the next count characters of the characters being read or until the end of the array, whichever is les 
s. (inherited from Reader) 

toString Displays a human readable representation of the reader. (inherited from Reader) 





Protected Methods 

















Name Description 
finalize (inherited from Object ) 
See Also 


Reference 





InputStreamReader Class 
Concepts 
java.io Package 


Visual J# Reference 


InputStreamReader Fields 


Public Fields 





Name _ Description 





lock The object used to synchronize operations on the reader. (inherited from Reader ) 











See Also 

Reference 
InputStreamReader Class 
Concepts 

java.io Package 


Visual J# Reference 


InputStreamReader Constructor 


Initializes a new instance of an InputStreamReader object. 


Overload List 
Name 





Description 


InputStreamReader (InputStream) Initializes a new instance of an InputStreamReader object using the given 
InputStream object as the underlying stream. 





InputStreamReader (InputStream, String)|Initializes a new instance of an InputStreamReader object using the given InputStrea 
m object as the underlying stream. Also specifies the character encoding of the unde 
rlying stream. 











See Also 

Reference 
InputStreamReader Class 
Concepts 

InputStreamReader Members 
java.io Package 


Visual J# Reference 


InputStreamReader Constructor (InputStream) 


Initializes a new instance of an InputStreamReader object using the given InputStream object as the underlying stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io. InputStreamReader( 
java.io.InputStream in); 


Parameters 
in 


The underlying input stream to read from. 


See Also 

Reference 
InputStreamReader Class 
Concepts 

InputStreamReader Members 
java.io Package 


Visual J# Reference 


InputStreamReader Constructor (InputStream, String) 


Initializes a new instance of an InputStreamReader object using the given InputStream object as the underlying stream. Also 
specifies the character encoding of the underlying stream. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io. InputStreamReader( 
java.io.InputStream in, 
java.lang.String enc) throws java.io.UnsupportedEncodingException; 


Parameters 
in 


The underlying input stream to read from. 
enc 
The character encoding of the input stream (such as Unicode). 


See Also 

Reference 
InputStreamReader Class 
Concepts 

InputStreamReader Members 
java.io Package 


Visual J# Reference 


InputStreamReader Methods 


Public Methods 















































Name Description 

close Overridden. Closes the underlying InputStream and releases all internal buffers. 

equals (inherited from Object ) 

getEncoding _ |Returns the character encoding of the underlying InputStream object. 

hashCode (inherited from Object ) 

getClass (inherited from Object ) 

mark Sets the mark to the next character of the characters to be read. (inherited from Reader ) 

markSupported/Determines whether the current position of the character can be marked. (inherited from Reader ) 

clone Creates a shallow copy of the object. (inherited from Reader ) 

read Overloaded. Overridden. Reads the next character or characters from the underlying InputStream. 

ready Overridden. Determines whether the underlying InputStream object is ready for reading. 

reset Resets the reader for the characters such that the next character read is the character that is marked. (inherited 
from Reader ) 

skip Skips over the next count characters of the characters being read or until the end of the array, whichever is les 
s. (inherited from Reader ) 

toString Displays a human readable representation of the reader. (inherited from Reader ) 

Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 


InputStreamReader Class 


Concepts 
java.io Package 
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InputStreamReader.close Method 


Closes the underlying InputStream and releases all internal buffers. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void 


Example 


close() throws java.io. IOException; 


The following example demonstrates how to close a InputStreamReader object. 


// inputstreamreader_close.jsl 


import java. 


10:.*3 


public class Program 


public static void main(String[] args) 


// Create a new instance of a InputStreamReader object 

// attached to a StringBufferInputStream. 

String s = "StringBufferInputStream" ; 
StringBufferInputStream buf = new StringBufferInputStream(s) ; 
InputStreamReader reader = new InputStreamReader (buf) ; 


// Read from the input stream. 
int charRead; 
while ((charRead = reader.read()) >= @) 


d 
} 


// Close the InputStreamReader and the 
// StringBufferInputStream objects. 
buf.close(); 

reader.close(); 


System.out.print((char)charRead) ; 


catch (IOException ex) 


System.out.printin(ex.toString()); 


StringBufferInputStream 


{ 
try 
{ 
{ 
li 
} 
} 
/* 
Output: 
*/ 
See Also 
Reference 


InputStreamReader Class 


Concepts 


InputStreamReader Members 


java.io Package 
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InputStreamReader.getEncoding Method 


Returns the character encoding of the underlying InputStream object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getEncoding(); 


Return Value 
The character encoding of the underlying InputStream object. 
Example 


The following example demonstrates how to determine the encoding of the underlying input stream. 


// inputstreamreader_getencoding.jsl 
import java.io.*; 


public class Program 


{ 


public static void main(String[] args) 
if 
try 
{ 
// Create a new instance of a InputStreamReader object 
// attached to a StringBufferInputStream. 
String s = "StringBufferInputStream" ; 
StringBufferInputStream buf = new StringBufferInputStream(s) ; 
InputStreamReader reader = new InputStreamReader (buf) ; 


// Read from the input stream. 
int charRead; 
while ((charRead = reader.read()) >= @) 


‘ 


} 
System.out.print1n(); 


System.out.print((char)charRead) ; 


// Display the encoding of the input stream. 
System.out.println("encoding: " + reader.getEncoding()); 


// Close the InputStreamReader and the 
// StringBufferInputStream objects. 
buf.close(); 

reader.close(); 


catch (IOException ex) 
{ 


System.out.println(ex.toString()); 


} 


/* 

Output: 
StringBufferInputStream 
encoding: Cp1252 

*/ 


See Also 


Reference 
InputStreamReader Class 
Concepts 

InputStreamReader Members 
java.io Package 
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InputStreamReader.read Method 


Reads the next character or characters from the underlying InputStream. 


Overload List 


Name Description 
InputStreamReader.read () Reads the next character from the underlying InputStream. 
InputStreamReader.read (char[]) Reads the characters in the array starting at an offset for the length specified and store 


s them in the provided array of characters. 





InputStreamReader.read (char[], int, int)/Reads count characters from the underlying InputStream object, starting from an offse 
t, and stores the characters in the provided buffer. 








See Also 

Reference 
InputStreamReader Class 
Concepts 

InputStreamReader Members 
java.io Package 
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InputStreamReader.read Method () 


Reads the next character from the underlying InputStream. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read() throws java.io. IOException; 


Return Value 


The numeric value of the character read using the character encoding of the system (such as UTF-8). 


Example 


The following example demonstrates how to read one character at a time from an input stream. 


// inputstreamreader_read.jsl 


import java.io.*; 


public class Program 


public static void main(String[] args) 


try 
{ 


// Create a new instance of a InputStreamReader object 

// attached to a StringBufferInputStream. 

String s = "StringBufferInputStream" ; 
StringBufferInputStream buf = new StringBufferInputStream(s) ; 
InputStreamReader reader = new InputStreamReader (buf) ; 


// Read from the input stream. 
int charRead; 
while ((charRead = reader.read()) >= @) 


‘ 


} 
System.out.print1n(); 


System.out.print((char)charRead) ; 


// Close the InputStreamReader and the 
// StringBufferInputStream objects. 
buf.close(); 

reader.close(); 


catch (IOException ex) 


{ 
} 


System.out.println(ex.toString()); 


StringBufferInputStream 


{ 
{ 
i 
ij 
/* 
Output: 
*/ 
See Also 
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InputStreamReader Members 


java.io Package 
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InputStreamReader.read Method (CharT J, Int32, Int32) 


Reads count characters from the underlying InputStream object, starting from an offset, and stores the characters in the 
provided buffer. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read( 
char[] buf, 
int offset, 
int count) throws java.io. IOException; 


Parameters 
buf 

A buffer to store the characters read from the underlying InputStream. 
offset 


An offset into the array of characters. This value represents the index of the first character in the array to be written. This 
value must be greater than zero. 


count 


The number of characters to be read from the underlying stream. This value plus the offset must be less than the overall 
length of the buffer. 


Return Value 
The number of characters read from the underlying InputStream. 
Example 


The following example demonstrates how to read from an input stream and store the data read into an array. 
// inputstreamreader_read_2.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
try 
{ 


// Create a new instance of a InputStreamReader object 

// attached to a StringBufferInputStream. 

String s = "StringBufferInputStream" ; 
StringBufferInputStream buf = new StringBufferInputStream(s) ; 
InputStreamReader reader = new InputStreamReader (buf) ; 


// Read from the input stream. 
char[] arr = new char[s.length()]; 
reader.read(arr, @, arr.length); 
System.out.println(arr) ; 


// Close the InputStreamReader and the 
// StringBufferInputStream objects. 
buf.close(); 

reader.close(); 


catch (IOException ex) 


{ 
System.out.println(ex.toString()); 


} 
} 
/* 
Output: 


StringBufferInputStream 
*/ 





See Also 

Reference 
InputStreamReader Class 
Concepts 

InputStreamReader Members 
java.io Package 
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InputStreamReader.ready Method 


Determines whether the underlying InputStream object is ready for reading. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean ready() throws java.io. IOException; 


Return Value 


true if the underlying InputStream object is ready for reading; false otherwise. 


Example 


The following example demonstrates how to determine if an input stream is ready to be read from. 


// inputstreamreader_ready.jsl 


import java.io.*; 


public class Program 


public static void main(String[] args) 


try 
{ 


// Create a new instance of a InputStreamReader object 

// attached to a StringBufferInputStream. 

String s = "StringBufferInputStream" ; 
StringBufferInputStream buf = new StringBufferInputStream(s) ; 
InputStreamReader reader = new InputStreamReader (buf) ; 


// Read from the input stream. 
char[] arr = new char[s.length()]; 
if (reader.ready()) 


{ 
} 


System.out.println(arr) ; 


reader.read(arr, @, arr.length); 


// Close the InputStreamReader and the 
// StringBufferInputStream objects. 
buf.close(); 

reader.close(); 


catch (IOException ex) 


{ 
} 


System.out.println(ex.toString()); 


StringBufferInputStream 


{ 
{ 
i 
ij 
/* 
Output: 
*/ 
See Also 
Reference 


InputStreamReader Class 


Concepts 


InputStreamReader Members 


java.io Package 
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InterruptedIOException Class 


The exception that is thrown when a timeout has occurred or there was an interruption during an I/O operation. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public class java.io.InterruptedIOException 
extends java.io.IOException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.io.IOException 
java.io.InterruptedlOException 


See Also 

Concepts 

InterruptedIOException Members 
java.io Package 
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InterruptedIOException Members 


The exception that is thrown when a timeout has occurred or there was an interruption during an I/O operation. 


The following tables list the members exposed by the InterruptedlOException type. 


Public Constructors 





Name Description 





InterruptedIOException Overloaded. Initializes a new instance of an InterruptedlOException object. 








Public Fields 


Name 





bytesTransferred |Contains the number of bytes that were successfully transferred before the I/O operation was interrupted. 





Public Properties (see also Protected Properties 


Name Description 

HelpLink (inherited from Exception ) 
InnerException (inherited from Exception ) 
Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 


Protected Properties 





Name Description 





HResult (inherited from Exception ) 








Public Methods 











Name Description 

equals (inherited from Object ) 

filllnStackTrace (inherited from Throwable ) 

GetBaseException (inherited from Exception ) 

hashCode (inherited from Object ) 

getLocalizedMessage (inherited from Throwable ) 

getMessage (inherited from Throwable ) 

GetObjectData Overridden. Retrieves the data to be serialized. 





getClass (inherited from Object ) 














clone (inherited from Throwable ) 





printStackTrace Overloaded. (inherited from Throwable ) 





toString (inherited from Throwable ) 





Protected Methods 
Name 


finalize (inherited from Object ) 








See Also 

Reference 
InterruptedIOException Class 
Concepts 

java.io Package 
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InterruptedIOException Fields 


Public Fields 


Name Description 











bytesTransferred |Contains the number of bytes that were successfully transferred before the I/O operation was interrupted. 








See Also 

Reference 
InterruptedIOException Class 
Concepts 

java.io Package 
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InterruptedIOException.bytesTransferred Field 


Contains the number of bytes that were successfully transferred before the I/O operation was interrupted. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int bytesTransferred; 


See Also 

Reference 
InterruptedIOException Class 
Concepts 

InterruptedIOException Members 
java.io Package 
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InterruptedIOException Constructor 


Initializes a new instance of an Interrupted|OException object. 


Overload List 


Name Description 
InterruptedIOException () Initializes a new instance of an Interrupted|OException object. 
Interrupted|IOException (String) Initializes a new instance of an InterruptedIOException object wit 


h the given message. 





Interrupted|OException (SerializationInfo, StreamingContext)|Initializes a new instance of an InterruptedIOException object duri 
ng deserialization. 


InterruptedIOException (String, Exception) Initializes a new instance of an InterruptedIOException object wit 
h the given message and inner exception. 








See Also 

Reference 
InterruptedIOException Class 
Concepts 

InterruptedIOException Members 
java.io Package 
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InterruptedIOException Constructor () 


Initializes a new instance of an Interrupted|OException object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io. InterruptedIOException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
InterruptedIOException Class 
Concepts 

InterruptedIOException Members 
java.io Package 
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Interrupted|OException Constructor (String) 


Initializes a new instance of an InterruptedIOException object with the given message. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io. InterruptedIOException( 
java.lang.String s); 


Parameters 
Ss 


A message describing the exceptional condition. 


See Also 

Reference 
InterruptedIOException Class 
Concepts 

InterruptedIOException Members 
java.io Package 
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InterruptedI|OException Constructor (SerializationInfo, 
StreamingContext) 


Initializes a new instance of an InterruptedIOException object during deserialization. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected java.io. InterruptedIOException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
InterruptedIOException Class 
Concepts 

InterruptedIOException Members 
java.io Package 
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InterruptedlOException Constructor (String, Exception) 


Initializes a new instance of an InterruptedIOException object with the given message and inner exception. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io. InterruptedIOException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the exceptional condition. 
inner 
An inner exception that led to the InterruptedIOException. 


See Also 

Reference 
InterruptedIOException Class 
Concepts 

InterruptedIOException Members 
java.io Package 
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InterruptedIOException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


Overridden. Retrieves the data to be serialized. 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


InterruptedIOException Class 


Concepts 
java.io Package 
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InterruptedlOException.GetObjectData Method 


Retrieves the data to be serialized. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void GetObjectData( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization process. 


See Also 

Reference 
InterruptedIOException Class 
Concepts 

InterruptedIOException Members 
java.io Package 
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InterruptedlOException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
InterruptedIOException Class 
Concepts 

java.io Package 
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InvalidClassException Class 


The exception that is thrown when an attempt is made to serialize or deserialize an instance of a class that does not support 
serialization. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.InvalidClassException 
extends java.io.ObjectStreamException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.io.IOException 
java.io.ObjectStreamException 
java.io.InvalidClassException 


See Also 

Concepts 

InvalidClassException Members 
java.io Package 
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InvalidClassException Members 


The exception that is thrown when an attempt is made to serialize or deserialize an instance of a class that does not support 
serialization. 


The following tables list the members exposed by the InvalidClassException type. 


Public Constructors 


InvalidClassException Overloaded. Initializes a new instance of an InvalidClassException object. 











Public Fields 
Name Description 
classname The name of the class that cannot be serialized or deserialized. 











Public Properties (see also Protected Properties ) 























Name Description 

HelpLink (inherited from Exception ) 
InnerException (inherited from Exception ) 
Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult (inherited from Exception ) 





Public Methods 

















Name Description 

equals (inherited from Object ) 

filllnStackTrace (inherited from Throwable ) 

GetBaseException (inherited from Exception ) 

hashCode (inherited from Object ) 

getLocalizedMessage (inherited from Throwable ) 

getMessage Overridden. Provides the message describing the exceptional condition. 
GetObjectData Overridden. Retrieves the data to be serialized. 


getClass (inherited from Object ) 











clone (inherited from Throwable ) 


printStackTrace Overloaded. (inherited from Throwable ) 


toString (inherited from Throwable ) 








Protected Methods 








Name Description 





finalize (inherited from Object ) 














See Also 

Reference 
InvalidClassException Class 
Concepts 

java.io Package 
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InvalidClassException Fields 


Public Fields 

















Name Description 

classname The name of the class that cannot be serialized or deserialized. 
See Also 

Reference 

InvalidClassException Class 

Concepts 


java.io Package 
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InvalidClassException.classname Field 


The name of the class that cannot be serialized or deserialized. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String classname; 


See Also 

Reference 
InvalidClassException Class 
Concepts 

InvalidClassException Members 
java.io Package 
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InvalidClassException Constructor 


Initializes a new instance of an InvalidClassException object. 


Overload List 
Name 


InvalidClassException (String) 


Description 


Initializes a new instance of an InvalidClassException object with th 
e given message. 





InvalidClassException (SerializationInfo, StreamingContext) 


InvalidClassException (String, Exception) 


InvalidClassException (String, String) 


Initializes a new instance of an InvalidClassException object during 
deserialization. 


Initializes a new instance of an InvalidClassException object with th 
e given message and inner exception. 


Initializes a new instance of an InvalidClassException object with th 
e given class name and message. 





InvalidClassException (String, String, Exception) 








See Also 

Reference 
InvalidClassException Class 
Concepts 

InvalidClassException Members 
java.io Package 


Initializes a new instance of an InvalidClassException object with th 
e given class name, message, and inner exception. 
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InvalidClassException Constructor (String) 


Initializes a new instance of an InvalidClassException object with the given message. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io. InvalidClassException( 
java.lang.String reason); 


Parameters 
reason 


A message describing the exceptional condition. 


See Also 

Reference 
InvalidClassException Class 
Concepts 

InvalidClassException Members 
java.io Package 
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InvalidClassException Constructor (SerializationInfo, 
StreamingContext) 


Initializes a new instance of an InvalidClassException object during deserialization. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected java.io. InvalidClassException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
InvalidClassException Class 
Concepts 

InvalidClassException Members 
java.io Package 
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InvalidClassException Constructor (String, Exception) 


Initializes a new instance of an InvalidClassException object with the given message and inner exception. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io. InvalidClassException( 
java.lang.String reason, 
System.Exception inner); 


Parameters 
reason 


A message describing the exceptional condition. 
inner 
An inner exception that led to the InvalidClassException. 


See Also 

Reference 
InvalidClassException Class 
Concepts 

InvalidClassException Members 
java.io Package 
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InvalidClassException Constructor (String, String) 


Initializes a new instance of an InvalidClassException object with the given class name and message. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io. InvalidClassException( 
java.lang.String className, 
java.lang.String reason); 


Parameters 
className 


The name of the class that cannot be serialized or deserialized. 
reason 
A message describing the exceptional condition. 


See Also 

Reference 
InvalidClassException Class 
Concepts 

InvalidClassException Members 
java.io Package 
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InvalidClassException Constructor (String, String, Exception) 


Initializes a new instance of an InvalidClassException object with the given class name, message, and inner exception. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io. InvalidClassException( 
java.lang.String className, 
java.lang.String reason, 
System.Exception inner); 


Parameters 
className 


The name of the class that cannot be serialized or deserialized. 
reason 

A message describing the exceptional condition. 
inner 

An inner exception that led to the InvalidClassException. 


See Also 

Reference 
InvalidClassException Class 
Concepts 

InvalidClassException Members 
java.io Package 


Visual J# Reference 


InvalidClassException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


Overridden. Provides the message describing the exceptional condition. 


Overridden. Retrieves the data to be serialized. 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


InvalidClassException Class 


Concepts 
java.io Package 
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InvalidClassException.getMessage Method 


Provides the message describing the exceptional condition. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getMessage(); 


Return Value 
A message describing the exceptional condition. 


See Also 

Reference 
InvalidClassException Class 
Concepts 

InvalidClassException Members 
java.io Package 
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InvalidClassException.GetObjectData Method 


Retrieves the data to be serialized. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void GetObjectData( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization process. 


See Also 

Reference 
InvalidClassException Class 
Concepts 

InvalidClassException Members 
java.io Package 
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InvalidClassException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
InvalidClassException Class 
Concepts 

java.io Package 
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InvalidObjectException Class 


The exception that is thrown when an error occurs during deserialization of an object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public class java.io.InvalidObjectException 
extends java.io.ObjectStreamException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.io.IOException 
java.io.ObjectStreamException 
java.io.InvalidObjectException 


See Also 

Concepts 

InvalidObjectException Members 
java.io Package 
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InvalidObjectException Members 


The exception that is thrown when an error occurs during deserialization of an object. 


The following tables list the members exposed by the InvalidObjectException type. 


Public Constructors 





Name 


Description 





InvalidObjectException 


Overloaded. Initializes a new instance of an InvalidObjectException object. 








Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 





Description 


(inherited from Exception ) 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 








printStackTrace 





getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 

clone (inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 








toString 


(inherited from Throwable ) 





Protected Methods 
Name 


finalize 





See Also 

Reference 
InvalidObjectException Class 
Concepts 

java.io Package 





(inherited from Object ) 
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InvalidObjectException Constructor 


Initializes a new instance of an InvalidObjectException object. 


Overload List 
Name Description 


InvalidObjectException (String) Initializes a new instance of an InvalidObjectException object with 
the given message. 





InvalidObjectException (SerializationInfo, StreamingContext)|Initializes a new instance of an InvalidObjectException object duri 
ng deserialization. 


InvalidObjectException (String, Exception) Initializes a new instance of an InvalidObjectException object with 
the given message and inner exception. 





See Also 
Reference 


InvalidObjectException Class 
Concepts 

InvalidObjectException Members 
java.io Package 
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InvalidObjectException Constructor (String) 


Initializes a new instance of an InvalidObjectException object with the given message. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io. InvalidObjectException( 
java.lang.String msg); 


Parameters 
msg 


A message describing the exceptional condition. 


See Also 

Reference 
InvalidObjectException Class 
Concepts 

InvalidObjectException Members 
java.io Package 
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InvalidObjectException Constructor (SerializationInfo, 
StreamingContext) 


Initializes a new instance of an InvalidObjectException object during deserialization. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected java.io. InvalidObjectException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
InvalidObjectException Class 
Concepts 

InvalidObjectException Members 
java.io Package 


Visual J# Reference 


InvalidObjectException Constructor (String, Exception) 


Initializes a new instance of an InvalidObjectException object with the given message and inner exception. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io. InvalidObjectException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the exceptional condition. 
inner 
An inner exception that led to the InvalidObjectException. 


See Also 

Reference 
InvalidObjectException Class 
Concepts 

InvalidObjectException Members 
java.io Package 
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InvalidObjectException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


InvalidObjectException Class 


Concepts 
java.io Package 
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InvalidObjectException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
InvalidObjectException Class 
Concepts 

java.io Package 
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IOException Class 


The exception that is thrown when a generic I/O error has occurred. This class represents the base class for most of the 
exceptions in the java.io package. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io. IOException 
extends java.lang.Exception 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.io.IOException 


See Also 

Concepts 

IOException Members 
java.io Package 
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IOException Members 


The exception that is thrown when a generic I/O error has occurred. This class represents the base class for most of the 
exceptions in the java.io package. 


The following tables list the members exposed by the IOException type. 


Public Constructors 





IOException Overloaded. Initializes a new instance of an |OException object. 


Public Properties (see also Protected Properties ) 








Name Description 

HelpLink (inherited from Exception ) 
InnerException (inherited from Exception ) 
Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Protected Properties 
Name Description 








HResult (inherited from Exception ) 








Public Methods 











Name Description 

equals (inherited from Object ) 
filllnStackTrace (inherited from Throwable ) 
GetBaseException (inherited from Exception ) 
hashCode (inherited from Object ) 
getLocalizedMessage (inherited from Throwable ) 
getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 
clone (inherited from Throwable ) 





printStackTrace Overloaded. (inherited from Throwable ) 














toString 


(inherited from Throwable ) 





Protected Methods 
Name 


finalize 





See Also 
Reference 
IOException Class 
Concepts 

java.io Package 





(inherited from Object ) 
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IOException Constructor 


Initializes a new instance of an IOException object. 


Overload List 


Name Description 
IOException () Initializes a new instance of an IOException object. 
IOException (String) Initializes a new instance of an IOException object with the given message. 


|OException (SerializationInfo, StreamingContext)|Initializes a new instance of an IOException object during deserialization. 


IOException (String, Exception) Initializes a new instance of an IOException object with the given message an 
d inner exception. 





See Also 

Reference 
IOException Class 
Concepts 

IOException Members 
java.io Package 
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lOException Constructor () 


Initializes a new instance of an IOException object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public java.io. IOException(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
IOException Class 
Concepts 

IOException Members 
java.io Package 
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IOException Constructor (String) 


Initializes a new instance of an IOException object with the given message. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io. IOException( 
java.lang.String s); 


Parameters 
Ss 


A message describing the exceptional condition. 


See Also 

Reference 
IOException Class 
Concepts 

IOException Members 
java.io Package 
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IOException Constructor (SerializationInfo, 


Initializes a new instance of an IOException object during deserialization. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected java.io. IOException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
IOException Class 
Concepts 

IOException Members 
java.io Package 


StreamingContext) 
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IOException Constructor (String, Exception) 


Initializes a new instance of an IOException object with the given message and inner exception. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io. IOException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the exceptional condition. 
inner 
An inner exception that led to the IOException. 


See Also 

Reference 
IOException Class 
Concepts 

IOException Members 
java.io Package 
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IOException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 





Name 


Description 





finalize 








(inherited from Object ) 





See Also 
Reference 
IOException Class 
Concepts 

java.io Package 
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IOException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 
IOException Class 
Concepts 

java.io Package 
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LineNumberInputStream Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.LineNumberInputStream 
extends java.io.FilterInputStream 





Inheritance Hierarchy 
java.lang.Object 
java.io.InputStream 
java.io.FilterInputStream 
java.io.LineNumberInputStream 


See Also 

Concepts 

LineNumberInputStream Members 
java.io Package 
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LineNumberInputStream Members 


The following tables list the members exposed by the LineNumberlnputStream type. 


Public Constructors 
Name 


LineNumberInputStream 


Public Fields 





Description 





Name Description 





in (inherited from FilterInputStream ) 





Public Methods 

















Name Description 
available Overridden. 
close Overridden. 
equals (inherited from Object ) 
hashCode (inherited from Object ) 





getLineNumber 




















getClass (inherited from Object ) 

mark Overridden. 

markSupported (inherited from FilterInputStream ) 
clone (inherited from InputStream ) 
read Overloaded. Overridden. 

reset Overridden. 





setLineNumber 





skip Overridden. 





toString (inherited from InputStream ) 








Protected Methods 





Name Description 





finalize (inherited from Object ) 











See Also 

Reference 
LineNumberInputStream Class 
Concepts 

java.io Package 
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LineNumber!InputStream Fields 


Public Fields 

















Name Description 

in (inherited from FilterInputStream ) 
See Also 

Reference 

LineNumberInputStream Class 

Concepts 


java.io Package 
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LineNumber!nputStream Constructor 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.LineNumberInputStream( 
java.io.InputStream in); 


Parameters 
in 


See Also 

Reference 
LineNumberInputStream Class 
Concepts 

LineNumberInputStream Members 
java.io Package 
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LineNumberInputStream Methods 


Public Methods 

















Name Description 
available Overridden. 
close Overridden. 
equals (inherited from Object ) 
hashCode (inherited from Object ) 





getLineNumber 


getClass (inherited from Object ) 

mark Overridden. 

markSupported (inherited from FilterInputStream ) 
clone (inherited from InputStream ) 
read Overloaded. Overridden. 

reset Overridden. 


setLineNumber 
skip Overridden. 


toString (inherited from InputStream ) 


Protected Methods 





Name Description 





finalize (inherited from Object ) 














See Also 

Reference 
LineNumberInputStream Class 
Concepts 

java.io Package 
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LineNumber!InputStream.available Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int available() throws java.io. IOException; 


See Also 

Reference 
LineNumberInputStream Class 
Concepts 

LineNumberInputStream Members 
java.io Package 
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LineNumberInputStream.close Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void close() throws java.io. IOException; 


See Also 

Reference 
LineNumberInputStream Class 
Concepts 

LineNumberInputStream Members 
java.io Package 
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LineNumberInputStream.getLineNumber Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int getLineNumber(); 


See Also 

Reference 
LineNumberInputStream Class 
Concepts 

LineNumberInputStream Members 
java.io Package 
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LineNumber!nputStream.mark Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void mark( 
int readlimit); 


Parameters 
readlimit 


See Also 

Reference 
LineNumberInputStream Class 
Concepts 

LineNumberInputStream Members 
java.io Package 
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LineNumberInputStream.read Method 


Overload List 





Name Description 





LineNumberInputStream.read () 





LineNumberInputStream.read (byte[]) 





LineNumberInputStream.read (bytef], int, int) 











See Also 

Reference 
LineNumberInputStream Class 
Concepts 

LineNumberInputStream Members 
java.io Package 
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LineNumberInputStream.read Method () 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read() throws java.io. IOException; 


See Also 

Reference 
LineNumberInputStream Class 
Concepts 

LineNumberInputStream Members 
java.io Package 
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LineNumberInputStream.read Method (SByte[ ], Int32, Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read( 
byte[] b, 
int off, 
int len) throws java.io. IOException; 


Parameters 


b 


off 
len 


See Also 

Reference 
LineNumberInputStream Class 
Concepts 

LineNumberInputStream Members 
java.io Package 
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LineNumberInputStream.reset Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void reset() throws java.io. IOException; 


See Also 

Reference 
LineNumberInputStream Class 
Concepts 

LineNumberInputStream Members 
java.io Package 
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LineNumber!InputStream.setLineNumber Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void setLineNumber( 
int lineNumber) ; 


Parameters 
lineNumber 


See Also 

Reference 
LineNumberInputStream Class 
Concepts 

LineNumberInputStream Members 
java.io Package 
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LineNumber!InputStream.skip Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public long skip( 
long n) throws java.io.IOException; 


Parameters 
n 


See Also 

Reference 
LineNumberInputStream Class 
Concepts 

LineNumberInputStream Members 
java.io Package 
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LineNumberReader Class 


Provides an implementation of the abstract Reader class that counts the number of lines in a stream of data. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.LineNumberReader 
extends java.io.BufferedReader 


Example 

The following example demonstrates the getLineNumber, mark, readLine, and reset methods of the LineNumberReader class. 
// linenumberreader_overview. jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
try 
{ 


// Create a new instance of a LineNumberReader object 

// that is reading from a FileReader object. 

File myFile = new File("C:\\MyFile.txt"); 

FileReader fileReader = new FileReader(myFile) ; 
LineNumberReader reader = new LineNumberReader(fileReader) ; 


// Read one line from the FileReader. 
String lineRead = ""; 

lineRead = reader.readLine(); 
System.out.println(lineRead) ; 


// Mark the position in the file. 
reader.mark((int)myFile.length()); 


// Read the rest of the file. 
while ((lineRead = reader.readLine()) != null) 


d 
} 


System.out.println(lineRead) ; 


// Print out the number of lines that were read. 


System.out.println("Total lines read: + 
reader. getLineNumber()); 


// Now reset the reader and re-read from the 
// FileReader from the marked position on. 
reader.reset(); 

while ((lineRead = reader.readLine()) != null) 


System.out.println(lineRead) ; 
} 


// Close the LineNumberReader and FileReader. 
fileReader.close(); 
reader.close(); 


catch (IOException ex) 


{ 
System.out.printin(ex.toString()); 


} 
} 
/* 
Output: 


This is my file. 

It contains three lines. 
This is the last line. 
Total lines read: 3 


It contains three lines. 
This is the last line. 


*/ 





Remarks 


This class extends from BufferedReader and encapsulates a Reader object as the source of the stream. This provides 
functionality for counting the number of lines in the stream and allows for mark and reset functionality on the number of lines 
read from the stream of character data. 


Inheritance Hierarchy 
java.lang.Object 
java.io.Reader 
java.io.BufferedReader 
java.io.LineNumberReader 


See Also 

Concepts 

LineNumberReader Members 
java.io Package 
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LineNumberReader Members 


Provides an implementation of the abstract Reader class that counts the number of lines in a stream of data. 


The following ta 


bles list the members exposed by the LineNumberReader type. 


Public Constructors 





Name 


Description 





LineNumberReader 


Overloaded. Initializes a new instance of a LineNumberReader object. 








Public Fields 
Name 





lock 


Description 


The object used to synchronize operations on the reader.(inherited from Reader) 





Name 


close 


equals 


hashCode 


getLineNumber 


Public Methods 


Description 


Closes the stream being buffered and releases internal buffer. (inherited from BufferedReader) 
(inherited from Object ) 
(inherited from Object ) 


Gets the current number of lines read from the input source. 





getClass (inherited from Object ) 

mark Overridden. Sets the mark to the current line being read from the stream. Also specifies the maximum numbe 
r of characters that can be marked. 

markSupported/Determines whether the current position of the stream can be marked. (inherited from BufferedReader) 

clone Creates a shallow copy of the object. (inherited from Reader) 

read Overloaded. Overridden. Reads the next character or characters from the input source. 

readLine Overridden. Reads an entire line from the input source. 

ready Determines whether the underlying stream is ready for reading. (inherited from BufferedReader) 

reset Overridden. Resets the reader for the input source such that the next character read is the character that is ma 


rked. 





setLineNumber 


skip 


Sets the number of lines read from the input source. 


Overridden. Skips over the next n characters in the input source or until the end of the stream, whichever is les 
S. 





toString 


Displays a human readable representation of the reader. (inherited from Reader) 











Name 


Protected Methods 


Description 








finalize (inherited from Object ) 


See Also 

Reference 
LineNumberReader Class 
Concepts 

java.io Package 
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LineNumberReader Fields 


Public Fields 





Name _ Description 





lock The object used to synchronize operations on the reader. (inherited from Reader ) 











See Also 

Reference 
LineNumberReader Class 
Concepts 

java.io Package 
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LineNumberReader Constructor 


Initializes a new instance of a LineNumberReader object. 


Overload List 
Name 


LineNumberReader (Reader) 


Description 


Initializes a new instance of a LineNumberReader object. The provided Reader object contains 
the data whose lines will be counted. 








See Also 

Reference 
LineNumberReader Class 
Concepts 

LineNumberReader Members 
java.io Package 





LineNumberReader (Reader, int)|Initializes a new instance of a LineNumberReader object. The provided Reader object contains 


the data whose lines will be counted. The internal buffer is initialized to the given size. 
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LineNumberReader Constructor (Reader) 


Initializes a new instance of a LineNumberReader object. The provided Reader object contains the data whose lines will be 
counted. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.LineNumberReader ( 
java.io.Reader in); 


Parameters 
in 


A Reader object that contains the data whose lines will be counted. 


See Also 

Reference 
LineNumberReader Class 
Concepts 

LineNumberReader Members 
java.io Package 
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LineNumberReader Constructor (Reader, Int32) 


Initializes a new instance of a LineNumberReader object. The provided Reader object contains the data whose lines will be 
counted. The internal buffer is initialized to the given size. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.LineNumberReader( 
java.io.Reader in, 
int size); 


Parameters 
in 


A Reader object that contains the data whose lines will be counted. 
size 
The size of the internal buffer. 
See Also 
Reference 
LineNumberReader Class 
Concepts 


LineNumberReader Members 
java.io Package 
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LineNumberReader Methods 


Public Methods 














Name Description 

close Closes the stream being buffered and releases internal buffer. (inherited from BufferedReader ) 
equals (inherited from Object ) 

hashCode (inherited from Object ) 





getLineNumber 


Gets the current number of lines read from the input source. 








getClass (inherited from Object ) 

mark Overridden. Sets the mark to the current line being read from the stream. Also specifies the maximum numbe 
r of characters that can be marked. 

markSupported|/Determines whether the current position of the stream can be marked. (inherited from BufferedReader ) 

clone Creates a shallow copy of the object. (inherited from Reader ) 

read Overloaded. Overridden. Reads the next character or characters from the input source. 

readLine Overridden. Reads an entire line from the input source. 

ready Determines whether the underlying stream is ready for reading. (inherited from BufferedReader ) 

reset Overridden. Resets the reader for the input source such that the next character read is the character that is ma 


rked. 





setLineNumber 


Sets the number of lines read from the input source. 





skip 


toString 








Overridden. Skips over the next n characters in the input source or until the end of the stream, whichever is les 
S. 


Displays a human readable representation of the reader. (inherited from Reader ) 


Protected Methods 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


LineNumberReader Class 


Concepts 
java.io Package 
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LineNumberReader.getLineNumber Method 


Gets the current number of lines read from the input source. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int getLineNumber(); 


Return Value 
The current number of lines read from the input source. 
Example 


The following example demonstrates how to determine the number of lines read using a LineéNumberReader object. 


// linenumberreader_getlinenumber.js1l 
import java.io.*; 


public class Program 
{ 
public static void main(String[] args) 
if 
try 
{ 
// Create a new instance of a LineNumberReader object 
// that is reading from a FileReader object. 
File myFile = new File("C:\\MyFile.txt"); 
FileReader fileReader = new FileReader(myFile) ; 
LineNumberReader reader = new LineNumberReader(fileReader) ; 


// Read from the FileReader. 
String lineRead = ""; 
while ((lineRead = reader.readLine()) != null) 


: 
} 


// Determine the number of lines that were read. 


System.out.println("Total lines read: + 
reader. getLineNumber()); 


System.out.println(lineRead) ; 


// Close the LineNumberReader and FileReader. 
fileReader.close(); 
reader.close(); 


catch (IOException ex) 
{ 


} 


System.out.println(ex.toString()); 


} 


/* 

Output: 

This is my file. 

It contains three lines. 
This is the last line. 
Total lines read: 3 


7 


See Also 

Reference 
LineNumberReader Class 
Concepts 

LineNumberReader Members 
java.io Package 


Visual J# Reference 


LineNumberReader.mark Method 


Sets the mark to the current line being read from the stream. Also specifies the maximum number of characters that can be 
marked. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void mark( 
int readlimit) throws java.io. IOException; 


Parameters 
readlimit 

The maximum number of characters that can be marked. 
Example 


The following example demonstrates the effects that calling mark and reset have on reading data using a LineNumberReader 
object. 


// linenumberreader_mark.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
try 
{ 


// Create a new instance of a LineNumberReader object 

// that is reading from a FileReader object. 

File myFile = new File("C:\\MyFile.txt"); 

FileReader fileReader = new FileReader(myFile) ; 
LineNumberReader reader = new LineNumberReader(fileReader) ; 


// Read one line from the FileReader. 
String lineRead = ""; 

lineRead = reader.readLine(); 
System.out.println(lineRead) ; 


// Mark the position in the file. 
reader.mark((int)myFile.length()); 


// Read the rest of the file. 
while ((lineRead = reader.readLine()) != null) 


1 
} 


System.out.println(lineRead) ; 


// Now reset the reader and re-read from the 
// FileReader from the marked position on. 
reader.reset(); 

while ((lineRead = reader.readLine()) != null) 


{ 
} 


System.out.println(lineRead) ; 


// Close the LineNumberReader and FileReader. 
fileReader.close(); 
reader.close(); 


catch (IOException ex) 


: 
System. out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 


This is my file. 
It contains three lines. 
This is the last line. 


It contains three lines. 
This is the last line. 
*/ 





See Also 

Reference 
LineNumberReader Class 
Concepts 

LineNumberReader Members 
java.io Package 
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LineNumberReader.read Method 


Reads the next character or characters from the input source. 


Overload List 


Name Description 
LineNumberReader.read () Reads the next character from the input source. 
LineNumberReader.read (char[]) Reads the characters in the array starting at an offset for the length specified and stor 


es them in the provided array of characters. 





LineNumberReader.read (char[], int, int)/Reads the characters from the underlying stream for the length specified, and stores t 
hem in the provided array of characters, starting at an offset. 





See Also 

Reference 
LineNumberReader Class 
Concepts 

LineNumberReader Members 
java.io Package 
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LineNumberReader.read Method () 


Reads the next character from the input source. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public int read() throws java.io. IOException; 





Return Value 


The numeric value of the character read from the stream, or -1 if the end of the stream is reached. A line feed (LF) character is 
returned if a new line is detected. 





Note: 





CR+LF is treated as a new line. 


Example 


The following example demonstrates how to read a single character at a time using a LineNumberReader object. 


// linenumberreader_read.jsl 
import java.io.*; 
public class Program 
public static void main(String[] args) 
{ 
try 
{ 
// Create a new instance of a LineNumberReader object 
// that is reading from a FileReader object. 
FileReader fileReader = new FileReader("C:\\MyFile.txt"); 
LineNumberReader reader = new LineNumberReader(fileReader) ; 
// Read from the FileReader. 
int charRead; 
while ((charRead = reader.read()) >= @) 
ij 
System.out.print((char)charRead) ; 
} 
// Close the LineNumberReader and FileReader. 
fileReader.close(); 
reader.close(); 
catch (IOException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 
} 
/* 
Output: 
This is my file. 
It contains three lines. 
This is the last line. 
ad 











See Also 

Reference 
LineNumberReader Class 
Concepts 

LineNumberReader Members 
java.io Package 
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LineNumberReader.read Method (CharT ], Int32, Int32) 


Reads the characters from the underlying stream for the length specified, and stores them in the provided array of characters, 
starting at an offset. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read( 
char[] b, 
int off, 
int len) throws java.io.IOException; 


Parameters 
b 
The array of characters to store the data read from the input source. 


off 


An offset into the array of characters. This value represents the index of the first character in the array to be written. This 
value must be greater than zero. 


len 

The number of characters to be read. This value plus the offset must be less than the overall length of the array. 
Return Value 
The number of characters read from the stream, or -1 if the end of the stream is reached and no characters are read. 
Example 


The following example demonstrates how to store the data read from a LineNumberReader object into an array. 
// linenumberreader_read_2.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
try 
{ 


// Create a new instance of a LineNumberReader object 

// that is reading from a FileReader object. 

File myFile = new File("C:\\MyFile.txt"); 

FileReader fileReader = new FileReader(myFile) ; 
LineNumberReader reader = new LineNumberReader(fileReader) ; 


// Read from the FileReader. 

char[] arr = new char[(int)myFile.length()]; 
reader.read(arr, @, (int)myFile.length()); 
System.out.println(arr) ; 


// Close the LineNumberReader and FileReader. 
fileReader.close(); 


reader.close(); 


catch (IOException ex) 
{ 


} 


System.out.println(ex.toString()); 


} 


/* 

Output: 

This is my file. 

It contains three lines. 
This is the last line. 
*/ 





See Also 

Reference 
LineNumberReader Class 
Concepts 

LineNumberReader Members 
java.io Package 
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LineNumberReader.readLine Method 


Reads an entire line from the input source. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String readLine() throws java.io. IOException; 


Return Value 


A string representing the contents of the line read from the underlying stream. The string contains all the text in the stream up 
to the next carriage return (CR), line feed (LF), carriage return plus line feed (CR+LF), or the end of the stream. If there are no 


characters other than CR or LF in the stream, then null is returned. 


Example 


The following example demonstrates how to read a line of data using a LineNumberReader object. 


// linenumberreader_readline.jsl 


import java.io.*; 


public class Program 


public static void main(String[] args) 


if 
{ 
} 
} 
/* 
Output: 


try 
{ 


} 


// Create a new instance of a LineNumberReader object 

// that is reading from a FileReader object. 

File myFile = new File("C:\\MyFile.txt"); 

FileReader fileReader = new FileReader(myFile) ; 
LineNumberReader reader = new LineNumberReader(fileReader) ; 


// Read from the FileReader. 
String lineRead = ""; 
while ((lineRead = reader.readLine()) != null) 


{ 
} 


// Close the LineNumberReader and FileReader. 
fileReader.close(); 
reader.close(); 


System.out.println(lineRead) ; 


catch (IOException ex) 


1 
} 


System.out.printin(ex.toString()); 


This is my file. 
It contains three lines. 
This is the last line. 


oy 


See Also 
Reference 


LineNumberReader Class 


Concepts 
LineNumberReader Members 
java.io Package 
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LineNumberReader.reset Method 


Resets the reader for the input source such that the next character read is the character that is marked. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void reset() throws java.io. IOException; 


Example 


The following example demonstrates the effects that calling mark and reset have on reading data using a LineNumberReader 
object. 


// linenumberreader_reset.jsl 
import java.io.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
try 
{ 
// Create a new instance of a LineNumberReader object 
// that is reading from a FileReader object. 
File myFile = new File("C:\\MyFile.txt"); 
FileReader fileReader = new FileReader(myFile) ; 
LineNumberReader reader = new LineNumberReader(fileReader) ; 


// Read one line from the FileReader. 
String lineRead = ""; 

lineRead = reader.readLine(); 
System.out.println(lineRead) ; 


// Mark the position in the file. 
reader.mark((int)myFile.length()); 


// Read the rest of the file. 
while ((lineRead = reader.readLine()) != null) 


{ 
} 


System.out.println(lineRead) ; 


// Now reset the reader and re-read from the 
// FileReader from the marked position on. 
reader.reset(); 

while ((lineRead = reader.readLine()) != null) 


i 


System.out.println(lineRead) ; 


// Close the LineNumberReader and FileReader. 
fileReader.close(); 
reader.close(); 


} 
catch (IOException ex) 


{ 
} 


System.out.println(ex.toString()); 


/* 

Output: 

This is my file. 

It contains three lines. 
This is the last line. 


It contains three lines. 
This is the last line. 


a7 











See Also 

Reference 
LineNumberReader Class 
Concepts 

LineNumberReader Members 
java.io Package 
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LineNumberReader.setLineNumber Method 


Sets the number of lines read from the input source. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void 


setLineNumber ( 


int lineNumber) ; 


Parameters 
lineNumber 


A value representing the number of lines read from the input source. 


Example 


The following example demonstrates how to set the number of lines read using a LineNumberReader object. 


// linenumberreader_setlinenumber. js1l 


import java. 


io.*; 


public class Program 


public static void main(String[] args) 


// Create a new instance of a LineNumberReader object 


// that is reading from a FileReader object. 
File myFile = new File("C:\\MyFile.txt"); 
FileReader fileReader = new FileReader(myFile) ; 


LineNumberReader reader = new LineNumberReader(fileReader) ; 


// Read from the FileReader. 
String lineRead = ""; 
while ((lineRead = reader.readLine()) != null) 


{ 
} 


System.out.println(lineRead) ; 


// Determine the number of lines that were read. 


System.out.println("Total lines read: + 
reader. getLineNumber()); 


// Reset the number of lines read. 
reader.setLineNumber (@) ; 


System.out.println("Total lines read after reset: 


reader. getLineNumber()); 


// Close the LineNumberReader and FileReader. 
fileReader.close(); 
reader.close(); 


catch (IOException ex) 


{ 
try 
{ 
{ 
} 
} 
} 
/* 


Output: 


System.out.println(ex.toString()); 


This is my file. 

It contains three lines. 
This is the last line. 

Total lines read: 3 

Total lines read after reset: 
*] 





See Also 

Reference 
LineNumberReader Class 
Concepts 

LineNumberReader Members 
java.io Package 
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LineNumberReader.skip Method 


Skips over the next n characters in the input source or until the end of the stream, whichever is less. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public long skip( 
long n) throws java.io.IOException; 


Parameters 
n 


The number of characters to skip over. This value is treated as zero if it is negative. If this number is greater than the number 
of characters remaining in the stream, then only the number of remaining characters will be skipped. 


Return Value 
The number of characters skipped. 
Example 


The following example shows how to skip over data being read and the effect it has on the count of the number of lines read. 
// linenumberreader_skip.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
try 
{ 


// Create a new instance of a LineNumberReader object 

// that is reading from a FileReader object. 

File myFile = new File("C:\\MyFile.txt"); 

FileReader fileReader = new FileReader(myFile) ; 
LineNumberReader reader = new LineNumberReader(fileReader) ; 


// Read from the FileReader. 

int charRead; 

int skipCount = Q; 

while ((charRead = reader.read()) >= @) 


1 
System.out.print((char)charRead) ; 
// Skip over some characters. 
reader.skip(++skipCount) ; 

} 


// Determine the number of lines that were read. 


System.out.println("\nTotal lines read: + 
reader. getLineNumber()); 


// Close the LineNumberReader and FileReader. 
fileReader.close(); 
reader.close(); 


} 
catch (IOException ex) 
{ 
System.out.printin(ex.toString()); 
} 


} 


/* 

Output: 

Tiiyecslil 

Total lines read: 2 
al 











See Also 

Reference 
LineNumberReader Class 
Concepts 

LineNumberReader Members 
java.io Package 


Visual J# Reference 


NotActiveException Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.NotActiveException 
extends java.io.ObjectStreamException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.io.IOException 
java.io.ObjectStreamException 
java.io.NotActiveException 


See Also 

Concepts 

NotActiveException Members 
java.io Package 


Visual J# Reference 


NotActiveException Members 


The following tables list the members exposed by the NotActiveException type. 


Public Constructors 
Name 


NotActiveException 





Public Properties (see also Protected Properties ) 











Name Description 

HelpLink (inherited from Exception ) 
InnerException (inherited from Exception ) 
Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 


Protected Properties 





Name Description 





HResult (inherited from Exception ) 








Public Methods 











Name Description 

equals (inherited from Object ) 
filllnStackTrace (inherited from Throwable ) 
GetBaseException (inherited from Exception ) 
hashCode (inherited from Object ) 
getLocalizedMessage (inherited from Throwable ) 
getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 
clone (inherited from Throwable ) 
printStackTrace Overloaded. (inherited from Throwable ) 





toString (inherited from Throwable ) 











Protected Methods 





See Also 

Reference 
NotActiveException Class 
Concepts 

java.io Package 


Visual J# Reference 


NotActiveException Constructor 


Overload List 





Name Description 





NotActiveException () 





NotActiveException (String) 





NotActiveException (SerializationInfo, StreamingContext) 





NotActiveException (String, Exception) 














See Also 

Reference 
NotActiveException Class 
Concepts 

NotActiveException Members 
java.io Package 


Visual J# Reference 


NotActiveException Constructor () 


Initializes a new instance of the NotActiveException Class . 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.NotActiveException() ; 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
NotActiveException Class 
Concepts 

NotActiveException Members 
java.io Package 


Visual J# Reference 


NotActiveException Constructor (String) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.NotActiveException( 
java.lang.String msg); 


Parameters 
msg 


See Also 

Reference 
NotActiveException Class 
Concepts 

NotActiveException Members 
java.io Package 


Visual J# Reference 


NotActiveException Constructor (SerializationInfo, 
StreamingContext) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected java.io.NotActiveException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


context 


See Also 

Reference 
NotActiveException Class 
Concepts 

NotActiveException Members 
java.io Package 


Visual J# Reference 


NotActiveException Constructor (String, Exception) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.NotActiveException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
S 


inner 


See Also 

Reference 
NotActiveException Class 
Concepts 

NotActiveException Members 
java.io Package 


Visual J# Reference 


NotActiveException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


NotActiveException Class 


Concepts 
java.io Package 








Visual J# Reference 


NotActiveException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
NotActiveException Class 
Concepts 

java.io Package 








Visual J# Reference 


NotSerializableException Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.NotSerializableException 
extends java.io.ObjectStreamException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.io.IOException 
java.io.ObjectStreamException 
java.io.NotSerializableException 


See Also 

Concepts 

NotSerializableException Members 
java.io Package 


Visual J# Reference 


NotSerializableException Members 


The following tables list the members exposed by the NotSerializableException type. 


Public Constructors 
Name 


NotSerializableException 


Description 





Public Properties (see also Protected Properties ) 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 
Message 
Source 
StackTrace 


TargetSite 


Protected Properties 


(inherited from Exception ) 


(inherited from Exception ) 


(inherited from Exception ) 


(inherited from Exception ) 


(inherited from Exception ) 





Name 


Description 





HResult 





(inherited from Exception ) 





Public Methods 
Name 


equals 


filllnStackTrace 


GetBaseException 


hashCode 


getLocalizedMessage 


Description 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Exception ) 


(inherited from Object ) 


(inherited from Throwable ) 








getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 

clone (inherited from Throwable ) 





printStackTrace 


Overloaded. (inherited from Throwable ) 





toString 





(inherited from Throwable ) 








Protected Methods 





See Also 

Reference 
NotSerializableException Class 
Concepts 

java.io Package 


Visual J# Reference 


NotSerializableException Constructor 


Overload List 





Name 


Description 





NotSerializableException () 





NotSerializableException (String) 





NotSerializableException (SerializationInfo, StreamingContext) 





NotSerializableException (String, Exception) 








See Also 

Reference 
NotSerializableException Class 
Concepts 

NotSerializableException Members 
java.io Package 





Visual J# Reference 


NotSerializableException Constructor () 


Initializes a new instance of the NotSerializableException Class . 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.NotSerializableException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
NotSerializableException Class 
Concepts 

NotSerializableException Members 
java.io Package 


Visual J# Reference 


NotSerializableException Constructor (String) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.NotSerializableException( 
java.lang.String msg); 


Parameters 
msg 


See Also 

Reference 
NotSerializableException Class 
Concepts 

NotSerializableException Members 
java.io Package 


Visual J# Reference 


NotSerializableException Constructor (SerializationInfo, 
StreamingContext) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected java.io.NotSerializableException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


context 


See Also 

Reference 
NotSerializableException Class 
Concepts 

NotSerializableException Members 
java.io Package 


Visual J# Reference 


NotSerializableException Constructor (String, Exception) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.NotSerializableException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
S 


inner 


See Also 

Reference 
NotSerializableException Class 
Concepts 

NotSerializableException Members 
java.io Package 


Visual J# Reference 


NotSerializableException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


NotSerializableException Class 


Concepts 
java.io Package 








Visual J# Reference 


NotSerializableException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 


NotSerializableException Class 


Concepts 
java.io Package 








Visual J# Reference 


Objectinput Interface 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public interface java.io.ObjectInput 
extends java.io.DataInput 





See Also 

Concepts 

ObjectInput Members 
java.io Package 


Visual J# Reference 


Objectinput Members 


The following tables list the members exposed by the Objectinput type. 


Public Methods 


Name Description 


available 
close 
read Overloaded. 


readObject 





skip 














See Also 

Reference 
Objectinput Interface 
Concepts 

java.io Package 


Visual J# Reference 


Objectinput Methods 


Public Methods 





Name Description 





available 





close 





read Overloaded. 





readObject 





skip 








See Also 

Reference 
Objectinput Interface 
Concepts 

java.io Package 





Visual J# Reference 


Objectinput.available Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract int available() throws java.io. IOException; 


See Also 

Reference 
Objectinput Interface 
Concepts 

ObjectInput Members 
java.io Package 


Visual J# Reference 


Objectinput.close Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract void close() throws java.io. IOException; 


See Also 

Reference 
Objectinput Interface 
Concepts 

ObjectInput Members 
java.io Package 


Visual J# Reference 


Objectinput.read Method 


Overload List 





Name Description 





ObjectInput.read () 





Objectinput.read (byte[]) 





ObjectInput.read (bytef], int, int) 











See Also 

Reference 
ObjectInput Interface 
Concepts 

ObjectInput Members 
java.io Package 


Visual J# Reference 


Objectinput.read Method () 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract int read() throws java.io. IOException; 


See Also 

Reference 
Objectinput Interface 
Concepts 

ObjectInput Members 
java.io Package 


Visual J# Reference 


Objectinput.read Method (SByte[ ]) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract int read( 
byte[] buf) throws java.io. IOException; 


Parameters 


buf 


See Also 

Reference 
ObjectInput Interface 
Concepts 

ObjectInput Members 
java.io Package 


Visual J# Reference 


Objectinput.read Method (SByte[ ], Int32, Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract int read( 
byte[] buf, 
int off, 
int count) throws java.io. IOException; 


Parameters 


buf 


off 
count 


See Also 

Reference 
ObjectInput Interface 
Concepts 

ObjectInput Members 
java.io Package 


Visual J# Reference 


Objectinput.readObject Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.Object readObject() throws java.lang.ClassNotFoundException, java 
-io0. IOException; 


See Also 

Reference 
ObjectInput Interface 
Concepts 

ObjectInput Members 
java.io Package 


Visual J# Reference 


Objectinput.skip Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract long skip( 
long count) throws java.io.IOException; 





Parameters 
count 


See Also 

Reference 
ObjectInput Interface 
Concepts 

ObjectInput Members 
java.io Package 


Visual J# Reference 


ObjectinputStream Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public class java.io.ObjectInputStream 
extends java.io.InputStream 
implements java.io.ObjectInput, java.io.ObjectStreamConstants 





Inheritance Hierarchy 

java.lang.Object 
java.io.InputStream 
java.io.ObjectInputStream 


See Also 

Concepts 

ObjectInputStream Members 
java.io Package 


Visual J# Reference 


ObjectinputStream Members 


The following tables list the members exposed by the ObjectinputStream type. 


Public Constructors 
Name 


ObjectInputStream 


Public Methods 








Name 


Description 








enableResolveObject 


equals 


hashCode 


getClass 


mark 


markSupported 


clone 


read 


readBoolean 


readByte 


readChar 


readDouble 


readFloat 


readFully 


available Overridden. 
close Overridden. 
defaultReadObject 


(inherited from Object ) 


(inherited from Object ) 


(inherited from Object ) 


(inherited from InputStream ) 


(inherited from InputStream ) 


(inherited from InputStream ) 


Overloaded. Overridden. 


Overloaded. 





readint 





readLine 





readLong 





readObject 














readShort 





readStreamHeader 





readUnsignedByte 





readUnsignedShort 





readUTF 





registerValidation 





reset 


(inherited from InputStream ) 





resolveClass 


resolveObject 


skip 


skipBytes 


toString 





Protected Methods 


(inherited from InputStream ) 


(inherited from InputStream ) 





Name 


Description 





finalize 








(inherited from Object ) 





See Also 

Reference 
ObjectinputStream Class 
Concepts 

java.io Package 








Visual J# Reference 


ObjectIiInputStream Constructor 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.ObjectInputStream( 
java.io.InputStream in) throws java.io. IOException, java.io.StreamCorruptedException; 


Parameters 
in 


See Also 

Reference 
ObjectInputStream Class 
Concepts 

ObjectInputStream Members 
java.io Package 


Visual J# Reference 


ObjectinputStream Methods 


Public Methods 














Name Description 
available Overridden. 
close Overridden. 
defaultReadObject 





enableResolveObject 





equals (inherited from Object ) 
hashCode (inherited from Object ) 
getClass (inherited from Object ) 

mark (inherited from InputStream ) 
markSupported (inherited from InputStream ) 
clone (inherited from InputStream ) 
read Overloaded. Overridden. 


readBoolean 

readByte 

readChar 

readDouble 

readFloat 

readFully Overloaded. 
readint 

readLine 


readLong 





readObject 





readShort 





readStreamHeader 





readUnsignedByte 














readUnsignedShort 





readUTF 





registerValidation 





reset 


(inherited from InputStream ) 





resolveClass 





resolveObject 











Protected Methods 


skip (inherited from InputStream ) 
skipBytes 
toString (inherited from InputStream ) 








Name 


Description 





finalize 








(inherited from Object ) 





See Also 

Reference 
ObjectInputStream Class 
Concepts 

java.io Package 








Visual J# Reference 


ObjectinputStream.available Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int available() throws java.io. IOException; 


See Also 

Reference 
ObjectInputStream Class 
Concepts 

ObjectInputStream Members 
java.io Package 


Visual J# Reference 


ObjectinputStream.close Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void close() throws java.io. IOException; 


See Also 

Reference 
ObjectInputStream Class 
Concepts 

ObjectInputStream Members 
java.io Package 


Visual J# Reference 


ObjectinputStream.defaultReadObject Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final void defaultReadObject() throws java.io.IOException, java.lang.ClassNotFoundEx 
ception, java.io.NotActiveException; 


See Also 

Reference 
ObjectinputStream Class 
Concepts 

ObjectInputStream Members 
java.io Package 


Visual J# Reference 


ObjectiInputStream.enableResolveObject Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected final boolean enableResolveObject( 
boolean enable) throws java.lang.SecurityException; 


Parameters 
enable 


See Also 

Reference 
ObjectInputStream Class 
Concepts 

ObjectInputStream Members 
java.io Package 


Visual J# Reference 


ObjectiInputStream.read Method 


Overload List 





Name 


Description 





ObjectInputStream.read () 





ObjectInputStream.read (byte[]) 





ObjectInputStream.read (byte[], int, int) 











See Also 

Reference 
ObjectIinputStream Class 
Concepts 

ObjectInputStream Members 
java.io Package 





Visual J# Reference 


ObjectinputStream.read Method () 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read() throws java.io. IOException; 


See Also 

Reference 
ObjectInputStream Class 
Concepts 

ObjectInputStream Members 
java.io Package 


Visual J# Reference 


ObjectInputStream.read Method (SByte[]) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read( 
byte[] buffer) throws java.io. IOException; 


Parameters 


buffer 


See Also 

Reference 
ObjectInputStream Class 
Concepts 

ObjectInputStream Members 
java.io Package 


Visual J# Reference 


ObjectinputStream.read Method (SByte[], Int32, Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read( 
byte[] buffer, 
int offset, 
int count) throws java.io. IOException; 


Parameters 


buffer 
offset 
count 


See Also 

Reference 
ObjectInputStream Class 
Concepts 

ObjectInputStream Members 
java.io Package 


Visual J# Reference 


ObjectinputStream.readBoolean Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean readBoolean() throws java.io. IOException; 


See Also 

Reference 
ObjectInputStream Class 
Concepts 

ObjectInputStream Members 
java.io Package 


Visual J# Reference 


ObjectinputStream.readByte Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public byte readByte() throws java.io. IOException; 


See Also 

Reference 
ObjectInputStream Class 
Concepts 

ObjectInputStream Members 
java.io Package 


Visual J# Reference 


ObjectinputStream.readChar Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public char readChar() throws java.io. IOException; 


See Also 

Reference 
ObjectInputStream Class 
Concepts 

ObjectInputStream Members 
java.io Package 


Visual J# Reference 


ObjectinputStream.readDouble Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public double readDouble() throws java.io. IOException; 


See Also 

Reference 
ObjectInputStream Class 
Concepts 

ObjectInputStream Members 
java.io Package 


Visual J# Reference 


ObjectinputStream.readFloat Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public float readFloat() throws java.io. IOException; 


See Also 

Reference 
ObjectInputStream Class 
Concepts 

ObjectInputStream Members 
java.io Package 


Visual J# Reference 


ObjectinputStream.readFully Method 


Overload List 





Name 


Description 





ObjectInputStream.readFully (byte[]) 





ObjectInputStream.readFully (byte[], int, int) 











See Also 

Reference 
ObjectInputStream Class 
Concepts 

ObjectInputStream Members 
java.io Package 





Visual J# Reference 


ObjectInputStream.readFully Method ((SByte[ ]) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void readFully( 
byte[] buffer) throws java.io. IOException; 


Parameters 


buffer 


See Also 

Reference 
ObjectInputStream Class 
Concepts 

ObjectInputStream Members 
java.io Package 


Visual J# Reference 


ObjectinputStream.readFully Method (SByte[ J, Int32, Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void readFully( 
byte[] buffer, 
int offset, 
int len) throws java.io. IOException; 


Parameters 


buffer 
offset 
len 


See Also 

Reference 
ObjectInputStream Class 
Concepts 

ObjectInputStream Members 
java.io Package 


Visual J# Reference 


ObjectinputStream.readint Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int readInt() throws java.io. IOException; 


See Also 

Reference 
ObjectInputStream Class 
Concepts 

ObjectInputStream Members 
java.io Package 


Visual J# Reference 


ObjectinputStream.readLine Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String readLine() throws java.io. IOException; 


See Also 

Reference 
ObjectInputStream Class 
Concepts 

ObjectInputStream Members 
java.io Package 


Visual J# Reference 


ObjectinputStream.readLong Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public long readLong() throws java.io. IOException; 


See Also 

Reference 
ObjectInputStream Class 
Concepts 

ObjectInputStream Members 
java.io Package 


Visual J# Reference 


ObjectinputStream.readObject Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final java.lang.Object readObject() throws java.io.OptionalDataException, java.lang. 
ClassNotFoundException, java.io. IOException; 


See Also 

Reference 
ObjectinputStream Class 
Concepts 

ObjectInputStream Members 
java.io Package 


Visual J# Reference 


ObjectInputStream.readShort Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public short readShort() throws java.io. IOException; 


See Also 

Reference 
ObjectInputStream Class 
Concepts 

ObjectInputStream Members 
java.io Package 


Visual J# Reference 


ObjectiInputStream.readStreamHeader Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected void readStreamHeader() throws java.io.IOException, java.io.StreamCorruptedExcept 
ion; 


See Also 

Reference 
ObjectinputStream Class 
Concepts 

ObjectInputStream Members 
java.io Package 


Visual J# Reference 


ObjectinputStream.readUnsignedByte Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int readUnsignedByte() throws java.io. IOException; 


See Also 

Reference 
ObjectInputStream Class 
Concepts 

ObjectInputStream Members 
java.io Package 


Visual J# Reference 


ObjectinputStream.readUnsignedShort Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int readUnsignedShort() throws java.io. IOException; 


See Also 

Reference 
ObjectInputStream Class 
Concepts 

ObjectInputStream Members 
java.io Package 


Visual J# Reference 


ObjectinputStream.readUTF Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String readUTF() throws java.io. IOException; 


See Also 

Reference 
ObjectInputStream Class 
Concepts 

ObjectInputStream Members 
java.io Package 


Visual J# Reference 


ObjectinputStream.registerValidation Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized void registerValidation( 
java.io.ObjectInputValidation obj, 
int prio) throws java.io.NotActiveException, java.io.InvalidObjectException; 


Parameters 


obj 
prio 


See Also 

Reference 
ObjectInputStream Class 
Concepts 

ObjectInputStream Members 
java.io Package 


Visual J# Reference 


ObjectinputStream.resolveClass Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected java.lang.Class resolveClass( 
java.io.ObjectStreamClass desc) throws java.io.IOException, java.lang.ClassNotFoundExce 
ption; 


Parameters 
desc 


See Also 

Reference 
ObjectInputStream Class 
Concepts 

ObjectInputStream Members 
java.io Package 


Visual J# Reference 


ObjectinputStream.resolveObject Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected java.lang.Object resolveObject( 
java.lang.Object obj) throws java.io. IOException; 


Parameters 


obj 


See Also 

Reference 
ObjectInputStream Class 
Concepts 

ObjectInputStream Members 
java.io Package 


Visual J# Reference 


ObjectinputStream.skipBytes Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int skipBytes( 
int count) throws java.io. IOException; 


Parameters 
count 


See Also 

Reference 
ObjectInputStream Class 
Concepts 

ObjectInputStream Members 
java.io Package 


Visual J# Reference 


ObjectInputValidation Interface 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public interface java.io.ObjectInputValidation 


See Also 

Concepts 

ObjectInputValidation Members 
java.io Package 


Visual J# Reference 


ObjectinputValidation Members 


The following tables list the members exposed by the ObjectinputValidation type. 


Public Methods 





Name Description 
See Also 

Reference 

ObjectInputValidation Interface 

Concepts 


java.io Package 


Visual J# Reference 


ObjectinputValidation Methods 


Public Methods 





Name Description 





validateObject 











See Also 

Reference 
ObjectInputValidation Interface 
Concepts 

java.io Package 


Visual J# Reference 


ObjectinputValidation.validateObject Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract void validateObject() throws java.io. InvalidObjectException; 


See Also 

Reference 
ObjectInputValidation Interface 
Concepts 

ObjectInputValidation Members 
java.io Package 


Visual J# Reference 


ObjectOutput Interface 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public interface java.io.ObjectOutput 
extends java.io.DataOutput 





See Also 

Concepts 

ObjectOutput Members 
java.io Package 


Visual J# Reference 


ObjectOutput Members 


The following tables list the members exposed by the ObjectOutput type. 


Public Methods 
Name Description 


close 
flush 
write Overloaded. 


writeObject 











See Also 

Reference 
ObjectOutput Interface 
Concepts 

java.io Package 


Visual J# Reference 


ObjectOutput Methods 


Public Methods 





Name Description 





close 





flush 





write Overloaded. 





writeObject 











See Also 

Reference 
ObjectOutput Interface 
Concepts 

java.io Package 


Visual J# Reference 


ObjectOutput.close Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract void close() throws java.io. IOException; 


See Also 

Reference 
ObjectOutput Interface 
Concepts 

ObjectOutput Members 
java.io Package 


Visual J# Reference 


ObjectOutput.flush Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract void flush() throws java.io. IOException; 


See Also 

Reference 
ObjectOutput Interface 
Concepts 

ObjectOutput Members 
java.io Package 


Visual J# Reference 


ObjectOutput.write Method 


Overload List 





Name 


Description 





ObjectOutput.write (int) 





ObjectOutput.write (byte[]) 





ObjectOutput.write (bytel], int, int) 











See Also 

Reference 
ObjectOutput Interface 
Concepts 

ObjectOutput Members 
java.io Package 





Visual J# Reference 


ObjectOutput.write Method (Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract void write( 
int oneByte) throws java.io.IOException; 


Parameters 
oneByte 


See Also 

Reference 
ObjectOutput Interface 
Concepts 

ObjectOutput Members 
java.io Package 


Visual J# Reference 


ObjectOutput.write Method (SByte[ ]) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract void write( 
byte[] buffer) throws java.io. IOException; 


Parameters 


buffer 


See Also 

Reference 
ObjectOutput Interface 
Concepts 

ObjectOutput Members 
java.io Package 


Visual J# Reference 


ObjectOutput.write Method (SByte[ J, Int32, Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract void write( 
byte[] buffer, 
int offset, 
int count) throws java.io. IOException; 


Parameters 


buffer 
offset 
count 


See Also 

Reference 
ObjectOutput Interface 
Concepts 

ObjectOutput Members 
java.io Package 


Visual J# Reference 


ObjectOutput.writeObject Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract void writeObject( 
java.lang.Object obj) throws java.io. IOException; 


Parameters 


obj 


See Also 

Reference 
ObjectOutput Interface 
Concepts 

ObjectOutput Members 
java.io Package 


Visual J# Reference 


ObjectOutputStream Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public class java.io.ObjectOutputStream 
extends java.io.OutputStream 
implements java.io.ObjectOutput, java.io.ObjectStreamConstants 





Inheritance Hierarchy 

java.lang.Object 
java.io.OutputStream 
java.io.ObjectOutputStream 


See Also 

Concepts 

ObjectOutputStream Members 
java.io Package 


Visual J# Reference 


ObjectOutputStream Members 


The following tables list the members exposed by the ObjectOutputStream type. 


Public Constructors 
Name 


ObjectOutputStream 





Public Methods 





Name Description 





annotateClass 





close Overridden. 


defaultWriteObject 


drain 


enableReplaceObject 


equals (inherited from Object ) 

flush Overridden. 

hashCode (inherited from Object ) 
getClass (inherited from Object ) 

clone (inherited from OutputStream ) 
replaceObject 

reset 

toString (inherited from OutputStream ) 
write Overloaded. Overridden. 


writeBoolean 


writeByte 


writeBytes 





writeChar 





writeChars 





writeDouble 





writeFloat 

















writelnt 





writeLong 





writeObject 





writeShort 





writeStreamHeader 





writeUTF 














Protected Methods 
Name Description 





finalize (inherited from Object ) 














See Also 

Reference 
ObjectOutputStream Class 
Concepts 

java.io Package 


Visual J# Reference 


ObjectOutputStream Constructor 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.ObjectOutputStream( 
java.io.OutputStream out) throws java.io. IOException; 


Parameters 
out 


See Also 

Reference 
ObjectOutputStream Class 
Concepts 

ObjectOutputStream Members 
java.io Package 


Visual J# Reference 


ObjectOutputStream Methods 


Public Methods 





Name 


Description 





annotateClass 





close 


Overridden. 





defaultWriteObject 





drain 





equals 


flush 


hashCode 


getClass 


clone 


replaceObject 


reset 


toString 


write 


writeBoolean 


writeByte 


writeBytes 


writeChar 


writeChars 


writeDouble 


enableReplaceObject 


(inherited from Object ) 


Overridden. 


(inherited from Object ) 


(inherited from Object ) 


(inherited from OutputStream ) 


(inherited from OutputStream ) 


Overloaded. Overridden. 





writeFloat 





writelnt 





writeLong 





writeObject 

















writeShort 





writeStreamHeader 





writeUTF 








Protected Methods 
Name 


finalize (inherited from Object ) 








See Also 

Reference 
ObjectOutputStream Class 
Concepts 

java.io Package 





Visual J# Reference 


ObjectOutputStream.annotateClass Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected void annotateClass( 
java.lang.Class cl) throws java.io. IOException; 


Parameters 
cl 


See Also 

Reference 
ObjectOutputStream Class 
Concepts 

ObjectOutputStream Members 
java.io Package 


Visual J# Reference 


ObjectOutputStream.close Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void close() throws java.io. IOException; 


See Also 

Reference 
ObjectOutputStream Class 
Concepts 

ObjectOutputStream Members 
java.io Package 


Visual J# Reference 


ObjectOutputStream.defaultWriteObject Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final void defaultwriteObject() throws java.io. IOException; 


See Also 

Reference 
ObjectOutputStream Class 
Concepts 

ObjectOutputStream Members 
java.io Package 


Visual J# Reference 


ObjectOutputStream.drain Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected void drain() throws java.io. IOException; 


See Also 

Reference 
ObjectOutputStream Class 
Concepts 

ObjectOutputStream Members 
java.io Package 


Visual J# Reference 


ObjectOutputStream.enableReplaceObject Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected final boolean enableReplaceObject( 
boolean enable) throws java.lang.SecurityException; 


Parameters 
enable 


See Also 

Reference 
ObjectOutputStream Class 
Concepts 

ObjectOutputStream Members 
java.io Package 


Visual J# Reference 


ObjectOutputStream.flush Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void flush() throws java.io. IOException; 


See Also 

Reference 
ObjectOutputStream Class 
Concepts 

ObjectOutputStream Members 
java.io Package 


Visual J# Reference 


ObjectOutputStream.replaceObject Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected java.lang.Object replaceObject( 
java.lang.Object obj) throws java.io. IOException; 


Parameters 


obj 


See Also 

Reference 
ObjectOutputStream Class 
Concepts 

ObjectOutputStream Members 
java.io Package 


Visual J# Reference 


ObjectOutputStream.reset Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void reset() throws java.io. IOException; 


See Also 

Reference 
ObjectOutputStream Class 
Concepts 

ObjectOutputStream Members 
java.io Package 


Visual J# Reference 


ObjectOutputStream.write Method 


Overload List 





Name 


Description 





ObjectOutputStream.write (int) 





ObjectOutputStream.write (byte[]) 





ObjectOutputStream.write (byte[], int, int) 











See Also 

Reference 
ObjectOutputStream Class 
Concepts 

ObjectOutputStream Members 
java.io Package 





Visual J# Reference 


ObjectOutputStream.write Method (Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
int oneByte) throws java.io.IOException; 


Parameters 
oneByte 


See Also 

Reference 
ObjectOutputStream Class 
Concepts 

ObjectOutputStream Members 
java.io Package 


Visual J# Reference 


ObjectOutputStream.write Method (SByte[ ]) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
byte[] buffer) throws java.io. IOException; 


Parameters 


buffer 


See Also 

Reference 
ObjectOutputStream Class 
Concepts 

ObjectOutputStream Members 
java.io Package 


Visual J# Reference 


ObjectOutputStream.write Method (SByte[ J, Int32, Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
byte[] buffer, 
int offset, 
int count) throws java.io. IOException; 


Parameters 


buffer 
offset 
count 


See Also 

Reference 
ObjectOutputStream Class 
Concepts 

ObjectOutputStream Members 
java.io Package 


Visual J# Reference 


ObjectOutputStream.writeBoolean Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void writeBoolean( 
boolean val) throws java.io. IOException; 


Parameters 
val 


See Also 

Reference 
ObjectOutputStream Class 
Concepts 

ObjectOutputStream Members 
java.io Package 


Visual J# Reference 


ObjectOutputStream.writeByte Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void writeByte( 
int val) throws java.io. IOException; 


Parameters 
val 


See Also 

Reference 
ObjectOutputStream Class 
Concepts 

ObjectOutputStream Members 
java.io Package 


Visual J# Reference 


ObjectOutputStream.writeBytes Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void writeBytes( 
java.lang.String str) throws java.io. IOException; 


Parameters 
str 


See Also 

Reference 
ObjectOutputStream Class 
Concepts 

ObjectOutputStream Members 
java.io Package 


Visual J# Reference 


ObjectOutputStream.writeChar Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void writeChar( 
int val) throws java.io. IOException; 


Parameters 
val 


See Also 

Reference 
ObjectOutputStream Class 
Concepts 

ObjectOutputStream Members 
java.io Package 


Visual J# Reference 


ObjectOutputStream.writeChars Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void writeChars( 
java.lang.String str) throws java.io. IOException; 


Parameters 
str 


See Also 

Reference 
ObjectOutputStream Class 
Concepts 

ObjectOutputStream Members 
java.io Package 


Visual J# Reference 


ObjectOutputStream.writeDouble Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void writeDouble( 
double val) throws java.io. IOException; 


Parameters 
val 


See Also 

Reference 
ObjectOutputStream Class 
Concepts 

ObjectOutputStream Members 
java.io Package 


Visual J# Reference 


ObjectOutputStream.writeFloat Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void writeFloat( 
float val) throws java.io. IOException; 


Parameters 
val 


See Also 

Reference 
ObjectOutputStream Class 
Concepts 

ObjectOutputStream Members 
java.io Package 


Visual J# Reference 


ObjectOutputStream.writelnt Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void writeInt( 
int val) throws java.io.IOException; 


Parameters 
val 


See Also 

Reference 
ObjectOutputStream Class 
Concepts 

ObjectOutputStream Members 
java.io Package 


Visual J# Reference 


ObjectOutputStream.writeLong Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void writeLong( 
long val) throws java.io.IOException; 


Parameters 
val 


See Also 

Reference 
ObjectOutputStream Class 
Concepts 

ObjectOutputStream Members 
java.io Package 


Visual J# Reference 


ObjectOutputStream.writeObject Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final void writeObject( 
java.lang.Object obj) throws java.io. IOException; 


Parameters 


obj 


See Also 

Reference 
ObjectOutputStream Class 
Concepts 

ObjectOutputStream Members 
java.io Package 


Visual J# Reference 


ObjectOutputStream.writeShort Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void writeShort( 
int val) throws java.io. IOException; 


Parameters 
val 


See Also 

Reference 
ObjectOutputStream Class 
Concepts 

ObjectOutputStream Members 
java.io Package 


Visual J# Reference 


ObjectOutputStream.writeStreamHeader Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected void writeStreamHeader() throws java.io. IOException; 


See Also 

Reference 
ObjectOutputStream Class 
Concepts 

ObjectOutputStream Members 
java.io Package 


Visual J# Reference 


ObjectOutputStream.writeUTF Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void writeUTF( 
java.lang.String str) throws java.io. IOException; 


Parameters 
str 


See Also 

Reference 
ObjectOutputStream Class 
Concepts 

ObjectOutputStream Members 
java.io Package 


Visual J# Reference 


ObjectStreamClass Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public class java.io.ObjectStreamClass 
extends java.lang.Object 
implements java.io.Serializable 





Inheritance Hierarchy 
java.lang.Object 
java.io.ObjectStreamClass 


See Also 

Concepts 

ObjectStreamClass Members 
java.io Package 


Visual J# Reference 


ObjectStreamClass Members 


The following tables list the members exposed by the ObjectStreamClass type. 


Public Methods 
Name 


equals 


forClass 


hashCode 


getName 


Description 


(inherited from Object ) 


(inherited from Object ) 





getSerialVersionUID 














getClass (inherited from Object ) 
lookup 

clone 

toString Overridden. 





Protected Methods 
Name 


finalize (inherited from Object ) 








See Also 

Reference 
ObjectStreamClass Class 
Concepts 

java.io Package 





Visual J# Reference 


ObjectStreamClass Methods 


Public Methods 





Name 


Description 














equals (inherited from Object ) 
forClass 

hashCode (inherited from Object ) 
getName 





getSerialVersionUID 


getClass 


lookup 


clone 


toString 


Protected Methods 


(inherited from Object ) 


Overridden. 





Name 


Description 





finalize 








(inherited from Object ) 





See Also 

Reference 
ObjectStreamClass Class 
Concepts 

java.io Package 





Visual J# Reference 


ObjectStreamClass.clone Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


See Also 

Reference 
ObjectStreamClass Class 
Concepts 

ObjectStreamClass Members 
java.io Package 


Visual J# Reference 


ObjectStreamClass.forClass Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Class forClass(); 


See Also 

Reference 
ObjectStreamClass Class 
Concepts 

ObjectStreamClass Members 
java.io Package 


Visual J# Reference 


ObjectStreamClass.getName Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getName(); 


See Also 

Reference 
ObjectStreamClass Class 
Concepts 

ObjectStreamClass Members 
java.io Package 


Visual J# Reference 


ObjectStreamClass.getSerialVersionUID Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public long getSerialVersionUID(); 


See Also 

Reference 
ObjectStreamClass Class 
Concepts 

ObjectStreamClass Members 
java.io Package 


Visual J# Reference 


ObjectStreamClass.lookup Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public static java.io.ObjectStreamClass lookup( 
java.lang.Class cl); 


Parameters 
cl 


See Also 

Reference 
ObjectStreamClass Class 
Concepts 

ObjectStreamClass Members 
java.io Package 


Visual J# Reference 


ObjectStreamClass.toString Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toString(); 


See Also 

Reference 
ObjectStreamClass Class 
Concepts 

ObjectStreamClass Members 
java.io Package 


Visual J# Reference 


ObjectStreamException Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract class java.io.ObjectStreamException 
extends java.io.IOException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.io.IOException 
java.io.ObjectStreamException 
Derived Classes 


See Also 

Concepts 

ObjectStreamException Members 
java.io Package 


Visual J# Reference 


ObjectStreamException Members 


The following tables list the members exposed by the ObjectStreamException type. 


Public Constructors 
Name 


ObjectStreamException 





Public Properties (see also Protected Properties ) 











Name Description 

HelpLink (inherited from Exception ) 
InnerException (inherited from Exception ) 
Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 


Protected Properties 





Name Description 





HResult (inherited from Exception ) 








Public Methods 











Name Description 

equals (inherited from Object ) 
filllnStackTrace (inherited from Throwable ) 
GetBaseException (inherited from Exception ) 
hashCode (inherited from Object ) 
getLocalizedMessage (inherited from Throwable ) 
getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 
clone (inherited from Throwable ) 
printStackTrace Overloaded. (inherited from Throwable ) 





toString (inherited from Throwable ) 











Protected Methods 
Name ——iescription —eeeess—Cs—SS 





See Also 

Reference 
ObjectStreamException Class 
Concepts 

java.io Package 


Visual J# Reference 


ObjectStreamException Constructor 


Overload List 





Name Description 





ObjectStreamException () 





ObjectStreamException (String) 





ObjectStreamException (SerializationInfo, StreamingContext) 





ObjectStreamException (String, Exception) 














See Also 

Reference 
ObjectStreamException Class 
Concepts 

ObjectStreamException Members 
java.io Package 


Visual J# Reference 


ObjectStreamException Constructor () 


Initializes a new instance of the ObjectStreamException Class . 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected java.io.ObjectStreamException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
ObjectStreamException Class 
Concepts 

ObjectStreamException Members 
java.io Package 


Visual J# Reference 


ObjectStreamException Constructor (String) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected java.io.ObjectStreamException( 
java.lang.String s); 


Parameters 
S 


See Also 

Reference 
ObjectStreamException Class 
Concepts 

ObjectStreamException Members 
java.io Package 


Visual J# Reference 


ObjectStreamException Constructor (SerializationInfo, 
StreamingContext) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected java.io.ObjectStreamException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


context 


See Also 

Reference 
ObjectStreamException Class 
Concepts 

ObjectStreamException Members 
java.io Package 


Visual J# Reference 


ObjectStreamException Constructor (String, Exception) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected java.io.ObjectStreamException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
S 


inner 


See Also 

Reference 
ObjectStreamException Class 
Concepts 

ObjectStreamException Members 
java.io Package 


Visual J# Reference 


ObjectStreamException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


ObjectStreamException Class 


Concepts 
java.io Package 








Visual J# Reference 


ObjectStreamException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
ObjectStreamException Class 
Concepts 

java.io Package 








Visual J# Reference 


OptionalDataException Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.OptionalDataException 
extends java.io.ObjectStreamException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.io.IOException 
java.io.ObjectStreamException 
java.io.OptionalDataException 


See Also 

Concepts 

OptionalDataException Members 
java.io Package 


Visual J# Reference 


OptionalDataException Members 


The following tables list the members exposed by the OptionalDataException type. 


Public Constructors 
Name 


OptionalDataException 


Public Fields 





Name 


Description 





eof 





length 








Public Properties (see also Protected Properties ) 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 





Description 


(inherited from Exception ) 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


getLocalizedMessage 


getMessage 


GetObjectData 


getClass 





(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 














clone 


printStackTrace 


toString 


Protected Methods 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 








Name 


Description 





finalize 








(inherited from Object ) 





See Also 

Reference 
OptionalDataException Class 
Concepts 

java.io Package 





Visual J# Reference 


OptionalDataException Fields 


Public Fields 





Name Description 





eof 








length 











See Also 

Reference 
OptionalDataException Class 
Concepts 

java.io Package 


Visual J# Reference 


OptionalDataException.eof Field 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public boolean eof; 





See Also 

Reference 
OptionalDataException Class 
Concepts 

OptionalDataException Members 
java.io Package 


Visual J# Reference 


OptionalDataException.length Field 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int length; 


See Also 

Reference 
OptionalDataException Class 
Concepts 

OptionalDataException Members 
java.io Package 


Visual J# Reference 


OptionalDataException Constructor 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected java.io.OptionalDataException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


context 


See Also 

Reference 
OptionalDataException Class 
Concepts 

OptionalDataException Members 
java.io Package 


Visual J# Reference 


OptionalDataException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


OptionalDataException Class 


Concepts 
java.io Package 








Visual J# Reference 


OptionalDataException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
OptionalDataException Class 
Concepts 

java.io Package 








Visual J# Reference 


OutputStream Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract class java.io.OutputStream 
extends java.lang.Object 





Inheritance Hierarchy 
java.lang.Object 
java.io.OutputStream 

java.io.ByteArrayOutputStream 
java.io.FileOutputStream 
java.io.FilterOutputStream 
java.io.ObjectOutputStream 
java.io.PipedOutputStream 


See Also 

Concepts 

OutputStream Members 
java.io Package 


Visual J# Reference 


OutputStream Members 


The following tables list the members exposed by the OutputStream type. 


Public Constructors 
Name 


OutputStream 





Public Methods 





Name Description 





close 





equals (inherited from Object ) 
flush 
hashCode (inherited from Object ) 
getClass (inherited from Object ) 
clone 
toString Overridden. 


write Overloaded. 








Protected Methods 








Name Description 





finalize (inherited from Object ) 














See Also 
Reference 
OutputStream Class 
Concepts 

java.io Package 


Visual J# Reference 


OutputStream Constructor 


Initializes a new instance of the OutputStream Class . 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public java.io.OutputStream() ; 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
OutputStream Class 
Concepts 

OutputStream Members 
java.io Package 


Visual J# Reference 


OutputStream Methods 


Public Methods 






































Name Description 

close 

equals (inherited from Object ) 
flush 

hashCode (inherited from Object ) 
getClass (inherited from Object ) 
clone 

toString Overridden. 

write Overloaded. 
Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 


OutputStream Class 
Concepts 
java.io Package 





Visual J# Reference 


OutputStream.clone Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 





See Also 

Reference 
OutputStream Class 
Concepts 

OutputStream Members 
java.io Package 


Visual J# Reference 


OutputStream.close Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void close() throws java.io. IOException; 


See Also 

Reference 
OutputStream Class 
Concepts 

OutputStream Members 
java.io Package 


Visual J# Reference 


OutputStream.flush Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void flush() throws java.io. IOException; 


See Also 

Reference 
OutputStream Class 
Concepts 

OutputStream Members 
java.io Package 


Visual J# Reference 


OutputStream.toString Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


See Also 

Reference 
OutputStream Class 
Concepts 

OutputStream Members 
java.io Package 


Visual J# Reference 


OutputStream.write Method 


Overload List 





Name 


Description 





OutputStream.write (int) 





OutputStream.write (byte[]) 





OutputStream.write (byte[], int, int) 











See Also 

Reference 
OutputStream Class 
Concepts 

OutputStream Members 
java.io Package 





Visual J# Reference 


OutputStream.write Method (Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract void write( 
int b) throws java.io.IOException; 


Parameters 


b 


See Also 

Reference 
OutputStream Class 
Concepts 

OutputStream Members 
java.io Package 


Visual J# Reference 


OutputStream.write Method (SByte[ ]) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
byte[] b) throws java.io. IOException; 


Parameters 


b 


See Also 

Reference 
OutputStream Class 
Concepts 

OutputStream Members 
java.io Package 
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OutputStream.write Method (SByte[ ], Int32, Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
byte[] buffer, 
int offset, 
int count) throws java.io. IOException; 


Parameters 


buffer 
offset 
count 


See Also 

Reference 
OutputStream Class 
Concepts 

OutputStream Members 
java.io Package 
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OutputStreamWriter Class 


Provides an implementation of the abstract Writer class specific to writing characters to an OutputStream object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.OutputStreamWriter 
extends java.io.Writer 


Example 

The following example demonstrates the close, flush, getEncoding, and write methods of the OutputStreamWriter class. 
// outputstreamwriter_overview.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
try 
{ 
// Create a new instance of a OutputStreamWriter object 
// attached to a ByteArrayOutputStream. 
ByteArrayOutputStream out = 
new ByteArrayOutputStream(); 
OutputStreamWriter writer = new OutputStreamWriter (out); 
// Write to the output stream. 
String s = "Random bytes"; 
writer.write(s); 
writer. flush(); 
// Display the contents of the ByteArrayOutputStream. 
System.out.println(out.toString()); 
// Display the encoding being used. 
System.out.println("encoding: " + 
writer. getEncoding()); 
// Close the OutputStreamWriter object. 
writer.close(); 
} 
catch (IOException ex) 
{ 
System. out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 


Random bytes 
encoding: Cp1252 
*/ 
Inheritance Hierarchy 
java.lang.Object 


java.io.Writer 


java.io.OutputStreamWriter 
java.io.FileWriter 


See Also 

Concepts 

OutputStreamWriter Members 
java.io Package 
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OutputStreamWriter Members 


Provides an implementation of the abstract Writer class specific to writing characters to an OutputStream object. 


The following tables list the members exposed by the OutputStreamWriter type. 


Public Constructors 





Name 


Description 





OutputStreamWriter 





Overloaded. Initializes a new instance of an OutputStreamWriter object. 





Public Fields 
Name ___ Description 





lock The object used to synchronize operations on the writer.(inherited from Writer) 





Public Methods 





Protected Methods 


Name Description 

close Overridden. Closes the underlying OutputStream and releases all internal buffers. 
equals (inherited from Object ) 

flush Overridden. Flushes the underlying OutputStream object. 


getEncoding Returns the character encoding being used on this instance. 


hashCode (inherited from Object ) 

getClass (inherited from Object ) 

clone Creates a shallow copy of this reader. (inherited from Writer) 

toString Displays a human readable representation of a Writer object. (inherited from Writer) 
write Overloaded. Writes the next character or characters to the underlying OutputStream. 





Name 


Description 





finalize 





(inherited from Object ) 








See Also 

Reference 
OutputStreamWriter Class 
Concepts 

java.io Package 
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OutputStreamWriter Fields 


Public Fields 





Name |Description 





lock The object used to synchronize operations on the writer. (inherited from Writer ) 














See Also 

Reference 
OutputStreamWriter Class 
Concepts 

java.io Package 
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OutputStreamWriter Constructor 


Initializes a new instance of an OutputStreamWriter object. 


Overload List 
Name Description 


OutputStreamWriter (OutputStream) Initializes a new instance of an OutputStreamWriter object using the given 
OutputStream as the underlying stream. 





OutputStreamWriter (OutputStream, String)|Initializes a new instance of an OutputStreamWriter object using the given Outpu 
tStream object as the underlying stream. Also specifies the character encoding of 
the underlying stream. 














See Also 

Reference 
OutputStreamWriter Class 
Concepts 

OutputStreamWriter Members 
java.io Package 
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OutputStreamWriter Constructor (OutputStream) 


Initializes a new instance of an OutputStreamWriter object using the given OutputStream as the underlying stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.OutputStreamWriter ( 
java.io.OutputStream out); 


Parameters 
out 


The underlying output stream to write to. 


See Also 

Reference 
OutputStreamWriter Class 
Concepts 

OutputStreamWriter Members 
java.io Package 
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OutputStreamWriter Constructor (OutputStream, String) 


Initializes a new instance of an OutputStreamWriter object using the given OutputStream object as the underlying stream. Also 
specifies the character encoding of the underlying stream. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.OutputStreamwWriter ( 
java.io.OutputStream out, 
java.lang.String enc) throws java.io.UnsupportedEncodingException; 


Parameters 
out 


The underlying output stream to write to. 
enc 
The character encoding of the output stream (such as Unicode). 


See Also 

Reference 
OutputStreamWriter Class 
Concepts 

OutputStreamWriter Members 
java.io Package 
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OutputStreamWriter Methods 


Public Methods 














Name Description 

close Overridden. Closes the underlying OutputStream and releases all internal buffers. 
equals (inherited from Object ) 

flush Overridden. Flushes the underlying OutputStream object. 





getEncoding Returns the character encoding being used on this instance. 





hashCode (inherited from Object ) 

getClass (inherited from Object ) 

clone Creates a shallow copy of this reader. (inherited from Writer ) 

toString Displays a human readable representation of a Writer object. (inherited from Writer ) 
write Overloaded. Writes the next character or characters to the underlying OutputStream. 


Protected Methods 





Name Description 





finalize (inherited from Object ) 














See Also 

Reference 
OutputStreamWriter Class 
Concepts 

java.io Package 
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OutputStreamWriter.close Method 


Closes the underlying OutputStream and releases all internal buffers. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void 


Example 


close() throws java.io. IOException; 


The following example demonstrates how to close an OutputStreamWriter object. 


// outputstreamwriter_close.jsl 


import java. 


10:.*3 


public class Program 


4 
public static void main(String[] args) 
{ 
try 
{ 
// Create a new instance of a OutputStreamwWriter object 
// attached to a ByteArrayOutputStream. 
ByteArrayOutputStream out = 
new ByteArrayOutputStream(); 
OutputStreamWriter writer = new OutputStreamWriter (out); 
// Write to the output stream. 
String s = "Random bytes"; 
writer.write(s); 
writer.flush(); 
// Display the contents of the ByteArrayOutputStream. 
System.out.println(out.toString()); 
// Close the OutputStreamWriter object. 
writer.close(); 
} 
catch (IOException ex) 
if 
System. out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 
Random bytes 
*/ 
See Also 
Reference 
OutputStreamWriter Class 
Concepts 


OutputStreamWriter Members 
java.io Package 
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OutputStreamWriter.flush Method 


Flushes the underlying OutputStream object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void flush() throws java.io. IOException; 


Example 


The following example demonstrates how to flush the contents of an OutputStreamWriter buffer to the attached output 
stream. 


// outputstreamwriter_flush.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
try 
{ 
// Create a new instance of a OutputStreamWriter object 
// attached to a ByteArrayOutputStream. 
ByteArrayOutputStream out = 
new ByteArrayOutputStream(); 
OutputStreamWriter writer = new OutputStreamWriter(out) ; 
// Write to the output stream. 
String s = "Random bytes"; 
writer.write(s); 
writer.flush(); 
// Display the contents of the ByteArrayOutputStream. 
System.out.println(out.toString()); 
// Close the OutputStreamWriter object. 
writer.close(); 
catch (IOException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 
} 
/* 
Output: 
Random bytes 
ay 
See Also 
Reference 
OutputStreamWriter Class 
Concepts 


OutputStreamWriter Members 
java.io Package 
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OutputStreamWriter.getEncoding Method 


Returns the character encoding being used on this instance. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getEncoding(); 


Return Value 
The character encoding of the underlying OutputStream object. 
Example 


The following example demonstrates how to determine the encoding that is being used by the output stream. 
// outputstreamwriter_getencoding.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
try 
{ 
// Create a new instance of a OutputStreamWriter object 
// attached to a ByteArrayOutputStream. 
ByteArrayOutputStream out = 
new ByteArrayOutputStream(); 
OutputStreamWriter writer = new OutputStreamWriter (out); 
// Write to the output stream. 
String s = "Random bytes"; 
writer.write(s); 
writer.flush(); 
// Display the contents of the ByteArrayOutputStream. 
System.out.println(out.toString()); 
// Display the encoding being used. 
System.out.println("encoding: " + 
writer. getEncoding()); 
// Close the OutputStreamWriter object. 
writer.close(); 
catch (IOException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 
} 
/* 
Output: 


Random bytes 
encoding: Cp1252 
*/ 


See Also 
Reference 


OutputStreamWriter Class 
Concepts 

OutputStreamWriter Members 
java.io Package 
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OutputStreamWriter.write Method 


Writes the next character or characters to the underlying OutputStream. 


Overload List 


Name Description 

OutputStreamWriter.write (char[]) Places the given array of characters into the internal buffer holding the characters. 
OutputStreamWriter.write (int) Writes the next character to the underlying OutputStream. 
OutputStreamWriter.write (String) Places the given string into the internal buffer holding characters. 


OutputStreamWriter.write (char{], int, int) |\Writes count characters from the provided buffer, starting at an offset, to the under! 
ying OutputStream object. 


OutputStreamWriter.write (String, int, int)/Writes count characters from the provided string, starting at an offset, to the underly 
ing OutputStream object. 











See Also 

Reference 
OutputStreamWriter Class 
Concepts 

OutputStreamWriter Members 
java.io Package 
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OutputStreamWriter.write Method (Int32) 


Writes the next character to the underlying OutputStream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
int oneChar) throws java.io. IOException; 


Parameters 
oneChar 


The character to write to the underlying OutputStream object. 
Example 
The following example demonstrates how to write a single character at a time to the underlying output stream. 
// outputstreamwriter_write.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
try 
{ 
// Create a new instance of a OutputStreamWriter object 
// attached to a ByteArrayOutputStream. 
ByteArrayOutputStream out = 
new ByteArrayOutputStream(); 
OutputStreamWriter writer = new OutputStreamWriter (out); 
// Write to the output stream. 
String s = "Random bytes"; 
for (int i = @; i < s.length(); i++) 
{ 
writer.write(s.charAt(i)); 
writer.flush(); 
// Display the contents of the ByteArrayOutputStream. 
System.out.println(out.toString()); 
// Close the OutputStreamWriter object. 
writer.close(); 
} 
catch (IOException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 
} 
/* 
Output: 
Random bytes 
=), 
See Also 


Reference 


OutputStreamWriter Class 
Concepts 

OutputStreamWriter Members 
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OutputStreamWriter.write Method (Char J, Int32, Int32) 


Writes count characters from the provided buffer, starting at an offset, to the underlying OutputStream object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
char[] buf, 
int offset, 
int count) throws java.io. IOException; 


Parameters 


buf 
A buffer of characters to write to the underlying OutputStream. 
offset 


An offset into the provided buffer. This value represents the index of the first character in the buffer to be read. This value 
must be greater than zero. 


count 


The number of characters to be read starting from the offset. This value plus the offset must be less than the overall length of 
the provided buffer. 


Example 

The following example demonstrates how to write the contents of an array to the underlying output stream. 
// outputstreamwriter_write_2.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
try 
{ 


// Create a new instance of a OutputStreamwWriter object 
// attached to a ByteArrayOutputStream. 
ByteArrayOutputStream out = 

new ByteArrayOutputStream(); 
OutputStreamWriter writer = new OutputStreamWriter (out); 


// Write to the output stream. 

String s = "Random bytes"; 

char[] arr = s.toCharArray(); 

// Only write from the 7th character on. 
writer.write(arr, 7, arr.length - 7); 
writer.flush(); 


// Display the contents of the ByteArrayOutputStream. 
System.out.println(out.toString()); 


// Close the OutputStreamWriter object. 
writer.close(); 


} 
catch (IOException ex) 


{ 
} 


System.out.printin(ex.toString()); 


} 


/* 
Output: 
bytes 
*/ 











See Also 

Reference 
OutputStreamWriter Class 
Concepts 

OutputStreamWriter Members 
java.io Package 
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OutputStreamWriter.write Method (String, Int32, Int32) 


Writes count characters from the provided string, starting at an offset, to the underlying OutputStream object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
java.lang.String str, 
int offset, 
int count) throws java.io. IOException; 


Parameters 
str 


A string to write to the underlying OutputStream. 
offset 


An offset into the provided string. This value represents the index of the first character in the string to be read. This value 
must be greater than zero. 


count 


The number of characters to be read starting from the offset. This value plus the offset must be less than the overall length of 
the provided string. 


Example 

The following example demonstrates how to write the contents of a string to the underlying output stream. 
// outputstreamwriter_write_3.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
try 
{ 


// Create a new instance of a OutputStreamWriter object 
// attached to a ByteArrayOutputStream. 
ByteArrayOutputStream out = 

new ByteArrayOutputStream(); 
OutputStreamWriter writer = new OutputStreamWriter (out); 


// Write to the output stream. 

String s = "Random bytes"; 

// Only write from the 7th character on. 
writer.write(s, 7, s.length() - 7); 
writer.flush(); 


// Display the contents of the ByteArrayOutputStream. 
System.out.println(out.toString()); 


// Close the OutputStreamWriter object. 
writer.close(); 


} 
catch (IOException ex) 
{ 
System.out.printin(ex.toString()); 
} 





See Also 

Reference 
OutputStreamWriter Class 
Concepts 

OutputStreamWriter Members 
java.io Package 
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PipedinputStream Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.PipedInputStream 
extends java.io.InputStream 





Inheritance Hierarchy 

java.lang.Object 
java.io.InputStream 
java.io.PipedinputStream 


See Also 

Concepts 

PipedinputStream Members 
java.io Package 
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PipedinputStream Members 


The following tables list the members exposed by the PipedinputStream type. 


Public Constructors 
Name 


PipedinputStream 





Public Fields 





Name Description 





buffer 





PIPE_SIZE 





Public Methods 









































Name Description 

available Overridden. 

close Overridden. 

connect 

equals (inherited from Object ) 
hashCode (inherited from Object ) 
getClass (inherited from Object ) 

mark (inherited from InputStream ) 
markSupported (inherited from InputStream ) 
clone (inherited from InputStream ) 
read Overloaded. Overridden. 
receive 

reset (inherited from InputStream ) 
skip (inherited from InputStream ) 
toString (inherited from InputStream ) 





Protected Methods 











Name Description 











finalize (inherited from Object ) 














See Also 

Reference 
PipedinputStream Class 
Concepts 

java.io Package 
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PipedinputStream Fields 


Public Fields 





Name Description 





buffer 








out 





PIPE_SIZE 











See Also 

Reference 
PipedinputStream Class 
Concepts 

java.io Package 
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PipedInputStream.buffer Field 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected byte[] buffer; 


See Also 

Reference 
PipedinputStream Class 
Concepts 

PipedinputStream Members 
java.io Package 
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PipedinputStream.in Field 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 





protected int in; 





See Also 

Reference 
PipedinputStream Class 
Concepts 

PipedinputStream Members 
java.io Package 
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PipedinputStream.out Field 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 





protected int out; 





See Also 

Reference 
PipedinputStream Class 
Concepts 

PipedinputStream Members 
java.io Package 
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PipediInputStream.PIPE_SIZE Field 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected static final int PIPE_SIZE; 


See Also 

Reference 
PipedinputStream Class 
Concepts 

PipedinputStream Members 
java.io Package 
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PipedinputStream Constructor 


Overload List 





Name Description 





PipedinputStream () 





PipedinputStream (PipedOutputStream) 











See Also 

Reference 
PipedinputStream Class 
Concepts 

PipedinputStream Members 
java.io Package 
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PipedinputStream Constructor () 


Initializes a new instance of the PipedinputStream Class . 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.PipedInputStream() ; 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
PipedinputStream Class 
Concepts 

PipedinputStream Members 
java.io Package 
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PipedInputStream Constructor (PipedOutputStream) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.PipedInputStream( 
java.io.PipedOutputStream src) throws java.io. IOException; 


Parameters 
src 


See Also 

Reference 
PipedinputStream Class 
Concepts 

PipedinputStream Members 
java.io Package 
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PipedinputStream Methods 


Public Methods 









































Name Description 

available Overridden. 

close Overridden. 

connect 

equals (inherited from Object ) 
hashCode (inherited from Object ) 
getClass (inherited from Object ) 

mark (inherited from InputStream ) 
markSupported (inherited from InputStream ) 
clone (inherited from InputStream ) 
read Overloaded. Overridden. 
receive 

reset (inherited from InputStream ) 
skip (inherited from InputStream ) 
toString (inherited from InputStream ) 
Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 

PipedinputStream Class 

Concepts 


java.io Package 
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PipedinputStream.available Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized int available() throws java.io. IOException; 


See Also 

Reference 
PipedinputStream Class 
Concepts 

PipedinputStream Members 
java.io Package 
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PipedinputStream.close Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void close() throws java.io. IOException; 


See Also 

Reference 
PipedinputStream Class 
Concepts 

PipedinputStream Members 
java.io Package 
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PipedinputStream.connect Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void connect( 
java.io.PipedOutputStream src) throws java.io. IOException; 


Parameters 
SIC 


See Also 

Reference 
PipedinputStream Class 
Concepts 

PipedinputStream Members 
java.io Package 
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PipedinputStream.read Method 


Overload List 





Name 


Description 





PipedinputStream.read () 





PipedinputStream.read (byte[]) 





PipedInputStream.read (byte[], int, int) 











See Also 

Reference 
PipedinputStream Class 
Concepts 

PipedinputStream Members 
java.io Package 
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PipedInputStream.read Method () 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized int read() throws java.io. IOException; 


See Also 

Reference 
PipedinputStream Class 
Concepts 

PipedinputStream Members 
java.io Package 
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PipedInputStream.read Method (SByte[ ], Int32, Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized int read( 
byte[] b, 
int off, 
int len) throws java.io.IOException; 


Parameters 


b 


off 
len 


See Also 

Reference 
PipedinputStream Class 
Concepts 

PipedinputStream Members 
java.io Package 
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PipedinputStream.receive Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected synchronized void receive( 
int b) throws java.io.IOException; 


Parameters 


b 


See Also 

Reference 
PipedinputStream Class 
Concepts 

PipedinputStream Members 
java.io Package 


Visual J# Reference 


PipedOutputStream Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.PipedOutputStream 
extends java.io.OutputStream 





Inheritance Hierarchy 

java.lang.Object 
java.io.OutputStream 
java.io.PipedOutputStream 


See Also 

Concepts 

PipedOutputStream Members 
java.io Package 
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PipedOutputStream Members 


The following tables list the members exposed by the PipedOutputStream type. 


Public Constructors 



































Name 

PipedOutputStream 

Public Methods 

Name Description 

close Overridden. 

connect 

equals (inherited from Object ) 

flush Overridden. 

hashCode (inherited from Object ) 
getClass (inherited from Object ) 

clone (inherited from OutputStream ) 
toString (inherited from OutputStream ) 
write Overloaded. Overridden. 
Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 

PipedOutputStream Class 

Concepts 


java.io Package 
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PipedOutputStream Constructor 


Overload List 





Name Description 





PipedOutputStream () 





PipedOutputStream (PipedinputStream) 











See Also 

Reference 
PipedOutputStream Class 
Concepts 

PipedOutputStream Members 
java.io Package 
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PipedOutputStream Constructor () 


Initializes a new instance of the PipedOutputStream Class . 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.PipedOutputStream(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
PipedOutputStream Class 
Concepts 

PipedOutputStream Members 
java.io Package 
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PipedOutputStream Constructor (PipedInputStream) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.PipedOutputStream( 
java.io.PipedInputStream dest) throws java.io. IOException; 


Parameters 
dest 


See Also 

Reference 
PipedOutputStream Class 
Concepts 

PipedOutputStream Members 
java.io Package 
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PipedOutputStream Methods 


Public Methods 






































Name Description 

close Overridden. 

connect 

equals (inherited from Object ) 

flush Overridden. 

hashCode (inherited from Object ) 
getClass (inherited from Object ) 

clone (inherited from OutputStream ) 
toString (inherited from OutputStream ) 
write Overloaded. Overridden. 
Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 


PipedOutputStream Class 


Concepts 
java.io Package 
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PipedOutputStream.close Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void close() throws java.io. IOException; 


See Also 

Reference 
PipedOutputStream Class 
Concepts 

PipedOutputStream Members 
java.io Package 
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PipedOutputStream.connect Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void connect( 
java.io.PipedInputStream dest) throws java.io. IOException; 


Parameters 
dest 


See Also 

Reference 
PipedOutputStream Class 
Concepts 

PipedOutputStream Members 
java.io Package 
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PipedOutputStream.flush Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized void flush() throws java.io. IOException; 


See Also 

Reference 
PipedOutputStream Class 
Concepts 

PipedOutputStream Members 
java.io Package 
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PipedOutputStream.write Method 


Overload List 





Name Description 





PipedOutputStream.write (int) 





PipedOutputStream.write (byte[]) 





PipedOutputStream.write (byte[], int, int) 











See Also 

Reference 
PipedOutputStream Class 
Concepts 

PipedOutputStream Members 
java.io Package 
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PipedOutputStream.write Method (Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
int b) throws java.io.IOException; 


Parameters 


b 


See Also 

Reference 
PipedOutputStream Class 
Concepts 

PipedOutputStream Members 
java.io Package 
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PipedOutputStream.write Method (SByte[ ], Int32, Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
byte[] b, 
int off, 
int len) throws java.io.IOException; 


Parameters 


b 


off 
len 


See Also 

Reference 
PipedOutputStream Class 
Concepts 

PipedOutputStream Members 
java.io Package 
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PipedReader Class 


Provides an implementation of the abstract Reader class specific to reading characters from a PipedWriter object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.PipedReader 
extends java.io.Reader 


Example 


The following example demonstrates the close, connect, read, and ready methods of the PipedReader class. 


// pipedreader_overview.jsl 
import java.io.*; 


public class Program 


{ 


public static void main(String[] args) 


{ 
try 


{ 
// Create a new instance of a PipedReader object. 
PipedReader reader = new PipedReader(); 


// Connect the PipedReader to a PipedWriter object. 
PipedwWriter writer = new Pipedwriter(); 
reader.connect(writer) ; 


// Read from the PipedwWriter. 
writer.write("Hello, PipedReader!"); 


while (reader.ready()) 
{ 


} 


// Close the PipedReader and Pipedwriter. 
reader.close(); 
writer.close(); 


System.out.print((char)reader.read()); 


catch (IOException ex) 
{ 


i 


System.out.println(ex.toString()); 


} 
/* 
Output: 
Hello, PipedReader! 
*/ 
Inheritance Hierarchy 
java.lang.Object 


java.io.Reader 


java.io.PipedReader 


See Also 

Concepts 

PipedReader Members 
java.io Package 
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PipedReader Members 


Provides an implementation of the abstract Reader class specific to reading characters from a PipedWriter object. 


The following tables list the members exposed by the PipedReader type. 


Public Constructors 





Name Description 





PipedReader Overloaded. Initializes a new instance of a PipedReader object. 








Public Fields 
Name |Description 





lock The object used to synchronize operations on the reader.(inherited from Reader) 





Public Methods 


Name Description 
close Overridden. Closes the connection between the PipedReader and PipedWriter. 
connect Opens the connection between a PipedReader and the PipedWriter. 


equals (inherited from Object ) 
hashCode (inherited from Object ) 
getClass (inherited from Object ) 
mark Sets the mark to the next character of the characters to be read. (inherited from Reader) 


markSupported|/Determines whether the current position of the character can be marked. (inherited from Reader) 














clone Creates a shallow copy of the object. (inherited from Reader) 

read Overloaded. Overridden. Reads the next character or characters from the attached PipedWriter. 

ready Overridden. Determines whether the attached PipedWriter is ready for reading. 

reset Resets the reader for the characters such that the next character read is the character that is marked. (inherited 


from Reader) 


skip Skips over the next count characters of the characters being read or until the end of the array, whichever is les 
s. (inherited from Reader) 








toString Displays a human readable representation of the reader. (inherited from Reader) 


Protected Methods 

















Name Description 
finalize (inherited from Object ) 
See Also 


Reference 
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PipedReader Fields 


Public Fields 





Name _ Description 





lock The object used to synchronize operations on the reader. (inherited from Reader ) 











See Also 
Reference 
PipedReader Class 
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java.io Package 
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PipedReader Constructor 


Initializes a new instance of a PipedReader object. 


Overload List 
Name Description 


PipedReader () Initializes a new instance of a PipedReader object. 


PipedReader (PipedWriter)|Initializes a new instance of a PipedReader object using the provided PipedWriter object as the sou 
rce to be read. 











See Also 

Reference 
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java.io Package 
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PipedReader Constructor () 


Initializes a new instance of a PipedReader object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public java.io.PipedReader(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
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PipedReader Constructor (PipedWriter) 


Initializes a new instance of a PipedReader object using the provided PipedWriter object as the source to be read. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.PipedReader( 
java.io.PipedwWriter src) throws java.io. IOException; 


Parameters 
sre 


A PipedWriter object representing the source of the data to be read. 


See Also 

Reference 
PipedReader Class 
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PipedReader Members 
java.io Package 
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PipedReader Methods 


Public Methods 















































Name Description 

close Overridden. Closes the connection between the PipedReader and PipedWriter. 

connect Opens the connection between a PipedReader and the PipedWriter. 

equals (inherited from Object ) 

hashCode (inherited from Object ) 

getClass (inherited from Object ) 

mark Sets the mark to the next character of the characters to be read. (inherited from Reader ) 

markSupported/Determines whether the current position of the character can be marked. (inherited from Reader ) 

clone Creates a shallow copy of the object. (inherited from Reader ) 

read Overloaded. Overridden. Reads the next character or characters from the attached PipedWriter. 

ready Overridden. Determines whether the attached PipedWriter is ready for reading. 

reset Resets the reader for the characters such that the next character read is the character that is marked. (inherited 
from Reader ) 

skip Skips over the next count characters of the characters being read or until the end of the array, whichever is les 
s. (inherited from Reader ) 

toString Displays a human readable representation of the reader. (inherited from Reader ) 

Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 
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PipedReader.close Method 


Closes the connection between the PipedReader and PipedWriter. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void close() throws java.io. IOException; 


Example 
The following example demonstrates how to close a PipedReader object. 


| 
// pipedreader_close.jsl 


import java.io.*; 
public class Program 


public static void main(String[] args) 


{ 
try 
{ 
// Create a new instance of a PipedReader object. 
PipedReader reader = new PipedReader(); 
// Connect the PipedReader to a PipedWriter object. 
Pipedwriter writer = new Pipedwriter(); 
reader.connect(writer) ; 
// Read from the PipedwWriter. 
writer.write("Hello, PipedReader!"); 
while (reader.ready()) 
{ 
System.out.print((char)reader.read()); 
} 
// Close the PipedReader and PipedwWriter. 
reader.close(); 
writer.close(); 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
/ * 
Output: 
Hello, PipedReader! 
af 
See Also 
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PipedReader.connect Method 


Opens the connection between a PipedReader and the PipedWriter. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void connect( 
java.io.PipedwWriter src) throws java.io. IOException; 


Parameters 
sre 


A PipedWriter object representing the source of the data to be read. 
Example 


The following example shows how to connect a PipedReader object to a PipedWriter object. 
// pipedreader_connect.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 


{ 
try 
{ 
// Create a new instance of a PipedReader object. 
PipedReader reader = new PipedReader(); 
// Connect the PipedReader to a PipedWriter object. 
Pipedwriter writer = new PipedwWriter(); 
reader.connect(writer) ; 
// Read from the PipedwWriter. 
writer.write("Hello, PipedReader!"); 
while (reader.ready()) 
{ 
System.out.print((char)reader.read()); 
} 
// Close the PipedReader and PipedwWriter. 
reader.close(); 
writer.close(); 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 
Hello, PipedReader! 
af 
Remarks 


Opens a connection to the specified PipedWriter if this reader and the specified writer are not already connected. This method 


fails by throwing an IOException exception if either the reader or writer are closed or there is an existing connection. 


See Also 
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PipedReader.read Method 


Reads the next character or characters from the attached PipedWriter. 


Overload List 


Name Description 
PipedReader.read () Reads the next character from the attached PipedWriter. 
PipedReader.read (char[]) Reads the characters in the array starting at an offset for the length specified and stores them 


in the provided array of characters. 





PipedReader.read (char]], int, int)/Reads len characters from the attached PipedWriter and stores the characters in the provided 
buffer, starting from an offset. 








See Also 
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PipedReader.read Method () 


Reads the next character from the attached PipedWriter. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read() throws java.io. IOException; 


Return Value 


The numeric value of the character read from the writer, or -1 if either the writer or the connection is closed. 


Example 


The following example shows how to read one character at a time from a PipedWriter object. 


// pipedreader_read.jsl 


import java. 


io.*; 


public class Program 


public static void main(String[] args) 


// Create a new instance of a PipedReader object. 


PipedReader reader = new PipedReader(); 


// Connect the PipedReader to a PipedWriter object. 


PipedwWriter writer = new PipedwWriter(); 
reader.connect(writer) ; 


// Read from the PipedwWriter. 
writer.write("Hello, PipedReader!"); 


while (reader.ready()) 
{ 


} 


// Close the PipedReader and Pipedwriter. 
reader.close(); 
writer.close(); 


System.out.print((char)reader.read()); 


catch (IOException ex) 


System.out.println(ex.toString()); 


Hello, PipedReader! 


{ 
{ 
try 
{ 
{ 
li 
i 
ij 
/* 
Output: 
* | 
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PipedReader.read Method (Char ], Int32, Int32) 


Reads len characters from the attached PipedWriter and stores the characters in the provided buffer, starting from an offset. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read( 
char[] b, 
int off, 
int len) throws java.io. IOException; 


Parameters 
b 
A buffer to store the characters read from the attached PipedWriter. 


off 


An offset into the array of characters. This value represents the index of the first character in the array to be written. This 
value must be greater than zero. 


len 


The number of characters to be read starting from the offset. This value plus the offset must be less than the overall length of 
the buffer. 


Return Value 
The number of characters read from the attached PipedWriter. 
Example 


The following example shows how to read data from a PipedWriter object and store the contents in an array. 
// pipedreader_read_2.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
try 
{ 


// Create a new instance of a PipedReader object. 
PipedReader reader = new PipedReader(); 


// Connect the PipedReader to a PipedWriter object. 
Pipedwriter writer = new PipedwWriter(); 
reader.connect(writer) ; 


// Read from the PipedwWriter. 
String s = "Hello, PipedReader!"; 
writer.write(s); 


char[] arr = new char[s.length()]; 
while (reader.ready()) 
{ 
reader.read(arr, @, arr.length); 
System.out.print(arr) ; 


} 


// Close the PipedReader and Pipedwriter. 
reader.close(); 











writer.close(); 
} 
catch (IOException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 
} 
/* 
Output: 
Hello, PipedReader! 
=i 
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PipedReader.ready Method 


Determines whether the attached PipedWriter is ready for reading. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean ready() throws java.io. IOException; 


Return Value 
true if the attached PipedWriter object is ready for reading; false otherwise. 
Example 


The following example demonstrates how to determine if a PipedReader object is ready for reading. 
// pipedreader_ready.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
try 
{ 
// Create a new instance of a PipedReader object. 
PipedReader reader = new PipedReader(); 
// Connect the PipedReader to a PipedWriter object. 
Pipedwriter writer = new PipedwWriter(); 
reader.connect(writer) ; 
// Read from the PipedwWriter. 
String s = "Hello, PipedReader!"; 
writer.write(s); 
char[] arr = new char[s.length()]; 
while (reader.ready()) 
{ 
reader.read(arr, 8, arr.length); 
System.out.print(arr) ; 
} 
// Close the PipedReader and Pipedwriter. 
reader.close(); 
writer.close(); 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 
Hello, PipedReader! 
aA 
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PipedWriter Class 


Provides an implementation of the abstract Writer class specific to writing characters to a PipedWriter object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.PipedwWriter 
extends java.io.Writer 


Example 


The following example demonstrates the close, connect, flush, and write methods of the PipedWriter class. 


// pipedwriter_overview.jsl 
import java.io.*; 


public class Program 


{ 


public static void main(String[] args) 


{ 
try 


{ 


// Create a new instance of a PipedwWriter object. 
Pipedwriter writer = new Pipedwriter(); 


// Connect the PipedWriter to a PipedReader object. 
PipedReader reader = new PipedReader(); 
writer.connect (reader) ; 


// Read from the PipedwWriter. 
writer.write("Hello, PipedReader!"); 
writer.flush(); 


while (reader.ready()) 
{ 


} 


// Close the PipedReader and PipedwWriter. 
reader.close(); 
writer.close(); 


System.out.print((char)reader.read()); 


} 
catch (IOException ex) 


{ 
} 


System.out.println(ex.toString()); 


} 
/* 
Output: 
Hello, PipedReader! 
“7 
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PipedWriter Members 


Provides an implementation of the abstract Writer class specific to writing characters to a PipedWriter object. 


The following tables list the members exposed by the PipedWriter type. 


Public Constructors 





Name Description 





PipedWriter Overloaded. Initializes a new instance of a PipedWriter object. 








Public Fields 
Name ___ Description 





lock The object used to synchronize operations on the writer.(inherited from Writer) 





Public Methods 


Name Description 

close Overridden. Closes the connection between the PipedWriter and PipedReader. 
connect Opens the connection between a PipedWriter and the PipedReader. 

equals (inherited from Object ) 

flush Overridden. Flushes the contents of the underlying buffer to the PipedReader. 


hashCode (inherited from Object ) 


getClass (inherited from Object ) 

clone Creates a shallow copy of this reader. (inherited from Writer) 

toString Displays a human readable representation of a Writer object. (inherited from Writer) 
write Overloaded. Writes the next character or characters to the attached PipedReader. 








Protected Methods 








Name Description 





finalize (inherited from Object ) 
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PipedWriter Fields 


Public Fields 





Name |Description 





lock The object used to synchronize operations on the writer. (inherited from Writer ) 














See Also 
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PipedWriter Constructor 


Initializes a new instance of a PipedWriter object. 


Overload List 
Name Description 


PipedWriter () Initializes a new instance of a PipedWriter object. 


PipedWriter (PipedReader)|Initializes a new instance of a PipedWriter object using the provided PipedReader object as the dest 
ination for the characters to be written. 
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PipedWriter Constructor () 


Initializes a new instance of a PipedWriter object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public java.io.Pipedwriter(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 
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PipedWriter Constructor (PipedReader) 


Initializes a new instance of a PipedWriter object using the provided PipedReader object as the destination for the characters to 
be written. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.Pipedwriter( 
java.io.PipedReader dest) throws java.io. IOException; 


Parameters 
dest 


A PipedReader object representing the destination of the data to be written. 


See Also 
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PipedWriter Methods 


Public Methods 






































Name Description 

close Overridden. Closes the connection between the PipedWriter and PipedReader. 
connect Opens the connection between a PipedWriter and the PipedReader. 

equals (inherited from Object ) 

flush Overridden. Flushes the contents of the underlying buffer to the PipedReader. 
hashCode (inherited from Object ) 

getClass (inherited from Object ) 

clone Creates a shallow copy of this reader. (inherited from Writer ) 

toString Displays a human readable representation of a Writer object. (inherited from Writer ) 
write Overloaded. Writes the next character or characters to the attached PipedReader. 
Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 
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PipedWriter.close Method 


Closes the connection between the PipedWriter and PipedReader. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void close() throws java.io. IOException; 


Example 

The following example demonstrates how to close a PipedWriter object. 
// pipedwriter_close.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 


{ 
try 
{ 
// Create a new instance of a PipedwWriter object. 
Pipedwriter writer = new Pipedwriter(); 
// Connect the PipedWriter to a PipedReader object. 
PipedReader reader = new PipedReader(); 
writer.connect (reader) ; 
// Read from the PipedwWriter. 
writer.write("Hello, PipedReader!"); 
writer.flush(); 
while (reader.ready()) 
{ 
System.out.print((char)reader.read()); 
} 
// Close the PipedReader and Pipedwriter. 
reader.close(); 
writer.close(); 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 
Hello, PipedReader! 
a 
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PipedWriter.connect Method 


Opens the connection between a PipedWriter and the PipedReader. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void connect( 


java.io.PipedReader dest) throws java.io. IOException; 


Parameters 


dest 


A PipedReader object representing the destination of the data to be written. 


Example 


The following example demonstrates how to connect a PipedWriter object to a PipedReader object. 


// pipedwriter_connect.jsl 


import java.io.*; 


public class Program 


public static void main(String[] args) 


{ 


} 
/* 


Output: 


try 
{ 


// Create a new instance of a PipedwWriter object. 


Pipedwriter writer = new PipedwWriter(); 


// Connect the PipedwWriter to a PipedReader object. 


PipedReader reader = new PipedReader(); 
writer.connect (reader) ; 


// Read from the PipedwWriter. 
writer.write("Hello, PipedReader!"); 
writer.flush(); 


while (reader.ready()) 
{ 


} 


// Close the PipedReader and Pipedwriter. 
reader.close(); 
writer.close(); 


System.out.print((char)reader.read()); 


catch (IOException ex) 


{ 
; 


System.out.println(ex.toString()); 


Hello, PipedReader! 


*/ 
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PipedWriter.flush Method 


Flushes the contents of the underlying buffer to the PipedReader. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void flush() throws java.io. IOException; 


Example 

The following example demonstrates how to flush the PipedWriter buffer. 
// pipedwriter_flush.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 


{ 
try 
{ 
// Create a new instance of a PipedwWriter object. 
Pipedwriter writer = new Pipedwriter(); 
// Connect the PipedWriter to a PipedReader object. 
PipedReader reader = new PipedReader(); 
writer.connect (reader) ; 
// Read from the PipedwWriter. 
writer.write("Hello, PipedReader!"); 
writer.flush(); 
while (reader.ready()) 
{ 
System.out.print((char)reader.read()); 
} 
// Close the PipedReader and Pipedwriter. 
reader.close(); 
writer.close(); 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 
Hello, PipedReader! 
a 
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PipedWriter.write Method 


Writes the next character or characters to the attached PipedReader. 


Overload List 


Name Description 

PipedWriter.write (char[]) Places the given array of characters into the internal buffer holding the characters. 
PipedWriter.write (int) Writes the next character to the attached PipedReader. 

PipedWriter.write (String) Places the given string into the internal buffer holding characters. 


PipedWriter.write (char{], int, int) Writes len characters from the provided buffer, starting at an offset, to the attached PipedRea 
der. 


PipedWriter.write (String, int, int)/Places the given string, starting from the offset and for the length specified, into the internal 
buffer holding the characters. 
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PipedWriter.write Method (Int32) 


Writes the next character to the attached PipedReader. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
int b) throws java.io.IOException; 


Parameters 


b 
The character to write to the attached PipedReader. 
Example 


The following example shows how to write one character at a time to a PipedWriter object. 
// pipedwriter_write.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 


{ 
try 
{ 
// Create a new instance of a PipedwWriter object. 
Pipedwriter writer = new PipedwWriter(); 
// Connect the PipedWriter to a PipedReader object. 
PipedReader reader = new PipedReader(); 
writer.connect (reader) ; 
// Read from the PipedwWriter. 
String s = "Hello, PipedReader!"; 
for (int i = @; i < s.length(); i++) 
{ 
writer.write(s.charAt(i)); 
writer.flush(); 
while (reader.ready()) 
1 
System.out.print((char)reader.read()); 
} 
// Close the PipedReader and Pipedwriter. 
reader.close(); 
writer.close(); 
} 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 


Hello, PipedReader! 
*/ 
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PipedWriter.write Method (CharT J, Int32, Int32) 


Writes len characters from the provided buffer, starting at an offset, to the attached PipedReader. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
char[] b, 
int off, 
int len) throws java.io. IOException; 


Parameters 


b 
A buffer of characters to write to the attached PipedReader. 


off 


An offset into the provided buffer. This value represents the index of the first character in the buffer to be read. This value 
must be greater than zero. 


len 


The number of characters to be read starting from the offset. This value plus the offset must be less than the overall length of 
the provided buffer. 


Example 

The following example demonstrates how to write an array of data to a PipedWriter object. 
// pipedwriter_write_2.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
try 
{ 


// Create a new instance of a PipedwWriter object. 
Pipedwriter writer = new PipedwWriter(); 


// Connect the PipedwWriter to a PipedReader object. 
PipedReader reader = new PipedReader(); 
writer.connect (reader) ; 


// Read from the PipedwWriter. 
String s = "Hello, PipedReader!"; 
char[] arr = s.toCharArray(); 
writer.write(arr, 8, arr.length); 
writer. flush(); 


while (reader.ready()) 
{ 


} 


// Close the PipedReader and PipedwWriter. 
reader.close(); 
writer.close(); 


System.out.print((char)reader.read()); 


catch (IOException ex) 


System. out.println(ex.toString()); 


} 


/* 

Output: 

Hello, PipedReader! 
*/ 
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PrintStream Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.PrintStream 
extends java.io.FilterOutputStream 





Inheritance Hierarchy 
java.lang.Object 
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PrintStream Members 


The following tables list the members exposed by the PrintStream type. 


Public Constructors 







































































Name 

PrintStream 

Public Fields 

Name Description 

out (inherited from FilterOutputStream ) 
Public Methods 

Name Description 

checkError 

close Overridden. 

equals (inherited from Object ) 
flush Overridden. 

hashCode (inherited from Object ) 
getClass (inherited from Object ) 
clone (inherited from OutputStream ) 
print Overloaded. 

printin Overloaded. 

setError 

toString (inherited from OutputStream ) 
write Overloaded. Overridden. 
Protected Methods 

Name Description 

finalize (inherited from Object ) 
See Also 
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PrintStream Fields 


Public Fields 





Name Description 





out (inherited from FilterOutputStream ) 











See Also 
Reference 
PrintStream Class 
Concepts 

java.io Package 


Visual J# Reference 


PrintStream Constructor 


Overload List 





Name 


Description 





PrintStream (OutputStream) 





PrintStream (OutputStream, boolean) 











See Also 

Reference 
PrintStream Class 
Concepts 

PrintStream Members 
java.io Package 
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PrintStream Constructor (OutputStream) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.PrintStream( 
java.io.OutputStream out); 


Parameters 
out 


See Also 

Reference 
PrintStream Class 
Concepts 

PrintStream Members 
java.io Package 
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PrintStream Constructor (OutputStream, Boolean) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.PrintStream( 
java.io.OutputStream out, 
boolean autoflush) ; 


Parameters 
out 


autoflush 


See Also 

Reference 
PrintStream Class 
Concepts 

PrintStream Members 
java.io Package 
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PrintStream Methods 


Public Methods 






































Name Description 

checkError 

close Overridden. 

equals (inherited from Object ) 

flush Overridden. 

hashCode (inherited from Object ) 
getClass (inherited from Object ) 

clone (inherited from OutputStream ) 
print Overloaded. 

printin Overloaded. 

setError 

toString (inherited from OutputStream ) 
write Overloaded. Overridden. 
Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 

PrintStream Class 

Concepts 


java.io Package 
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PrintStream.checkError Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean checkError(); 


See Also 

Reference 
PrintStream Class 
Concepts 

PrintStream Members 
java.io Package 
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PrintStream.close Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public void close(); 





See Also 

Reference 
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java.io Package 
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PrintStream.flush Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public void flush(); 





See Also 

Reference 
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Concepts 
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PrintStream.print Method 


Overload List 





Name Description 





PrintStream.print (boolean) 





PrintStream.print (char) 





PrintStream.print (char[]) 





PrintStream.print (double) 





PrintStream.print (int) 


PrintStream.print (long) 


PrintStream.print (Object) 


PrintStream.print (float) 


PrintStream.print (String) 








See Also 
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java.io Package 
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PrintStream.print Method (Boolean) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void print( 
boolean b); 


Parameters 


b 


See Also 

Reference 
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PrintStream.print Method (Char) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void print( 
char c); 


Parameters 
Cc 


See Also 

Reference 
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PrintStream Members 
java.io Package 
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PrintStream.print Method (CharT ]) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void print( 
char[] s)3 


Parameters 
Ss 


See Also 

Reference 
PrintStream Class 
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PrintStream Members 
java.io Package 
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PrintStream.print Method (Double) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void print( 
double d); 


Parameters 


d 


See Also 

Reference 
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Concepts 

PrintStream Members 
java.io Package 
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PrintStream.print Method (Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void print( 
int i); 


Parameters 
l 


See Also 

Reference 
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PrintStream Members 
java.io Package 
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PrintStream.print Method (Int64) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void print( 
long 1); 


Parameters 


l 


See Also 

Reference 
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PrintStream.print Method (Object) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void print( 
java.lang.Object 0); 


Parameters 
oO 


See Also 

Reference 
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java.io Package 
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PrintStream.print Method (Single) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void print( 
float f); 


Parameters 


f 


See Also 

Reference 
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PrintStream.print Method (String) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void print( 
java.lang.String str); 


Parameters 
str 


See Also 

Reference 
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Concepts 

PrintStream Members 
java.io Package 
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PrintStream.printin Method 


Overload List 





Name Description 





PrintStream.println () 





PrintStream.println (boolean) 





PrintStream.println (char) 





PrintStream.println (char[]) 





PrintStream.println (double) 


PrintStream.println (int) 


PrintStream.println (long) 


PrintStream.println (Object) 


PrintStream.printin (float) 


PrintStream.println (String) 








See Also 

Reference 
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PrintStream.printin Method () 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void println(); 


See Also 

Reference 
PrintStream Class 
Concepts 

PrintStream Members 
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PrintStream.printiIn Method (Boolean) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void println( 
boolean b); 


Parameters 


b 


See Also 

Reference 
PrintStream Class 
Concepts 

PrintStream Members 
java.io Package 
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PrintStream.printiIn Method (Char) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void println( 
char c); 


Parameters 
Cc 


See Also 

Reference 
PrintStream Class 
Concepts 

PrintStream Members 
java.io Package 
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PrintStream.printin Method (CharT ]) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void println( 
char[] arry); 


Parameters 
arry 


See Also 

Reference 
PrintStream Class 
Concepts 

PrintStream Members 
java.io Package 
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PrintStream.printin Method (Double) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void println( 
double d); 


Parameters 


d 


See Also 

Reference 
PrintStream Class 
Concepts 

PrintStream Members 
java.io Package 
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PrintStream.printin Method (Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void println( 
int i); 


Parameters 
l 


See Also 

Reference 
PrintStream Class 
Concepts 

PrintStream Members 
java.io Package 


Visual J# Reference 


PrintStream.printin Method (Int64) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void println( 
long 1); 


Parameters 


l 


See Also 

Reference 
PrintStream Class 
Concepts 

PrintStream Members 
java.io Package 
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PrintStream.printin Method (Object) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void printin( 
java.lang.Object 0); 


Parameters 
oO 


See Also 

Reference 
PrintStream Class 
Concepts 

PrintStream Members 
java.io Package 
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PrintStream.printin Method (Single) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void println( 
float f); 


Parameters 


f 


See Also 

Reference 
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PrintStream.printin Method (String) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void printlin( 
java.lang.String s); 


Parameters 
Ss 


See Also 

Reference 
PrintStream Class 
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PrintStream.setError Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected void setError(); 


See Also 

Reference 
PrintStream Class 
Concepts 

PrintStream Members 
java.io Package 
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PrintStream.write Method 


Overload List 





Name 


Description 





PrintStream.write (int) 





PrintStream.write (byte[]) 





PrintStream.write (byte[], int, int) 











See Also 
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PrintStream.write Method (Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
int b); 


Parameters 


b 


See Also 

Reference 
PrintStream Class 
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PrintStream.write Method (SByte[], Int32, Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
byte[] b, 
int off, 
int len); 


Parameters 


b 


off 
len 


See Also 

Reference 
PrintStream Class 
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PrintStream Members 
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PrintWriter Class 


Provides an implementation of the abstract Writer class specific to printing various primitive types and other objects to an 
underlying output stream. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.PrintWriter 
extends java.io.Writer 


Example 


The following example demonstrates the checkError, close, flush, and printin methods of the PrintWriter class. 


// printwriter_overview.jsl 


import java.io.*; 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Create a new instance of a PrintWriter object along with 
// an underlying StringWriter object. 
StringWriter stringWriter = new StringWriter(); 
PrintwWriter printwWriter = new PrintWriter(stringwWriter) ; 


// Print some random data to the StringWriter. 
Date date = new Date(); 
Random rand = new Random(date.getTime()); 


printwriter.println(rand.nextInt()); 
printwriter.println(rand.nextLong()); 
printwriter.println(rand.nextFloat()); 
printwWriter.println(rand.nextDouble()); 


// Flush the buffer. 
printWriter.flush(); 


// Display the contents of the StringWriter. 
if (!printWriter.checkError()) 


{ 
} 


System.out.println(stringWriter.getBuffer()); 


// Close the PrintWriter and String Writer objects. 
stringWriter.close(); 
printwWriter.close(); 


} 


/* 

Output: 

919498402 
6438634853843200856 
@. 220032334 
@.07553678009202236 
*/ 


Inheritance Hierarchy 


java.lang.Object 
java.io.Writer 
java.io.PrintWriter 


See Also 

Concepts 

PrintWriter Members 
java.io Package 
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PrintWriter Members 


Provides an implementation of the abstract Writer class specific to printing various primitive types and other objects to an 
underlying output stream. 


The following tables list the members exposed by the PrintWriter type. 


Public Constructors 





PrintWriter Overloaded. Initializes a new instance of a PrintWriter object. 


Public Fields 
Name __ |Description 








lock The object used to synchronize operations on the writer.(inherited from Writer) 











Public Methods 





Name Description 





checkError |Determines whether there were any errors or exceptions when printing to the underlying output stream. 





close Overridden. Closes the underlying output stream and releases all internal buffers. 





equals (inherited from Object ) 





flush Overridden. Flushes the underlying output stream. 





hashCode _|(inherited from Object ) 





getClass (inherited from Object ) 











clone Creates a shallow copy of this reader. (inherited from Writer) 
print Overloaded. Prints various types to the underlying output stream. 
printin Overloaded. Prints various types to the underlying output stream, followed by a newline character. 





setError —_|Sets a value indicating that an error or exception has occurred. 





toString —_|Displays a human readable representation of a Writer object. (inherited from Writer) 





write Overloaded. Overridden. Writes the next character or characters to the underlying output stream. 














Protected Methods 
Name Description 





finalize (inherited from Object ) 














See Also 
Reference 
PrintWriter Class 
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PrintWriter Fields 


Public Fields 





Name |Description 





lock The object used to synchronize operations on the writer. (inherited from Writer ) 














See Also 
Reference 
PrintWriter Class 
Concepts 

java.io Package 


Visual J# Reference 


PrintWriter Constructor 


Initializes a new instance of a PrintWriter object. 


Overload List 
Name 


PrintWriter (OutputStream) 


Description 


Initializes a new instance of a PrintWriter object using the given OutputStream as the und 
erlying stream to print to. 





PrintWriter (Writer) 


PrintWriter (OutputStream, boolean) 


Initializes a new instance of a PrintWriter object using the given Writer as the underlying 
stream to print to. 


Initializes a new instance of a PrintWriter object using the given OutputStream as the und 
erlying stream to print to. You can also specify whether the stream should be automatical 
ly flushed when printed to. 





PrintWriter (Writer, boolean) 








Initializes a new instance of a PrintWriter object using the given Writer as the underlying 
stream to print to. You can also specify whether the stream should be automatically flush 
ed when printed to. 





See Also 

Reference 
PrintWriter Class 
Concepts 

PrintWriter Members 
java.io Package 
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PrintWriter Constructor (OutputStream) 


Initializes a new instance of a PrintWriter object using the given OutputStream as the underlying stream to print to. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.Printwriter( 
java.io.OutputStream out); 


Parameters 
out 


The underlying output stream to print to. 


See Also 

Reference 
PrintWriter Class 
Concepts 

PrintWriter Members 
java.io Package 
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PrintWriter Constructor (Writer) 


Initializes a new instance of a PrintWriter object using the given Writer as the underlying stream to print to. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.Printwriter( 
java.io.Writer out); 


Parameters 
out 


The underlying output stream to print to. 


See Also 

Reference 
PrintWriter Class 
Concepts 

PrintWriter Members 
java.io Package 
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PrintWriter Constructor (OutputStream, Boolean) 


Initializes a new instance of a PrintWriter object using the given OutputStream as the underlying stream to print to. You can 
also specify whether the stream should be automatically flushed when printed to. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.PrintwWriter( 
java.io.OutputStream out, 
boolean autoflush) ; 


Parameters 
out 


The underlying output stream to print to. 
autoflush 
A value indicating whether the stream should be automatically flushed when it is written to. 


See Also 

Reference 
PrintWriter Class 
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PrintWriter Members 
java.io Package 
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PrintWriter Constructor (Writer, Boolean) 


Initializes a new instance of a PrintWriter object using the given Writer as the underlying stream to print to. You can also 
specify whether the stream should be automatically flushed when printed to. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.Printwriter( 
java.io.Writer out, 
boolean autoflush) ; 


Parameters 
out 


The underlying output stream to print to. 
autoflush 
A value indicating whether the stream should be automatically flushed when it is written to. 


See Also 

Reference 
PrintWriter Class 
Concepts 

PrintWriter Members 
java.io Package 
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PrintWriter Methods 


Public Methods 






































Name Description 

checkError |Determines whether there were any errors or exceptions when printing to the underlying output stream. 
close Overridden. Closes the underlying output stream and releases all internal buffers. 

equals (inherited from Object ) 

flush Overridden. Flushes the underlying output stream. 

hashCode _|(inherited from Object ) 

getClass (inherited from Object ) 

clone Creates a shallow copy of this reader. (inherited from Writer ) 

print Overloaded. Prints various types to the underlying output stream. 

println Overloaded. Prints various types to the underlying output stream, followed by a newline character. 
setError [Sets a value indicating that an error or exception has occurred. 

toString —_|Displays a human readable representation of a Writer object. (inherited from Writer ) 

write Overloaded. Overridden. Writes the next character or characters to the underlying output stream. 
Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 
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PrintWriter.checkError Method 


Determines whether there were any errors or exceptions when printing to the underlying output stream. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean checkError(); 


Return Value 


true if there were any errors or exceptions when printing to the underlying output stream; false otherwise. 


Example 


The following example demonstrates how to call checkError to verify that the PrintWriter object successfully printed to the 


underlying output stream. 


// printwriter_checkerror.jsl 


import java.io.*; 
import java.util.*; 


public class Program 


{ 


public static void main(String[] args) 


} 
/* 


Output: 


// Create a new instance of a PrintWriter object along with 


// an underlying StringWriter object. 
StringWriter stringWriter = new StringWriter(); 


PrintwWriter printwWriter = new PrintWriter(stringwWriter) ; 


// Print some random data to the StringWriter. 
Date date = new Date(); 
Random rand = new Random(date.getTime()); 


printwriter.println(rand.nextInt()); 
printwWriter.println(rand.nextLong()); 
printwWriter.println(rand.nextFloat()); 
printwWriter.println(rand.nextDouble()); 


// Display the contents of the StringWriter. 
if (!printWriter.checkError()) 
{ 


i 


System.out.printin(stringWriter.getBuffer()); 


// Close the PrintWriter and String Writer objects. 
stringWriter.close(); 
printwriter.close(); 


1783513883 
4369932518214174912 
@.4472599 
@.41234255408466969 


*/ 


See Also 
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PrintWriter.close Method 


Closes the underlying output stream and releases all internal buffers. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void close(); 


Example 
The following example demonstrates how to close a PrintWriter object once you have written to the underlying output stream. 
// printwriter_close.jsl 


import java.io.*; 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
// Create a new instance of a PrintWriter object along with 
// an underlying StringWriter object. 
StringWriter stringWriter = new StringWriter(); 
Printwriter printwWriter = new PrintWriter(stringwWriter) ; 
// Print some random data to the StringWriter. 
Date date = new Date(); 
Random rand = new Random(date.getTime()); 
printwriter.println(rand.nextInt()); 
printwWriter.println(rand.nextLong()); 
printwWriter.println(rand.nextFloat()); 
printwriter.println(rand.nextDouble()); 
// Display the contents of the StringWriter. 
if (!printWriter.checkError()) 
{ 
System. out.println(stringWriter.getBuffer()); 
} 
// Close the PrintWriter and String Writer objects. 
stringWriter.close(); 
printwriter.close(); 
} 
} 
/* 
Output: 
1067437389 
5375348907260604722 
@.3197248 
@.92409548626073634 
ei 
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PrintWriter.flush Method 


Flushes the underlying output stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void flush(); 


Example 


The following example demonstrates how to flush the contents of a PrintWriter object to the underlying output stream. 


// printwriter_flush.jsl 


import java.io.*; 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Create a new instance of a PrintWriter object along with 
// an underlying StringWriter object. 
StringWriter stringWriter = new StringWriter(); 
Printwriter printwWriter = new PrintWriter(stringwWriter) ; 


// Print some random data to the StringWriter. 
Date date = new Date(); 
Random rand = new Random(date.getTime()); 


printwriter.println(rand.nextInt()); 
printwWriter.println(rand.nextLong()); 
printwWriter.println(rand.nextFloat()); 
printwWriter.println(rand.nextDouble()); 


// Flush the buffer. 
printWriter.flush(); 


// Display the contents of the StringWriter. 
if (!printWriter.checkError()) 
{ 


} 


System.out.println(stringWriter.getBuffer()); 


// Close the PrintWriter and String Writer objects. 
stringWriter.close(); 
printwriter.close(); 


} 


/* 

Output: 

-1795952035 
-7904475002891073741 
@.8822727 
@.74217617902306976 
*/ 


See Also 
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PrintWriter.print Method 


Prints various types to the underlying output stream. 


Overload List 
Name 


PrintWriter.print (boolean) 


PrintWriter.print (char) 


PrintWriter.print (char[]) 


PrintWriter.print (double) 


Description 


Prints a boolean value to the underlying output stream. 


Prints a character to the underlying output stream. 


Prints an array of characters to the underlying output stream. 


Prints a double value to the underlying output stream. 





PrintWriter.print (int) 


Prints an integer value to the underlying output stream. 





PrintWriter.print (long) 


Prints a long value to the underlying output stream. 





PrintWriter.print (Object) 


Prints an object to the underlying output stream. 





PrintWriter.print (float) 


Prints a float value to the underlying output stream. 





PrintWriter.print (String) 








Prints a String to the underlying output stream. 





See Also 
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PrintWriter.print Method (Boolean) 


Prints a boolean value to the underlying output stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void print( 
boolean b); 


Parameters 


b 
The boolean value to be printed. 
Example 


The following example demonstrates how to print random boolean values to a StringWriter buffer. 


// printwriter_print_boolean.jsl 


import java.io.*; 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Create a new instance of a PrintWriter object along with 
// an underlying StringWriter object. 
StringWriter stringWriter = new StringWriter(); 
PrintwWriter printwWriter = new PrintwWriter(stringwWriter) ; 


// Print some random data to the StringWriter. 
Date date = new Date(); 
Random rand = new Random(date.getTime()); 


for (int i = @; i < 10; i++) 

{ 
printwWriter.print(rand.nextBoolean()); 
printwriter.println(); 


} 


// Flush the buffer. 
printWriter.flush(); 


// Display the contents of the StringWriter. 
if (!printWriter.checkError()) 


System.out.println(stringWriter.getBuffer()); 
} 


// Close the PrintWriter and String Writer objects. 
stringWriter.close(); 
printwriter.close(); 


} 


/* 
Output: 
false 
true 
true 
false 


false 
true 
true 
true 
false 
false 
* 
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PrintWriter.print Method (Char) 


Prints a character to the underlying output stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void print( 
char c); 


Parameters 
Cc 


The character to be printed. 
Example 


The following example demonstrates how to print random char values to a StringWriter buffer. 


// printwriter_print_char.jsl 


import java.io.*; 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Create a new instance of a PrintWriter object along with 
// an underlying StringWriter object. 
StringWriter stringWriter = new StringWriter(); 
PrintwWriter printwWriter = new PrintwWriter(stringwWriter) ; 


// Print some random data to the StringWriter. 
Date date = new Date(); 
Random rand = new Random(date.getTime()); 


// Characters are between 32 and 126 (ASCII). 
for (int i = @; i < 10; i++) 
{ 

int randInt = @; 

while (randInt < 32) 


{ 
} 


randiInt = rand.nextInt(126); 


printwriter.print((char)randInt) ; 
printwWriter.println(); 


} 


// Flush the buffer. 
printWriter.flush(); 


// Display the contents of the StringWriter. 
if (!printWriter.checkError()) 


{ 
} 


System.out.println(stringWriter.getBuffer()); 


// Close the PrintWriter and String Writer objects. 
stringWriter.close(); 
printwriter.close(); 
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PrintWriter.print Method (Char, ]) 


Prints an array of characters to the underlying output stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void print( 
char[] charArray); 


Parameters 
charArray 


The array of characters to be printed. 
Example 


The following example demonstrates how to print a random array of char values to a StringWriter buffer. 


// printwriter_print_chararray.jsl 


import java.io.*; 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Create a new instance of a PrintWriter object along with 
// an underlying StringWriter object. 
StringWriter stringWriter = new StringWriter(); 
PrintwWriter printwWriter = new PrintwWriter(stringwWriter) ; 


// Print some random data to the StringWriter. 
Date date = new Date(); 
Random rand = new Random(date.getTime()); 


// Characters are between 32 and 126 (ASCII). 
char[] arr = new char[10]; 
for (int i = 03; i < 10; i++) 
{ 
int randInt = @; 
while (randInt < 32) 
{ 


} 


randiInt = rand.nextInt(126); 


arr[i] = (char)randInt; 
printwriter.print(arr); 


// Flush the buffer. 
printWriter.flush(); 


// Display the contents of the StringWriter. 
if (!printWriter.checkError()) 


System.out.println(stringWriter.getBuffer()); 
} 


// Close the PrintWriter and String Writer objects. 
stringWriter.close(); 
printwriter.close(); 


} 


/* 

Output: 
&gVHAN! x-* 
*/ 
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PrintWriter.print Method (Double) 


Prints a double value to the underlying output stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void print( 
double d); 


Parameters 


d 
The double value to be printed. 
Example 


The following example demonstrates how to print random double values to a StringWriter buffer. 


// printwriter_print_double.jsl 


import java.io.*; 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Create a new instance of a PrintWriter object along with 
// an underlying StringWriter object. 
StringWriter stringWriter = new StringWriter(); 
PrintwWriter printwWriter = new PrintwWriter(stringwWriter) ; 


// Print some random data to the StringWriter. 
Date date = new Date(); 
Random rand = new Random(date.getTime()); 


for (int i = @; i < 10; i++) 

{ 
printwriter.print(rand.nextDouble()); 
printwWriter.println(); 

} 


// Flush the buffer. 
printWriter.flush(); 


// Display the contents of the StringWriter. 
if (!printWriter.checkError()) 


{ 
} 


System.out.println(stringWriter.getBuffer()); 


// Close the PrintWriter and String Writer objects. 
stringWriter.close(); 
printwriter.close(); 


} 


/* 

Output: 
@.22111552345988439 
@.71412270820949275 
@.46749730473515727 
@.40253875268354533 


-45325243734855214 
.12178138237062242 
.33311483948047493 
-232486424424311 
-73214155747650689 
-2730524545489158 


¥OTDODDVWDAUNOO 
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PrintWriter.print Method (Int32) 


Prints an integer value to the underlying output stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void print( 
int i); 


Parameters 
l 
The integer value to be printed. 


Example 


The following example demonstrates how to print random int values to a StringWriter buffer. 


// printwriter_print_int.jsl 


import java.io.*; 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
// Create a new instance of a PrintWriter object along with 
// an underlying StringWriter object. 
StringWriter stringWriter = new StringWriter(); 
PrintWriter printwWriter = new PrintWriter(stringwWriter) ; 
// Print some random data to the StringWriter. 
Date date = new Date(); 
Random rand = new Random(date.getTime()); 
for (int i = @; i < 10; i++) 
{ 
printwriter.print(rand.nextInt()); 
printwriter.println(); 
} 
// Flush the buffer. 
printwriter.flush(); 
// Display the contents of the StringWriter. 
if (!printWriter.checkError()) 
{ 
System.out.println(stringWriter.getBuffer()); 
} 
// Close the PrintWriter and String Writer objects. 
stringWriter.close(); 
printwriter.close(); 
} 
} 
/* 
Output: 
1179473779 
-1493859189 
-1258719222 


947110265 


-1678818902 
- 138830361 
905713311 
-1925380613 
466622335 
621473841 
*/ 
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PrintWriter.print Method (Int64) 


Prints a long value to the underlying output stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void print( 
long 1); 


Parameters 
l 
The long value to be printed. 


Example 


The following example demonstrates how to print random long values to a StringWriter buffer. 


// printwriter_print_long.jsl 


import java.io.*; 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
// Create a new instance of a PrintWriter object along with 
// an underlying StringWriter object. 
StringWriter stringWriter = new StringWriter(); 
PrintwWriter printwWriter = new PrintwWriter(stringwWriter) ; 
// Print some random data to the StringWriter. 
Date date = new Date(); 
Random rand = new Random(date.getTime()); 
for (int i = @; i < 10; i++) 
{ 
printwWriter.print(rand.nextLong()); 
printwriter.println(); 
} 
// Flush the buffer. 
printwriter.flush(); 
// Display the contents of the StringWriter. 
if (!printWriter.checkError()) 
{ 
System.out.println(stringWriter.getBuffer()); 
} 
// Close the PrintWriter and String Writer objects. 
stringWriter.close(); 
printwriter.close(); 
} 
} 
/* 
Output: 
3786335069141929567 
4160774848858038463 
-1003712314565441972 


6871459982539519638 


8405481078492958439 
-3542697386318197532 
4465413492605614828 
-2279875300762862514 
-9041062491321340712 
-2477215260312440059 
ae 
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PrintWriter.print Method (Object) 


Prints an object to the underlying output stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void print( 
java.lang.Object 0); 


Parameters 
oO 


The object to be printed 
Example 


The following example demonstrates how to print random Integer objects to a StringWriter buffer. 


// printwriter_print_object.jsl 


import java.io.*; 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Create a new instance of a PrintWriter object along with 
// an underlying StringWriter object. 
StringWriter stringWriter = new StringWriter(); 
PrintwWriter printwWriter = new PrintwWriter(stringwWriter) ; 


// Print some random data to the StringWriter. 
Date date = new Date(); 
Random rand = new Random(date.getTime()); 


int randInt; 

for (int i = 0; i < 10; i++) 

{ 
randiInt = rand.nextInt(); 
printwriter.print(new Integer(randInt) ); 
printwriter.println(); 


// Flush the buffer. 
printWriter.flush(); 


// Display the contents of the StringWriter. 
if (!printWriter.checkError()) 


i 
} 


System.out.println(stringWriter.getBuffer()); 


// Close the PrintWriter and String Writer objects. 
stringWriter.close(); 
printwriter.close(); 


} 


/* 

Output: 
781902959 
1843952855 


-1116756940 
285737205 
473450785 
117169121 
-760428226 
-1975219998 
1253373131 
930932395 

* 











Remarks 
The string printed is the same text that would be displayed if 0.toString(); were called. 
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PrintWriter.print Method (Single) 


Prints a float value to the underlying output stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void print( 
float f); 


Parameters 


f 


The float value to be printed. 
Example 
The following example demonstrates how to print random float values to a StringWriter buffer. 
// printwriter_print_float.jsl 


import java.io.*; 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
// Create a new instance of a PrintWriter object along with 
// an underlying StringWriter object. 
StringWriter stringWriter = new StringWriter(); 
PrintwWriter printwWriter = new PrintwWriter(stringwWriter) ; 
// Print some random data to the StringWriter. 
Date date = new Date(); 
Random rand = new Random(date.getTime()); 
for (int i = @; i < 10; i++) 
{ 
printwWriter.print(rand.nextFloat()); 
printwriter.println(); 
} 
// Flush the buffer. 
printwriter.flush(); 
// Display the contents of the StringWriter. 
if (!printWriter.checkError()) 
{ 
System.out.println(stringWriter.getBuffer()); 
} 
// Close the PrintWriter and String Writer objects. 
stringWriter.close(); 
printwriter.close(); 
} 
} 
/* 
Output: 
8.444933 
@.1618141 


@.0215989351 
@.118006468 


- 75749886 
- 262105 
- 787075 
-9051153 
-463990152 
588330448 


¥OODDVVWAVOO 
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PrintWriter.print Method (String) 


Prints a String to the underlying output stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void print( 
java.lang.String str); 


Parameters 
str 


The string to be printed. 
Example 


The following example demonstrates how to print a string of random characters to a StringWriter buffer. 


// printwriter_print_string.jsl 


import java.io.*; 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Create a new instance of a PrintWriter object along with 
// an underlying StringWriter object. 
StringWriter stringWriter = new StringWriter(); 
PrintWriter printwWriter = new PrintWriter(stringwWriter) ; 


// Print some random data to the StringWriter. 
Date date = new Date(); 
Random rand = new Random(date.getTime()); 


// Characters are between 32 and 126 (ASCII). 
char[] arr = new char[10]; 
for (int i = 03; i < 10; i++) 
{ 
int randInt = @; 
while (randInt < 32) 
{ 


} 


randiInt = rand.nextInt(126); 


arr[i] = (char)randInt; 
printwWriter.print(new String(arr)); 


// Flush the buffer. 
printWriter.flush(); 


// Display the contents of the StringWriter. 
if (!printWriter.checkError()) 


System.out.println(stringWriter.getBuffer()); 
} 


// Close the PrintWriter and String Writer objects. 
stringWriter.close(); 
printwriter.close(); 


} 


/* 

Output: 
OHON5EC2Cb 
*/ 
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PrintWriter.printin Method 


Prints various types to the underlying output stream, followed by a newline character. 


Overload List 
Name 


PrintWriter.printin () 


PrintWriter.printin (boolean) 


PrintWriter.println (char) 


PrintWriter.printin (char[]) 


Description 


Prints a newline character to the underlying output stream. 


Prints a boolean value to the underlying output stream, followed by a newline character. 


Prints a character to the underlying output stream, followed by a newline character. 


Prints an array of characters to the underlying output stream, followed by a newline character. 





PrintWriter.printlIn (double) 


Prints a double value to the underlying output stream, followed by a newline character. 





PrintWriter.printin (int) 


Prints an integer to the underlying output stream, followed by a newline character. 





PrintWriter.printin (long) 


Prints a long value to the underlying output stream, followed by a newline character. 





PrintWriter.printIn (Object) 


Prints an object to the underlying output stream, followed by a newline character. 





PrintWriter.println (float) 


Prints a float value to the underlying output stream, followed by a newline character. 





PrintWriter.printin (String) 








Prints a String to the underlying output stream, followed by a newline character. 
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PrintWriter.printin Method () 


Prints a newline character to the underlying output stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void println(); 


Example 


The following example demonstrates how to print a newline character to a StringWriter buffer. 


// printwriter_println.jsl 


import java.io.*; 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Create a new instance of a PrintWriter object along with 
// an underlying StringWriter object. 
StringWriter stringWriter = new StringWriter(); 
Printwriter printwWriter = new PrintWriter(stringwWriter) ; 


// Print some random data to the StringWriter. 
Date date = new Date(); 
Random rand = new Random(date.getTime()); 


for (int i = @; i < 10; i++) 


{ 
printwWriter.print(rand.nextInt()); 


printwriter.println(); 
} 


// Flush the buffer. 
printWriter.flush(); 


// Display the contents of the StringWriter. 
if (!printWriter.checkError()) 


{ 
} 


System.out.println(stringWriter.getBuffer() ); 


// Close the PrintWriter and String Writer objects. 
stringWriter.close(); 
printwriter.close(); 


} 


/* 

Output: 
189228037 
1655213393 
1748306950 
-1530658345 
- 865426539 
-618026644 
-1537214592 
1504546217 
310250331 


- 839698328 
*/ 


See Also 
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PrintWriter.printin Method (Boolean) 


Prints a boolean value to the underlying output stream, followed by a newline character. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void println( 
boolean b); 


Parameters 


b 
The boolean value to be printed. 
Example 


The following example demonstrates how to print random boolean values to a StringWriter buffer. 


// printwriter_print1ln_boolean.jsl 


import java.io.*; 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
// Create a new instance of a PrintWriter object along with 
// an underlying StringWriter object. 
StringWriter stringWriter = new StringWriter(); 
PrintwWriter printwWriter = new PrintwWriter(stringwWriter) ; 
// Print some random data to the StringWriter. 
Date date = new Date(); 
Random rand = new Random(date.getTime()); 
for (int i = @; i < 10; i++) 
{ 
printwWriter.println(rand.nextBoolean()); 
} 
// Flush the buffer. 
printwriter.flush(); 
// Display the contents of the StringWriter. 
if (!printWriter.checkError()) 
System.out.println(stringWriter.getBuffer()); 
} 
// Close the PrintWriter and String Writer objects. 
stringWriter.close(); 
printwriter.close(); 
} 
} 
/* 
Output: 
true 
true 
true 
false 


false 
true 
false 
true 
true 


*/ 
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PrintWriter.printin Method (Char) 


Prints a character to the underlying output stream, followed by a newline character. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void println( 
char c); 


Parameters 
Cc 


The character to be printed. 
Example 


The following example demonstrates how to print random char values to a StringWriter buffer. 


// printwriter_println_char.jsl 


import java.io.*; 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Create a new instance of a PrintWriter object along with 
// an underlying StringWriter object. 
StringWriter stringWriter = new StringWriter(); 
PrintwWriter printwWriter = new PrintwWriter(stringwWriter) ; 


// Print some random data to the StringWriter. 
Date date = new Date(); 
Random rand = new Random(date.getTime()); 


// Characters are between 32 and 126 (ASCII). 
for (int i = @; i < 10; i++) 
{ 

int randInt = @; 

while (randInt < 32) 


{ 
} 


randiInt = rand.nextInt(126); 


printwriter.println((char)randInt) ; 
} 


// Flush the buffer. 
printWriter.flush(); 


// Display the contents of the StringWriter. 
if (!printWriter.checkError()) 
{ 


} 


System.out.println(stringWriter.getBuffer()); 


// Close the PrintWriter and String Writer objects. 
stringWriter.close(); 
printwriter.close(); 


/* 
Output: 


*¥OTMI rPWUMwWBN 
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PrintWriter.printiIn Method (CharT ]) 


Prints an array of characters to the underlying output stream, followed by a newline character. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void println( 
char[] arry); 


Parameters 
arry 


The array of characters to be printed. 
Example 


The following example demonstrates how to print an array of random char values to a StringWriter buffer. 


// printwriter_println_chararray.jsl 


import java.io.*; 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Create a new instance of a PrintWriter object along with 
// an underlying StringWriter object. 
StringWriter stringWriter = new StringWriter(); 
PrintwWriter printwWriter = new PrintwWriter(stringwWriter) ; 


// Print some random data to the StringWriter. 
Date date = new Date(); 
Random rand = new Random(date.getTime()); 


// Characters are between 32 and 126 (ASCII). 
char[] arr = new char[10]; 
for (int i = 03; i < 10; i++) 
{ 
int randInt = @; 
while (randInt < 32) 
{ 


} 


randiInt = rand.nextInt(126); 


arr[i] = (char)randInt; 
printwWriter.println(arr); 


// Flush the buffer. 
printWriter.flush(); 


// Display the contents of the StringWriter. 
if (!printWriter.checkError()) 


System.out.println(stringWriter.getBuffer()); 
} 


// Close the PrintWriter and String Writer objects. 
stringWriter.close(); 
printwriter.close(); 


} 


/* 

Output: 
oU#/10V?F3 
*/ 
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PrintWriter.printin Method (Double) 


Prints a double value to the underlying output stream, followed by a newline character. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void println( 
double d); 


Parameters 
d 
The double value to be printed. 


Example 


The following example demonstrates how to print random double values to a StringWriter buffer. 


// printwriter_println_double.jsl 


import java.io.*; 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
// Create a new instance of a PrintWriter object along with 
// an underlying StringWriter object. 
StringWriter stringWriter = new StringWriter(); 
PrintwWriter printwWriter = new PrintwWriter(stringwWriter) ; 
// Print some random data to the StringWriter. 
Date date = new Date(); 
Random rand = new Random(date.getTime()); 
for (int i = @; i < 10; i++) 
{ 
printwWriter.println(rand.nextDouble()); 
} 
// Flush the buffer. 
printwriter.flush(); 
// Display the contents of the StringWriter. 
if (!printWriter.checkError()) 
{ 
System.out.println(stringWriter.getBuffer()); 
} 
// Close the PrintWriter and String Writer objects. 
stringWriter.close(); 
printwriter.close(); 
} 
} 
/* 
Output: 


@.049098646526183121 
8.57835846075847608 
@.63727950028611535 
@.25283226632606604 
@.13250715455371021 


@.76372010810678892 
@.32138054288587736 
@.27010703232034505 
@.066136358456775679 
@.46604961123715993 
*/ 
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PrintWriter.printiIn Method (Int32) 


Prints an integer to the underlying output stream, followed by a newline character. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void println( 
int i); 


Parameters 
l 
The integer to be printed. 


Example 


The following example demonstrates how to print random int values to a StringWriter buffer. 


// printwriter_println_int.jsl 


import java.io.*; 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
// Create a new instance of a PrintWriter object along with 
// an underlying StringWriter object. 
StringWriter stringWriter = new StringWriter(); 
PrintwWriter printwWriter = new PrintwWriter(stringwWriter) ; 
// Print some random data to the StringWriter. 
Date date = new Date(); 
Random rand = new Random(date.getTime()); 
for (int i = @; i < 10; i++) 
{ 
printwriter.println(rand.nextInt()); 
} 
// Flush the buffer. 
printwriter.flush(); 
// Display the contents of the StringWriter. 
if (!printWriter.checkError()) 
{ 
System.out.println(stringWriter.getBuffer()); 
} 
// Close the PrintWriter and String Writer objects. 
stringWriter.close(); 
printwriter.close(); 
} 
} 
/* 
Output: 
630611556 
227991716 
1481528284 
-322415982 


-80496314 


1929473776 
-1168890856 
1621578169 
- 1915263323 
-1987968255 
ay 
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PrintWriter.printiIn Method (Int64) 


Prints a long value to the underlying output stream, followed by a newline character. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void println( 
long 1); 


Parameters 
l 

The long value to be printed. 
Example 


The following example demonstrates how to print random long values to a StringWriter buffer. 


// printwriter_println_long.jsl 


import java.io.*; 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
// Create a new instance of a PrintWriter object along with 
// an underlying StringWriter object. 
StringWriter stringWriter = new StringWriter(); 
PrintwWriter printwWriter = new PrintwWriter(stringwWriter) ; 
// Print some random data to the StringWriter. 
Date date = new Date(); 
Random rand = new Random(date.getTime()); 
for (int i = @; i < 10; i++) 
{ 
printwWriter.println(rand.nextLong()); 
} 
// Flush the buffer. 
printwriter.flush(); 
// Display the contents of the StringWriter. 
if (!printWriter.checkError()) 
{ 
System.out.println(stringWriter.getBuffer()); 
} 
// Close the PrintWriter and String Writer objects. 
stringWriter.close(); 
printwriter.close(); 
} 
} 
/* 
Output: 
2359469369572711718 
-1752854823586231308 
8313904213493496961 
7062038769965299808 


-1559504970770141700 


1772345519805857303 
919825676985800467 
8064098131269998983 
-8867870457877401800 
8053236360516612856 
*/ 
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PrintWriter.printin Method (Object) 


Prints an object to the underlying output stream, followed by a newline character. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void printlin( 
java.lang.Object o); 


Parameters 
oO 


The object to be printed 
Example 


The following example demonstrates how to print random Integer objects to a StringWriter buffer. 


// printwriter_println_object.jsl 


import java.io.*; 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Create a new instance of a PrintWriter object along with 
// an underlying StringWriter object. 
StringWriter stringWriter = new StringWriter(); 
PrintwWriter printwWriter = new PrintwWriter(stringwWriter) ; 


// Print some random data to the StringWriter. 
Date date = new Date(); 
Random rand = new Random(date.getTime()); 


int randInt; 

for (int i = @; i < 10; i++) 

{ 
randiInt = rand.nextInt(); 
printwWriter.println(new Integer(randInt) ); 


} 


// Flush the buffer. 
printWriter.flush(); 


// Display the contents of the StringWriter. 
if (!printWriter.checkError()) 


System.out.println(stringWriter.getBuffer() ); 


// Close the PrintWriter and String Writer objects. 
stringWriter.close(); 
printwriter.close(); 


} 


/* 

Output: 
-543431831 
-950659014 
-779293546 


502965373 
-341640195 
-1880187005 
1402244877 
- 1245040133 
-874112932 
734881471 
*/ 





Remarks 
The string printed is the same text that would be displayed if 0.toString(); were called. 
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PrintWriter.printin Method (Single) 


Prints a float value to the underlying output stream, followed by a newline character. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void println( 
float f); 


Parameters 


f 


The float value to be printed. 
Example 
The following example demonstrates how to print random float values to a StringWriter buffer. 
// printwriter_println_float.jsl 


import java.io.*; 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
// Create a new instance of a PrintWriter object along with 
// an underlying StringWriter object. 
StringWriter stringWriter = new StringWriter(); 
PrintwWriter printwWriter = new PrintwWriter(stringwWriter) ; 
// Print some random data to the StringWriter. 
Date date = new Date(); 
Random rand = new Random(date.getTime()); 
for (int i = @; i < 10; i++) 
{ 
printwriter.println(rand.nextFloat()); 
} 
// Flush the buffer. 
printwriter.flush(); 
// Display the contents of the StringWriter. 
if (!printWriter.checkError()) 
{ 
System.out.println(stringWriter.getBuffer()); 
} 
// Close the PrintWriter and String Writer objects. 
stringWriter.close(); 
printwriter.close(); 
} 
} 
/* 
Output: 
@.3931421 
@.21162647 
0@.6578447 
@.6726297 


8.8801815 


@.1248005 
@.0174156427 
@.554498732 
8.1375094 
@.5722707 

*/ 
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PrintWriter.printin Method (String) 


Prints a String to the underlying output stream, followed by a newline character. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void printin( 
java.lang.String s); 


Parameters 
Ss 


The string to be printed. 
Example 


The following example demonstrates how to print a string of random characters to a StringWriter buffer. 


// printwriter_println_string.jsl 


import java.io.*; 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Create a new instance of a PrintWriter object along with 
// an underlying StringWriter object. 
StringWriter stringWriter = new StringWriter(); 
PrintwWriter printwWriter = new PrintwWriter(stringwWriter) ; 


// Print some random data to the StringWriter. 
Date date = new Date(); 
Random rand = new Random(date.getTime()); 


// Characters are between 32 and 126 (ASCII). 
char[] arr = new char[10]; 
for (int i = 03; i < 10; i++) 
{ 
int randInt = @; 
while (randInt < 32) 
{ 


} 


randiInt = rand.nextInt(126); 


arr[i] = (char)randInt; 
printwWriter.println(new String(arr)); 


// Flush the buffer. 
printWriter.flush(); 


// Display the contents of the StringWriter. 
if (!printWriter.checkError()) 


System.out.println(stringWriter.getBuffer()); 
} 


// Close the PrintWriter and String Writer objects. 
stringWriter.close(); 
printwriter.close(); 


} 


/* 

Output: 
H.u91t5e&, 
*/ 





See Also 

Reference 
PrintWriter Class 
Concepts 

PrintWriter Members 
java.io Package 
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PrintWriter.setError Method 


Sets a value indicating that an error or exception has occurred. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected void setError(); 


See Also 

Reference 
PrintWriter Class 
Concepts 

PrintWriter Members 
java.io Package 


Visual J# Reference 


PrintWriter.write Method 


Writes the next character or characters to the underlying output stream. 


Overload List 


Name Description 

PrintWriter.write (char[]) Writes the characters in the provided buffer to the underlying output stream. 
PrintWriter.write (int) Writes the next character to the underlying output stream. 

PrintWriter.write (String) Writes the provided String to the underlying output stream. 


PrintWriter.write (char{], int, int) |\Writes len characters from the provided buffer, starting at an offset, to the underlying output 
stream. 


PrintWriter.write (String, int, int)|Writes len characters from the provided string, starting at an offset, to the underlying output s 
tream. 











See Also 

Reference 
PrintWriter Class 
Concepts 

PrintWriter Members 
java.io Package 
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PrintWriter.write Method (Char ]) 


Writes the characters in the provided buffer to the underlying output stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
char[] b); 


Parameters 


b 
A buffer of characters to write to the underlying output stream. 
Example 


The following example demonstrates how to write an array of characters to the underlying output stream. 


// printwriter_write.jsl 


import java.io.*; 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Create a new instance of a PrintWriter object along with 
// an underlying StringWriter object. 
StringWriter stringWriter = new StringWriter(); 
PrintwWriter printwWriter = new PrintWriter(stringwWriter) ; 


// Print some random data to the StringWriter. 
Date date = new Date(); 
Random rand = new Random(date.getTime()); 


// Characters are between 32 and 126 (ASCII). 
char[] arr = new char[10]; 
for (int i = 0; i < 10; i++) 


{ 
int randInt = @; 
while (randInt < 32) 
{ 
randiInt = rand.nextInt(126); 
} 
arr[i] = (char)randInt; 
} 


printwWriter.write(arr); 


// Flush the buffer. 
printWriter.flush(); 


// Display the contents of the StringWriter. 
if (!printWriter.checkError()) 
{ 


} 


System.out.println(stringWriter.getBuffer()); 


// Close the PrintWriter and String Writer objects. 
stringWriter.close(); 
printwWriter.close(); 


} 


/* 

Output: 
W:0y6,%]Fg 
*/ 





See Also 

Reference 
PrintWriter Class 
Concepts 

PrintWriter Members 
java.io Package 
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PrintWriter.write Method (Int32) 


Writes the next character to the underlying output stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
int b); 


Parameters 


b 
The character to write to the underlying output stream. 
Example 


The following example demonstrates how to write a single character to the underlying output stream. 


// printwriter_write_2.jsl 


import java.io.*; 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Create a new instance of a PrintWriter object along with 
// an underlying StringWriter object. 
StringWriter stringWriter = new StringWriter(); 
PrintwWriter printwWriter = new PrintWriter(stringwWriter) ; 


// Print some random data to the StringWriter. 
Date date = new Date(); 
Random rand = new Random(date.getTime()); 


// Characters are between 32 and 126 (ASCII). 
for (int i = @; i < 10; i++) 
{ 

int randInt = @; 

while (randInt < 32) 


{ 
} 


randiInt = rand.nextInt(126); 


printwriter.write((char)randInt) ; 
printwriter.println(); 


} 


// Flush the buffer. 
printWriter.flush(); 


// Display the contents of the StringWriter. 
if (!printWriter.checkError()) 


{ 
} 


System.out.println(stringWriter.getBuffer()); 


// Close the PrintWriter and String Writer objects. 
stringWriter.close(); 
printwriter.close(); 





See Also 

Reference 
PrintWriter Class 
Concepts 

PrintWriter Members 
java.io Package 
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PrintWriter.write Method (String) 


Writes the provided String to the underlying output stream. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
java.lang.String str); 


Parameters 


str 


The string to write to the underlying output stream. 


Example 


The following example demonstrates how to write a string to the underlying output stream. 


// printwriter_write_3.jsl 


import java.io.*; 
import java.util.*; 


public class Program 


{ 


public static void main(String[] args) 


{ 


// Create a new instance of a PrintWriter object along with 
// an underlying StringWriter object. 

StringWriter stringWriter = new StringWriter(); 

PrintwWriter printwWriter = new PrintwWriter(stringwWriter) ; 


// Print some random data to the StringWriter. 
Date date = new Date(); 
Random rand = new Random(date.getTime()); 


// Characters are between 32 and 126 (ASCII). 
char[] arr = new char[10]; 
for (int i = 03; i < 10; i++) 


{ 
int randInt = @; 
while (randInt < 32) 
{ 
randiInt = rand.nextInt(126); 
} 
arr[i] = (char)randInt; 
} 


printwWriter.write(new String(arr)); 


// Flush the buffer. 
printWriter.flush(); 


// Display the contents of the StringWriter. 
if (!printWriter.checkError()) 
{ 


} 


System.out.println(stringWriter.getBuffer()); 


// Close the PrintWriter and String Writer objects. 
stringWriter.close(); 
printwriter.close(); 


} 


/* 

Output: 
]8$1XZsfpM 
*/ 
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PrintWriter.write Method (Char [ J, Int32, Int32) 


Writes len characters from the provided buffer, starting at an offset, to the underlying output stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
char[] b, 
int off, 
int len); 


Parameters 


b 


A buffer of characters to write to the underlying output stream. 


off 


An offset into the provided buffer. This value represents the index of the first character in the buffer to be read. This value 
must be greater than zero. 


len 


The number of characters to be read starting from the offset. This value plus the offset must be less than the overall length of 
the provided buffer. 


Example 


The following example demonstrates how to write an array of characters to the underlying output stream. 


// printwriter_write_4.jsl 


import java.io.*; 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
af 
// Create a new instance of a PrintWriter object along with 
// an underlying StringWriter object. 
StringWriter stringWriter = new StringWriter(); 
PrintwWriter printwWriter = new PrintWriter(stringwWriter) ; 


// Print some random data to the StringWriter. 
Date date = new Date(); 
Random rand = new Random(date.getTime()); 


// Characters are between 32 and 126 (ASCII). 
char[] arr = new char[10]; 
for (int i = @; i < 10; i++) 


{ 
int randInt = @; 
while (randInt < 32) 
uf 
randiInt = rand.nextInt(126); 
} 
arr[i] = (char)randInt; 
} 


printwWriter.write(arr, @, arr.length); 


// Flush the buffer. 


printwriter.flush(); 


// Display the contents of the StringWriter. 
if (!printWriter.checkError()) 


{ 
} 


System.out.println(stringWriter.getBuffer()); 


// Close the PrintWriter and String Writer objects. 
stringWriter.close(); 
printwriter.close(); 





See Also 
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java.io Package 
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PrintWriter.write Method (String, Int32, Int32) 


Writes len characters from the provided string, starting at an offset, to the underlying output stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
java.lang.String str, 
int off, 
int len); 


Parameters 
str 


A string to write to the underlying output stream. 


off 


An offset into the provided string. This value represents the index of the first character in the string to be read. This value 
must be greater than zero. 


len 


The number of characters to be read starting from the offset. This value plus the offset must be less than the overall length of 
the provided string. 


Example 


The following example demonstrates how to write a string to the underlying output stream. 


// printwriter_write_5.jsl 


import java.io.*; 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
af 
// Create a new instance of a PrintWriter object along with 
// an underlying StringWriter object. 
StringWriter stringWriter = new StringWriter(); 
PrintwWriter printwWriter = new PrintWriter(stringwWriter) ; 


// Print some random data to the StringWriter. 
Date date = new Date(); 
Random rand = new Random(date.getTime()); 


// Characters are between 32 and 126 (ASCII). 
char[] arr = new char[10]; 
for (int i = @; i < 10; i++) 


{ 
int randInt = @; 
while (randInt < 32) 
uf 
randiInt = rand.nextInt(126); 
} 
arr[i] = (char)randInt; 
} 


printwWriter.write(new String(arr), @, arr.length); 


// Flush the buffer. 


printwriter.flush(); 


// Display the contents of the StringWriter. 
if (!printWriter.checkError()) 


{ 
} 


System.out.println(stringWriter.getBuffer()); 


// Close the PrintWriter and String Writer objects. 
stringWriter.close(); 
printwriter.close(); 


i 


/* 

Output: 
2F6}LCHBSF 
| 
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PushbackInputStream Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.PushbackInputStream 
extends java.io.FilterInputStream 





Inheritance Hierarchy 
java.lang.Object 
java.io.InputStream 
java.io.FilterInputStream 
java.io.PushbackInputStream 


See Also 

Concepts 

PushbacklInputStream Members 
java.io Package 
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PushbackInputStream Members 


The following tables list the members exposed by the PushbackInputStream type. 


Public Constructors 
Name 


PushbacklnputStream 


Public Fields 

















Public Methods 


Name Description 
buf 
in (inherited from FilterlnputStream ) 





Name 


Description 









































Protected Methods 


available Overridden. 

close (inherited from FilterInputStream ) 
equals (inherited from Object ) 

hashCode (inherited from Object ) 

getClass (inherited from Object ) 

mark (inherited from FilterinputStream ) 
markSupported Overridden. 

clone (inherited from InputStream ) 
read Overloaded. Overridden. 

reset (inherited from FilterInputStream ) 
skip (inherited from FilterinputStream ) 
toString (inherited from InputStream ) 
unread Overloaded. 








Name 


Description 





finalize 








(inherited from Object ) 





See Also 
Reference 











PushbackInputStream Class 
Concepts 
java.io Package 
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PushbackInputStream Fields 


Public Fields 





Name Description 





buf 





in (inherited from FilterInputStream ) 





pos 











See Also 

Reference 
PushbackInputStream Class 
Concepts 

java.io Package 
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PushbackInputStream.buf Field 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 





protected byte[] buf; 





See Also 

Reference 
PushbacklInputStream Class 
Concepts 

PushbackInputStream Members 
java.io Package 
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PushbackInputStream.pos Field 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 





protected int pos; 





See Also 

Reference 
PushbacklInputStream Class 
Concepts 

PushbackInputStream Members 
java.io Package 
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PushbackIinputStream Constructor 


Overload List 





Name Description 





PushbackInputStream (InputStream) 





PushbackInputStream (InputStream, int) 











See Also 

Reference 
PushbackInputStream Class 
Concepts 

PushbackInputStream Members 
java.io Package 
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PushbackInputStream Constructor (InputStream) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.PushbackInputStream( 
java.io.InputStream in); 


Parameters 
in 


See Also 

Reference 
PushbackInputStream Class 
Concepts 

PushbacklnputStream Members 
java.io Package 
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PushbackInputStream Constructor (InputStream, Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.PushbackInputStream( 
java.io.InputStream in, 
int size); 


Parameters 
in 


size 


See Also 

Reference 
PushbacklnputStream Class 
Concepts 

PushbacklnputStream Members 
java.io Package 
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PushbackInputStream Methods 


Public Methods 






































Name Description 

available Overridden. 

close (inherited from FilterinputStream ) 
equals (inherited from Object ) 

hashCode (inherited from Object ) 

getClass (inherited from Object ) 

mark (inherited from FilterinputStream ) 
markSupported Overridden. 

clone (inherited from InputStream ) 

read Overloaded. Overridden. 

reset (inherited from FilteriInputStream ) 
skip (inherited from FilterinputStream ) 
toString (inherited from InputStream ) 
unread Overloaded. 

Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 


PushbacklInputStream Class 


Concepts 
java.io Package 
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PushbackInputStream.available Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int available() throws java.io. IOException; 


See Also 

Reference 
PushbacklInputStream Class 
Concepts 

PushbackInputStream Members 
java.io Package 
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PushbackInputStream.markSupported Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean markSupported(); 


See Also 

Reference 
PushbacklInputStream Class 
Concepts 

PushbackInputStream Members 
java.io Package 
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PushbackInputStream.read Method 


Overload List 





Name 


Description 





PushbackInputStream.read () 





PushbackInputStream.read (byte[]) 





PushbackInputStream.read (byte[], int, int) 











See Also 

Reference 
PushbackInputStream Class 
Concepts 

PushbacklInputStream Members 
java.io Package 
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PushbackinputStream.read Method () 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read() throws java.io. IOException; 


See Also 

Reference 
PushbacklInputStream Class 
Concepts 

PushbackInputStream Members 
java.io Package 
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PushbackInputStream.read Method (SByte[ ], Int32, Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read( 
byte[] b, 
int off, 
int len) throws java.io. IOException; 


Parameters 


b 


off 
len 


See Also 

Reference 
PushbacklnputStream Class 
Concepts 

PushbacklnputStream Members 
java.io Package 
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PushbackInputStream.unread Method 


Overload List 





Name Description 





PushbackInputStream.unread (int) 





PushbackInputStream.unread (byte[]) 





PushbackInputStream.unread (byte[], int, int) 











See Also 

Reference 
PushbacklInputStream Class 
Concepts 

PushbacklInputStream Members 
java.io Package 
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PushbackInputStream.unread Method (Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void unread( 
int b) throws java.io. IOException; 


Parameters 


b 


See Also 

Reference 
PushbackInputStream Class 
Concepts 

PushbacklnputStream Members 
java.io Package 
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PushbackInputStream.unread Method (SByte[ ]) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void unread( 
byte[] b) throws java.io. IOException; 


Parameters 


b 


See Also 

Reference 
PushbackInputStream Class 
Concepts 

PushbacklnputStream Members 
java.io Package 
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PushbackInputStream.unread Method (SByte[ ], Int32, Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void unread( 
byte[] b, 
int off, 
int len) throws java.io. IOException; 


Parameters 


b 


off 
len 


See Also 

Reference 
PushbacklnputStream Class 
Concepts 

PushbacklnputStream Members 
java.io Package 
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PushbackReader Class 


Provides an implementation of the abstract Reader class that buffers data from another stream. The internal buffer is initially 
filled with the contents read in from the underlying stream. Characters in this internal buffer can then be "pushed back", or 
replaced with other characters at the position marked. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.PushbackReader 
extends java.io.FilterReader 


Example 


The following example demonstrates the close, read, ready, and unread methods of the PushbackReader class. 


// pushbackreader_overview.jsl 
import java.io.*; 


public class Program 
if 
public static void main(String[] args) 
{ 
try 
{ 
// Create a new instance of a PushbackReader object with an 
// underlying StringReader buffer. 
String s = "This is the internal buffer of StringReader."; 
StringReader stringReader = new StringReader(s) ; 
PushbackReader pbReader = new PushbackReader(stringReader, 100); 


// Read from the underlying StringReader buffer. 
char[] arr = new char[s.length()]; 
if (pbReader.ready()) 


pbReader.read(arr, @, arr.length); 
} 


System.out.println(arr) ; 


// "Unread" some of the data read from the underlying 
// StringReader buffer. 

String newS = "Replacement internal buffer."; 

char[] newSArr = newS.toCharArray(); 
pbReader.unread(newSArr) ; 


// Close the PushbackReader object and the underlying 
// StringReader object. 
stringReader.close(); 
pbReader.close(); 
} 
catch (IOException ex) 


{ 
} 


System.out.printin(ex.toString()); 


} 


/* 

Output: 

This is the internal buffer of StringReader. 
*/ 


Inheritance Hierarchy 
java.lang.Object 
java.io.Reader 
java.io.FilterReader 
java.io.PushbackReader 


See Also 

Concepts 

PushbackReader Members 
java.io Package 
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PushbackReader Members 


Provides an implementation of the abstract Reader class that buffers data from another stream. The internal buffer is initially 
filled with the contents read in from the underlying stream. Characters in this internal buffer can then be "pushed back", or 
replaced with other characters at the position marked. 


The following tables list the members exposed by the PushbackReader type. 


Public Constructors 





Name 


Description 





PushbackReader Overloaded. Initializes a new instance of a PushbackReader object. 








Public Fields 


Name __ |Description 





in (inherited from FilterReader ) 











lock The object used to synchronize operations on the reader.(inherited from Reader) 





Public Methods 




















[Name [Description = s—“—s—‘“—s‘“‘“‘“‘i;™”™®™®™S~<S~Ss™™ 

close Overridden. Closes the stream being buffered and clears all internal buffers. 

equals (inherited from Object ) 

hashCode (inherited from Object ) 

getClass (inherited from Object ) 

mark (inherited from FilterReader ) 

markSupported|Overridden. Determines whether the current position of the stream can be marked. Objects of type PushbackR 
eader do not support marking. 

clone Creates a shallow copy of the object. (inherited from Reader) 

read Overloaded. Overridden. Reads the next character or characters from the underlying stream. 

ready Overridden. Determines whether the underlying stream is ready for reading. 

reset (inherited from FilterReader ) 

skip (inherited from FilterReader ) 

toString Displays a human readable representation of the reader. (inherited from Reader) 

unread Overloaded. Replaces the characters that were read into the internal buffer from the underlying stream with t 


he given character or characters. 








Name 


finalize 





Protected Methods 


Description 


(inherited from Object ) 











See Also 

Reference 
PushbackReader Class 
Concepts 

java.io Package 
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PushbackReader Fields 


Public Fields 





Name _ Description 





in (inherited from FilterReader ) 





lock The object used to synchronize operations on the reader. (inherited from Reader ) 











See Also 

Reference 
PushbackReader Class 
Concepts 

java.io Package 
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PushbackReader Constructor 


Initializes a new instance of a PushbackReader object. 


Overload List 
Name Description 


PushbackReader (Reader) __ |Initializes a new instance of a PushbackReader object. The provided Reader object is the source o 
f the data to be buffered. 





PushbackReader (Reader, int)|Initializes a new instance of a PushbackReader object. The provided Reader object is the source o 
f the data to be buffered. The internal buffer is initializes to the given size. 











See Also 

Reference 
PushbackReader Class 
Concepts 

PushbackReader Members 
java.io Package 
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PushbackReader Constructor (Reader) 


Initializes a new instance of a PushbackReader object. The provided Reader object is the source of the data to be buffered. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.PushbackReader( 
java.io.Reader in); 


Parameters 
in 


A Reader object is the source of the data to be buffered. 


See Also 

Reference 
PushbackReader Class 
Concepts 

PushbackReader Members 
java.io Package 
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PushbackReader Constructor (Reader, Int32) 


Initializes a new instance of a PushbackReader object. The provided Reader object is the source of the data to be buffered. The 
internal buffer is initializes to the given size. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.PushbackReader( 
java.io.Reader in, 
int size); 


Parameters 
in 


A Reader object is the source of the data to be buffered. 
size 
The size of the internal buffer. 


See Also 

Reference 
PushbackReader Class 
Concepts 

PushbackReader Members 
java.io Package 
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PushbackReader Methods 


Public Methods 



























































Name Description 

close Overridden. Closes the stream being buffered and clears all internal buffers. 

equals (inherited from Object ) 

hashCode (inherited from Object ) 

getClass (inherited from Object ) 

mark (inherited from FilterReader ) 

markSupported|Overridden. Determines whether the current position of the stream can be marked. Objects of type 
PushbackReader do not support marking. 

clone Creates a shallow copy of the object. (inherited from Reader ) 

read Overloaded. Overridden. Reads the next character or characters from the underlying stream. 

ready Overridden. Determines whether the underlying stream is ready for reading. 

reset (inherited from FilterReader ) 

skip (inherited from FilterReader ) 

toString Displays a human readable representation of the reader. (inherited from Reader ) 

unread Overloaded. Replaces the characters that were read into the internal buffer from the underlying stream with t 
he given character or characters. 

Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 


PushbackReader Class 


Concepts 
java.io Package 
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PushbackReader.close Method 


Closes the stream being buffered and clears all internal buffers. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void close() throws java.io. IOException; 


Example 


The following example demonstrates how to close a PushbackReader object. 


// pushbackreader_close.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 
{ 
try 
{ 
// Create a new instance of a PushbackReader object with an 
// underlying StringReader buffer. 
String s = "This is the internal buffer of StringReader."; 
StringReader stringReader = new StringReader(s) ; 
PushbackReader pbReader = new PushbackReader(stringReader, 100); 


// Read from the underlying StringReader buffer. 
char[] arr = new char[s.length()]; 
pbReader.read(arr); 

System.out.println(arr) ; 


// "Unread" some of the data read from the underlying 
// StringReader buffer. 

String newS = "Replacement internal buffer."; 

char[] newSArr = newS.toCharArray(); 
pbReader.unread(newSArr) ; 


// Close the PushbackReader object and the underlying 
// StringReader object. 
stringReader.close(); 
pbReader.close(); 
} 
catch (IOException ex) 


{ 
} 


System.out.printin(ex.toString()); 


} 


/* 
Output: 
This is the internal buffer of StringReader. 


*/ 


See Also 

Reference 
PushbackReader Class 
Concepts 

PushbackReader Members 


java.io Package 
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PushbackReader.markSupported Method 


Determines whether the current position of the stream can be marked. Objects of type PushbackReader do not support 
marking. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean markSupported(); 


Return Value 
Always false. 


See Also 

Reference 
PushbackReader Class 
Concepts 

PushbackReader Members 
java.io Package 
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PushbackReader.read Method 


Reads the next character or characters from the underlying stream. 


Overload List 


Name Description 
PushbackReader.read () Reads the next character from the underlying stream. 
PushbackReader.read (char[]) Reads the characters in the array starting at an offset for the length specified and stores t 


hem in the provided array of characters. 





PushbackReader.read (char[], int, int)/Reads the characters from the underlying stream for the length specified, and stores the 
m in the provided array of characters, starting at an offset. 








See Also 
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java.io Package 





Visual J# Reference 


PushbackReader.read Method () 


Reads the next character from the underlying stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read() throws java.io. IOException; 


Return Value 
The numeric value of the character read from the stream using the character encoding of the system (such as UTF-8). 
Example 


The following example demonstrates how to read a single character at a time from the underlying stream. 


// pushbackreader_read.jsl 
import java.io.*; 


public class Program 
{ 
public static void main(String[] args) 
af 
try 
{ 
// Create a new instance of a PushbackReader object with an 
// underlying StringReader buffer. 
String s = "This is the internal buffer of StringReader."; 
StringReader stringReader = new StringReader(s) ; 
PushbackReader pbReader = new PushbackReader(stringReader, 100); 


// Read from the underlying StringReader buffer. 
for (int i = @; i < s.length(); i++) 
{ 


} 


System.out.print((char)pbReader.read()); 


// "Unread" some of the data read from the underlying 
// StringReader buffer. 

String newS = "Replacement internal buffer."; 

char[] newSArr = newS.toCharArray(); 
pbReader.unread(newSArr) ; 


// Close the PushbackReader object and the underlying 
// StringReader object. 
stringReader.close(); 
pbReader.close(); 
} 
catch (IOException ex) 
{ 


} 


System.out.printin(ex.toString()); 


} 


/* 
Output: 
This is the internal buffer of StringReader. 


af 
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PushbackReader.read Method (Char[], Int32, Int32) 


Reads the characters from the underlying stream for the length specified, and stores them in the provided array of characters, 
starting at an offset. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read( 
char[] b, 
int off, 
int len) throws java.io. IOException; 


Parameters 
b 
The array of characters to store the characters read from the underlying stream. 


off 


An offset into the array of characters. This value represents the index of the first character in the array to be written. This 
value must be greater than zero. 


len 
The number of characters to be read. This value plus the offset must be less than the overall length of the array. 
Return Value 
The number of characters read. 
Example 


The following example demonstrates how to read data from the underlying stream and store the data in an array. 
// pushbackreader_read_2.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
try 
{ 


// Create a new instance of a PushbackReader object with an 

// underlying StringReader buffer. 

String s = "This is the internal buffer of StringReader."; 
StringReader stringReader = new StringReader(s) ; 

PushbackReader pbReader = new PushbackReader(stringReader, 100); 


// Read from the underlying StringReader buffer. 
char[] arr = new char[s.length()]; 
pbReader.read(arr, @, arr.length); 
System.out.println(arr) ; 


// "Unread" some of the data read from the underlying 
// StringReader buffer. 

String newS = "Replacement internal buffer."; 

char[] newSArr = newS.toCharArray(); 
pbReader.unread(newSArr) ; 


// Close the PushbackReader object and the underlying 
// StringReader object. 
stringReader.close(); 


pbReader.close(); 


} 
catch (IOException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 
} 
/* 
Output: 


This is the internal buffer of StringReader. 
a 
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PushbackReader.ready Method 


Determines whether the underlying stream is ready for reading. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean ready() throws java.io. IOException; 


Return Value 
true if the underlying stream is ready for reading; false otherwise. 
Example 


The following example demonstrates how to determine if a PushbackReader object is ready for reading. 


// pushbackreader_ready.jsl 
import java.io.*; 


public class Program 


{ 


public static void main(String[] args) 
if 
try 
{ 
// Create a new instance of a PushbackReader object with an 
// underlying StringReader buffer. 
String s = "This is the internal buffer of StringReader."; 
StringReader stringReader = new StringReader(s); 
PushbackReader pbReader = new PushbackReader(stringReader, 100); 


// Read from the underlying StringReader buffer. 
char[] arr = new char[s.length()]; 
if (pbReader.ready()) 


pbReader.read(arr, @, arr.length); 
} 


System.out.println(arr) ; 


// "Unread" some of the data read from the underlying 
// StringReader buffer. 

String newS = "Replacement internal buffer."; 

char[] newSArr = newS.toCharArray(); 
pbReader.unread(newSArr) ; 


// Close the PushbackReader object and the underlying 
// StringReader object. 
stringReader.close(); 
pbReader.close(); 
catch (IOException ex) 


{ 
} 


System.out.printin(ex.toString()); 


} 


/* 
Output: 
This is the internal buffer of StringReader. 


*/ 
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PushbackReader.unread Method 


Replaces the characters that were read into the internal buffer from the underlying stream with the given character or 
characters. 


Overload List 





Name Description 





PushbackReader.unread (char[]) Replaces the characters read into the internal buffer from the underlying stream with t 
he given array of characters. The characters are replaced starting from the character th 
at is currently marked in the internal buffer. 





PushbackReader.unread (int) Replaces the marked character in the internal buffer with the given character. 





PushbackReader.unread (char[], int, int)/Replaces the characters read into the internal buffer from the underlying stream with t 
he given array of characters, starting at the offset given, for the length specified. The ch 
aracters are replaced starting from the character that is currently marked in the interna 
| buffer. 
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PushbackReader.unread Method (CharT ]) 


Replaces the characters read into the internal buffer from the underlying stream with the given array of characters. The 
characters are replaced starting from the character that is currently marked in the internal buffer. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void unread( 
char[] b) throws java.io. IOException; 


Parameters 


b 


The array of characters to replace the characters currently in the internal buffer, starting from the position that is currently 
marked. 


Example 


The following example demonstrates how to "push back" the data read from a PushbackReader object. 


// pushbackreader_unread.jsl 
import java.io.*; 


public class Program 


{ 


public static void main(String[] args) 
if 
try 
{ 
// Create a new instance of a PushbackReader object with an 
// underlying StringReader buffer. 
String s = "This is the internal buffer of StringReader."; 
StringReader stringReader = new StringReader(s) ; 
PushbackReader pbReader = new PushbackReader(stringReader, 100); 


// Read from the underlying StringReader buffer. 
char[] arr = new char[s.length()]; 
if (pbReader.ready()) 


pbReader.read(arr, @, arr.length); 
} 


System.out.println(arr) ; 


// "Unread" some of the data read from the underlying 
// StringReader buffer. 

String newS = "Replacement internal buffer."; 

char[] newSArr = newS.toCharArray(); 
pbReader.unread(newSArr) ; 


// Close the PushbackReader object and the underlying 
// StringReader object. 

stringReader.close(); 

pbReader.close(); 


} 
catch (IOException ex) 


{ 
} 


System.out.printin(ex.toString()); 


/* 
Output: 


This is the internal buffer of StringReader. 
=] 
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PushbackReader.unread Method (Int32) 


Replaces the marked character in the internal buffer with the given character. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void 


unread( 


int b) throws java.io.IOException; 


Parameters 


b 


The character to replaces the last character read into the internal buffer from the underlying stream. 


Example 


The following example demonstrates how to “push back" the data read from a PushbackReader object. 


// pushbackreader_unread_2.jsl 


import java. 


io.*; 


public class Program 


public static void main(String[] args) 


// Create a new instance of a PushbackReader object with an 

// underlying StringReader buffer. 

String s = "This is the internal buffer of StringReader."; 
StringReader stringReader = new StringReader(s) ; 

PushbackReader pbReader = new PushbackReader(stringReader, 100); 


// Read from the underlying StringReader buffer. 
char[] arr = new char[s.length()]; 
if (pbReader.ready()) 


pbReader.read(arr, @, arr.length); 
} 


System.out.println(arr) ; 


// "Unread" some of the data read from the underlying 
// StringReader buffer. 

String newS = "Replacement internal buffer."; 

for (int i = @; i < newS.length(); i++) 


pbReader.unread(newS.charAt(i)); 
} 


// Close the PushbackReader object and the underlying 
// StringReader object. 

stringReader.close(); 

pbReader.close(); 


catch (IOException ex) 


{ 
try 
{ 
{ 
} 
} 


/* 


System.out.printin(ex.toString()); 


Output: 
This is the internal buffer of StringReader. 
*/ 
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PushbackReader.unread Method (Char, J], Int32, Int32) 


Replaces the characters read into the internal buffer from the underlying stream with the given array of characters, starting at 
the offset given, for the length specified. The characters are replaced starting from the character that is currently marked in the 
internal buffer. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void unread( 
char[] b, 
int off, 
int len) throws java.io. IOException; 


Parameters 
b 


The array of characters to replace the characters currently in the internal buffer, starting from the position that is currently 
marked. 


off 


An offset into the above array of characters. This value represents the index of the first character in the array to be written. 
This value must be greater than zero. 


len 
The number of characters to be replaced. This value plus the offset must be less than the overall length of the array. 
Example 


The following example demonstrates how to "push back" the data read from a PushbackReader object. 
// pushbackreader_unread_3.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
, 
try 
{ 


// Create a new instance of a PushbackReader object with an 

// underlying StringReader buffer. 

String s = "This is the internal buffer of StringReader."; 
StringReader stringReader = new StringReader(s) ; 

PushbackReader pbReader = new PushbackReader(stringReader, 100); 


// Read from the underlying StringReader buffer. 
char[] arr = new char[s.length()]; 
if (pbReader.ready()) 


pbReader.read(arr, @, arr.length); 
} 


System.out.println(arr) ; 


// "Unread" some of the data read from the underlying 
// StringReader buffer. 

String newS = "Replacement internal buffer."; 

char[] newSArr = newS.toCharArray(); 
pbReader.unread(newSArr, @, newSArr. length) ; 


// Close the PushbackReader object and the underlying 


// StringReader object. 
stringReader.close(); 
pbReader.close(); 


} 
catch (IOException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 
} 
/* 
Output: 


This is the internal buffer of StringReader. 
*/ 
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RandomAccessFile Class 


Represents a file used to store data that can be accessed in a non-sequential manner. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.RandomAccessFile 
extends java.lang.Object 
implements java.io.DataOutput, java.io.DataInput 


Example 


The following example demonstrates the close, readDouble, readInt, seek, skipBytes, writeBoolean, writeDouble, and writelnt 
methods of the RandomAccessFile class. 


// randomaccessfile_overview. jsl 
import java.io.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
try 
{ 
// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 


// Write some data to the file. 
raf.writeBoolean(true) ; 
raf.writeDouble(3.14); 

raf. .writeInt (2147483647) ; 


// Reposition the file pointer to position @. 
raf.seek(@); 


// Skip over 1 byte (the length of a boolean). 
raf.skipBytes(1); 


// Read in the next double from the file. 
double d = raf.readDouble(); 
System.out.println("The double at position 1 is " + d); 


// Read in the next int from the file. 
int i = raf.readInt(); 
System.out.println("The int after the double is 


+ i); 


// Close the file. 
raf.close(); 


catch (IOException ex) 
{ 


} 


System.out.println(ex.toString()); 


} 


/* 

Output: 

The double at position 1 is 3.14 

The int after the double is 2147483647 


ie 
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RandomdAccessFile Members 


Represents a file used to store data that can be accessed in a non-sequential manner. 


The following tables list the members exposed by the RandomAccessFile type. 


Public Constructors 





Name 


Description 





RandomAccessFile 


Overloaded. Initializes a new instance of a RandomAccessFile object. 








Public Methods 
Name 


Description 








close Closes the underlying input stream. 
equals (inherited from Object ) 
getFD Gets the file descriptor for the file being accessed. 





getFilePointer 


Gets the position in the file where the next read or write operation will occur. 














readBoolean 


hashCode (inherited from Object ) 

getClass (inherited from Object ) 

length Gets the length of the file being accessed. 

clone Creates an instance of a RandomAccessFile object that is a shallow copy of the current RandomAccessFile 
object. 

read 


Overloaded. Reads the next character or group of characters from the file. 


Reads the next byte from the file, interpreting the data as a boolean. 











readByte Reads the next byte from the file. 

readChar Reads the next two bytes from the file, interpreting the data as a char. 
readDouble Reads the next eight bytes from the file, interpreting the data as a double. 
readFloat Reads the next four bytes from the file, interpreting the data as a float. 
readFully Overloaded. Reads the specified number of bytes from the file. 

readint Reads the next four bytes from the file, interpreting the data as an int. 
readLine Reads the next line from the file. 

readLong Reads the next eight bytes from the file, interpreting the data as a long. 
readShort Reads the next two bytes from the file, interpreting the data as a short. 





readUnsignedByte 








Reads the next byte from the file, interpreting the data as a ubyte. 


























readUnsignedShort/Reads the next two bytes from the file, interpreting the data as an unsigned short. 
readUTF Reads a string from the file as UTF (Unicode Transfer Format). 

seek Moves the pointer for the next read or write operation to the given position in the file. 
skipBytes Skips over the next n bytes in the file. 

toString Overridden. Displays a human-readable representation of a RandomAccessFile object. 
write Overloaded. Writes data to the file. 





writeBoolean 


Writes a boolean to the file. 





writeByte 


writeBytes 


writeChar 


writeChars 


writeDouble 


writeFloat 


writelnt 


writeLong 


writeShort 


writeUTF 


Writes a byte to the file. 


Writes a string to the file. 


Writes a char to the file. 


Writes a string to the file. 


Writes a double to the file. 


Writes a float to the file. 


Writes an int to the file. 


Writes a long to the file. 


Writes a short to the file. 


Writes a UTF (Unicode Transfer Format) string to the file. 








Protected Meth 


ods 





Name 


Description 





finalize 





(inherited from Object ) 
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RandomAccessFile Constructor 


Initializes a new instance of a RandomAccessFile object. 


<< List 


RandomAccessFile (File, String) Initializes a new instance of a RandomAccessFile object using the given file. 





RandomAccessFile (String, String) Initializes a new instance of a RandomAccessFile object using the given file. 
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RandomAccessFile Constructor (File, String) 


Initializes a new instance of a RandomAccessFile object using the given file. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.RandomAccessFile( 
java.io.File f, 
java.lang.String mode) throws java.io. IOException; 


Parameters 


f 
An instance of a File object representing the file being accessed. 

mode 
The mode of the file. Either "rw" for read-write access or "r" for read-only access. 
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RandomAccessFile Constructor (String, String) 


Initializes a new instance of a RandomAccessFile object using the given file. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.RandomAccessFile( 
java.lang.String filename, 
java.lang.String mode) throws java.io. IOException; 


Parameters 
filename 


The name of the file being accessed. 
mode 
The mode of the file. Either "rw" for read-write access or "r" for read-only access. 
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RandomAccessFile Methods 


Public Methods 














Name Description 

close Closes the underlying input stream. 

equals (inherited from Object ) 

getFD Gets the file descriptor for the file being accessed. 





getFilePointer 


Gets the position in the file where the next read or write operation will occur. 








hashCode (inherited from Object ) 

getClass (inherited from Object ) 

length Gets the length of the file being accessed. 

clone Creates an instance of a RandomAccessFile object that is a shallow copy of the current RandomAccessFile 
object. 

read Overloaded. Reads the next character or group of characters from the file. 





readBoolean 


Reads the next byte from the file, interpreting the data as a boolean. 





























readByte Reads the next byte from the file. 

readChar Reads the next two bytes from the file, interpreting the data as a char. 
readDouble Reads the next eight bytes from the file, interpreting the data as a double. 
readFloat Reads the next four bytes from the file, interpreting the data as a float. 
readFully Overloaded. Reads the specified number of bytes from the file. 

readint Reads the next four bytes from the file, interpreting the data as an int. 
readLine Reads the next line from the file. 

readLong Reads the next eight bytes from the file, interpreting the data as a long. 
readShort Reads the next two bytes from the file, interpreting the data as a short. 





readUTF 


seek 





readUnsignedByte 


readUnsignedShort 





Reads the next byte from the file, interpreting the data as a ubyte. 
Reads the next two bytes from the file, interpreting the data as an unsigned short. 
Reads a string from the file as UTF (Unicode Transfer Format). 


Moves the pointer for the next read or write operation to the given position in the file. 











writeBoolean 


skipBytes Skips over the next n bytes in the file. 
toString Overridden. Displays a human-readable representation of a RandomAccessFile object. 
write Overloaded. Writes data to the file. 


Writes a boolean to the file. 




















writeByte Writes a byte to the file. 

writeBytes Writes a string to the file. 

writeChar Writes a char to the file. 

writeChars Writes a string to the file. 

writeDouble Writes a double to the file. 

writeFloat Writes a float to the file. 

writelnt Writes an int to the file. 

writeLong Writes a long to the file. 

writeShort Writes a short to the file. 

writeUTF Writes a UTF (Unicode Transfer Format) string to the file. 








Name 


finalize 
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RandomAccessFile.clone Method 


Creates an instance of a RandomAccessFile object that is a shallow copy of the current RandomAccessFile object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


Return Value 
An instance of a RandomAccessFile object that is a shallow copy of the current RandomAccessFile object. 
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RandomAccessFile.close Method 


Closes the underlying input stream. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public void close() throws java.io. IOException; 





Example 


The following example demonstrates how to close a RandomAccessFile object. 











// randomaccessfile_close.jsl 
import java.io.*; 
public class Program 
public static void main(String[] args) 
{ 
try 
{ 
// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 
// Do something useful with the file here. 
// Close the file. 
raf.close(); 
catch (IOException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 
} 
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RandomAccessFile.getFD Method 


Gets the file descriptor for the file being accessed. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final java.io.FileDescriptor getFD() throws java.io. IOException; 


Return Value 
The file descriptor, represented by a FileDescriptor object, for the file being accessed. 
Example 


The following example shows how to obtain the FileDescriptor object for a random access file. 
// randomaccessfile_getfd.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
try 
{ 
// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 
// Get the file descriptor for this file. 
FileDescriptor fd = raf.getFD(); 
System.out.println("Is the file descriptor valid? " + 
fd.valid()); 
// Close the file. 
raf.close(); 
catch (IOException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 
} 
/* 
Output: 
Is the file descriptor valid? true 
af 
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RandomAccessFile.getFilePointer Method 


Gets the position in the file where the next read or write operation will occur. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public long 


Return Value 


getFilePointer() throws java.io. IOException; 


The position in the file where the next read or write operation will occur. 


Example 


The following example shows how to determine the location within the file where the next read or write will occur. 


// randomaccessfile_getfilepointer.jsl 


import java. 


io.*; 


public class Program 


public static void main(String[] args) 


// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 


// Write some data to the file. 
raf.writeBoolean(true); 
raf.writeDouble(3.14); 

raf .writeInt (2147483647) ; 


// Get the location within the file for the next 

// read or write operation. 

long ptr = raf.getFilePointer(); 

System.out.println("The next read or write will occur " + 
"at position " + ptr); 


// Close the file. 
raf.close(); 


catch (IOException ex) 


System.out.println(ex.toString()); 


The next read or write will occur at position 13 


{ 
{ 
try 
{ 
{ 
ii 
i 
} 
/* 
Output: 
*/ 
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RandomAccessFile.length Method 


Gets the length of the file being accessed. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public long length() throws java.io. IOException; 


Return Value 
The length of the file being accessed. 
Example 


The following example displays the length of a random access file. 
// randomaccessfile_length.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
try 
{ 
// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 
// Write some data to the file. 
raf.writeBoolean(true); 
raf.writeDouble(3.14); 
raf.writeInt (2147483647) ; 
// Get the length of the file. 
long len = raf.length(); 
System.out.println("The file contains " + len + 
" bytes."); 
// Close the file. 
raf.close(); 
} 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 
The file contains 13 bytes. 
A 
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RandomAccessFile.read Method 


Reads the next character or group of characters from the file. 


Overload List 


Name Description 
RandomAccessFile.read () Reads the next character from the file. 
RandomAccessFile.read (byte[]) Reads from the file and stores the data read in the provided array. 


RandomAccessFile.read (bytel], int, int)/Reads from the file for the length specified and stores the data read in the provided arr 
ay, starting at an offset. 
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RandomAccessFile.read Method () 


Reads the next character from the file. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read() throws java.io. IOException; 


Return Value 
The numeric value of the character read from the file, or -1 if there are no more characters to read. 
Example 


The following example shows how to read a single character from a random access file. 
// randomaccessfile_read.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
try 
{ 
// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 
// Write out a single character. 
char c = ‘'a'; 
raf.write(c); 
// Reposition the file pointer to position @. 
raf.seek(@); 
// Read in the next character. 
System.out.printin("char: " + (char)raf.read()); 
// Close the file. 
raf.close(); 
} 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 
char: a 
= / 
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RandomAccessFile.read Method (SByte[]) 


Reads from the file and stores the data read in the provided array. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read( 
byte[] b) throws java.io. IOException; 


Parameters 


b 
An array to store the data read from the file. 
Return Value 
The number of characters read. 
Example 


The following example shows how to read an array of bytes from a random access file. 


// randomaccessfile read _2.jsl 
import java.io.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
try 
{ 
// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 


// Write out a byte array. 
String s = "byte array"; 
byte[] arr = s.getBytes(); 
raf.write(arr); 


// Reposition the file pointer to position @. 
raf.seek(@); 


// Read in the next byte array. 
byte[] newArr = new byte[arr.length]; 
raf.read(newArr) ; 
System.out.println("byte[]: 


+ new String(newArr) ); 


// Close the file. 
raf.close(); 


catch (IOException ex) 
{ 


} 


System.out.println(ex.toString()); 


} 


/* 

Output: 

byte[]: byte array 
ni] 
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RandomAccessFile.read Method (SByte[], Int32, Int32) 


Reads from the file for the length specified and stores the data read in the provided array, starting at an offset. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read( 
byte[] b, 
int offset, 
int len) throws java.io.IOException; 


Parameters 


b 


An array to store the data read from the file. 


offset 


An offset into the array. This value represents the index of the first character in the array to be written. This value must be 
greater than zero. 


len 


The number of characters to be read from the file. This value plus the offset must be less than the overall length of the array. 


Return Value 


The number of characters read. 


Example 


The following example shows how to read an array of bytes from a random access file. 


// randomaccessfile read_3.jsl 


import java. 


io.*; 


public class Program 


{ 


public static void main(String[] args) 


{ 
try 


{ 


} 


// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 


// Write out a byte array from position @ to 6. 
String s = "another byte array"; 

byte[] arr2 = s.getBytes(); 

raf.write(arr2, @, 7); 


// Reposition the file pointer to position @. 
raf.seek(@); 


// Read in the next byte array. 

byte[] newArr2 = new byte[arr2.length]; 
raf.read(newArr2, 8, 7); 
System.out.printlin("byte[]: "+ new String(newArr2) ); 


// Close the file. 
raf.close(); 


catch (IOException ex) 


System.out.printin(ex.toString()); 


} 


/* 

Output: 

byte[]: another 
a 
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RandomAccessFile.readBoolean Method 


Reads the next byte from the file, interpreting the data as a boolean. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final boolean readBoolean() throws java.io. IOException; 


Return Value 


The value of the data read as a boolean. 


Example 


The following example shows how to read a boolean from a random access file. 


// randomaccessfile_readboolean.jsl 


import java. 


io.*; 


public class Program 


public static void main(String[] args) 


// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 


// Write out a boolean. 
raf.writeBoolean(true); 


// Reposition the file pointer to position @. 
raf.seek(@); 


// Read in the next boolean. 
System.out.println("boolean: 


+ raf.readBoolean()); 


// Close the file. 
raf.close(); 


catch (IOException ex) 


System.out.println(ex.toString()); 


{ 
{ 
try 
{ 
} 
{ 
I 
i; 
} 
/* 
Output: 
boolean: true 
wd 
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RandomAccessFile.readByte Method 


Reads the next byte from the file. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final byte readByte() throws java.io. IOException; 


Return Value 

The next byte read from the file. 

Example 

The following example shows how to read a byte from a random access file. 
// randomaccessfile_readbyte.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
try 
{ 
// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 
// Write out a byte. 
raf.writeByte(22); 
// Reposition the file pointer to position @. 
raf.seek(@); 
// Read in the next byte. 
System.out.println("byte: " + raf.readByte()); 
// Close the file. 
raf.close(); 
} 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 
byte: 22 
*/ 
See Also 
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RandomAccessFile.readChar Method 


Reads the next two bytes from the file, interpreting the data as a char. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final char readChar() throws java.io. IOException; 


Return Value 

The value of the data read as a char. 

Example 

The following example shows how to read a char from a random access file. 
// randomaccessfile_readchar.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
try 
{ 
// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 
// Write out a char. 
raf.writeChar('Z'); 
// Reposition the file pointer to position @. 
raf.seek(@); 
// Read in the next char. 
System.out.printin("char: " + raf.readChar()); 
// Close the file. 
raf.close(); 
} 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 
char: Z 
ey 
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RandomAccessFile.readDouble Method 


Reads the next eight bytes from the file, interpreting the data as a double. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final double readDouble() throws java.io. IOException; 


Return Value 


The value of the data read as a double. 


Example 


The following example shows how to read a double from a random access file. 


// randomaccessfile_readdouble.jsl 


import java. 


io.*; 


public class Program 


public static void main(String[] args) 


// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 


// Write out a double. 
raf.writeDouble(3.14d); 


// Reposition the file pointer to position @. 
raf.seek(@); 


// Read in the next double. 
System.out.println("double: " + raf.readDouble()); 


// Close the file. 
raf.close(); 


catch (IOException ex) 


{ 
{ 
try 
{ 
} 
{ 
I 
i; 
} 
/* 
Output: 
double: 3.14 
- 
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RandomAccessFile.readFloat Method 


Reads the next four bytes from the file, interpreting the data as a float. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final float readFloat() throws java.io. IOException; 


Return Value 


The value of the data read as a float. 


Example 


The following example shows how to read a float from a random access file. 


// randomaccessfile_readfloat.jsl 


import java. 


io.*; 


public class Program 


public static void main(String[] args) 


// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 


// Write out a float. 
raf.writeFloat(1.717Ff); 


// Reposition the file pointer to position @. 
raf.seek(@); 


// Read in the next float. 
System.out.printlin("float: " + raf.readFloat()); 


// Close the file. 
raf.close(); 


catch (IOException ex) 


{ 
{ 
try 
{ 
} 
{ 
I 
i; 
} 
/* 
Output: 
float: 1.717 
=] 
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RandomAccessFile.readFully Method 


Reads the specified number of bytes from the file. 


Overload List 


Name Description 


Reads the number of bytes specified by the given array from the file and fills the a 
rray with the data read. 


RandomAccessFile.readFully (byte[]) 








RandomAccessFile.readFully (byte[], int, int)/Reads len bytes from the file and fills the array with the data read, starting at an of 
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RandomAccessFile.readFully Method (SByte[]) 


Reads the number of bytes specified by the given array from the file and fills the array with the data read. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final void readFully( 
byte[] b) throws java.io. IOException; 


Parameters 


b 
An array to store the data read from the file. 
Example 


The following example reads in the entire contents of a random access file and stores it in an array. 
// randomaccessfile_readfully.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 


{ 
try 
{ 
// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 
// Write out a string. 
String str = "a string\nanother string"; 
raf.writeBytes(str); 
// Reposition the file pointer to position @. 
raf.seek(@); 
// Read in the entire file. 
byte[] arr = new byte[str.length() ]; 
raf.readFully(arr); 
String s = new String(arr); 
System.out.println("readFully as string: " + s); 
// Close the file. 
raf.close(); 
catch (IOException ex) 
if 
System. out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 


readFully as string: a string 
another string 


ad A 
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RandomAccessFile.readFully Method (SByte[ ], Int32, Int32) 


Reads len bytes from the file and fills the array with the data read, starting at an offset. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final void readFully( 
byte[] b, 
int offset, 
int len) throws java.io.IOException; 


Parameters 
b 

An array to store the data read from the file. 
offset 


An offset into the array. This value represents the index of the first character in the array to be written. This value must be 
greater than zero. 


len 
The number of characters to be read from the file. This value plus the offset must be less than the overall length of the array. 
Example 


The following example reads in the entire contents of a random access file and stores it in an array. 
// randomaccessfile_readfully 2.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
try 
{ 


// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 


// Write out a string. 
String str = "a string\nanother string"; 
raf.writeBytes(str); 


// Reposition the file pointer to position @. 
raf.seek(Q); 


// Read in the entire file. 

byte[] arr = new byte[str.length()]; 
raf.readFully(arr, @, arr.length); 
String s = new String(arr); 
System.out.println("readFully as string: 


+ S)3 


// Close the file. 
raf.close(); 


catch (IOException ex) 


{ 
} 


System.out.printin(ex.toString()); 


} 


/* 

Output: 

readFully as string: a string 
another string 


*/ 
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RandomAccessFile.readint Method 


Reads the next four bytes from the file, interpreting the data as an int. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final int readInt() throws java.io. IOException; 


Return Value 
The value of the data read as an int. 
Example 


The following example shows how to read an int from a random access file. 
// randomaccessfile_readint.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
try 
{ 
// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 
// Write out an int. 
raf. .writeInt (2147483647) ; 
// Reposition the file pointer to position @. 
raf.seek(@); 
// Read in the next int. 
System.out.printlin("int: " + raf.readInt()); 
// Close the file. 
raf.close(); 
} 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 
int: 2147483647 
a | 
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RandomdAccessFile.readLine Method 


Reads the next line from the file. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final java.lang.String readLine() throws java.io. IOException; 


Return Value 
The line read from the file, or null if no end-of-line marker was found. 
Example 


The following example shows how to read in the next line from a random access file. 
// randomaccessfile_ readline. jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
try 
{ 
// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 
// Write out a string. 
String str = "a string\nanother string"; 
raf.writeBytes(str); 
// Reposition the file pointer to position @. 
raf.seek(@); 
// Read in the next line. 
System.out.printlin("line: " + raf.readLine()); 
// Close the file. 
raf.close(); 
} 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 
line: a string 
af 
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RandomAccessFile.readLong Method 


Reads the next eight bytes from the file, interpreting the data as a long. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final long readLong() throws java.io. IOException; 


Return Value 
The value of the data read as a long. 
Example 


The following example shows how to read a long from a random access file. 
// randomaccessfile_readlong.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
try 
{ 
// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 
// Write out a long. 
raf.writeLong(100000002@Q@L ) ;s 
// Reposition the file pointer to position @. 
raf.seek(@); 
// Read in the next long. 
System.out.printin("long: " + raf.readLong()); 
// Close the file. 
raf.close(); 
} 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 
long: 19@e@eeee8ee0 
ei 
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RandomAccessFile.readShort Method 


Reads the next two bytes from the file, interpreting the data as a short. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final short readShort() throws java.io. IOException; 


Return Value 


The value of the data read as a short. 


Example 


The following example shows how to read a short from a random access file. 


// randomaccessfile_readshort.jsl 


import java. 


io.*; 


public class Program 


public static void main(String[] args) 


// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 


// Write out a short. 
raf.writeShort(255); 


// Reposition the file pointer to position @. 
raf.seek(@); 


// Read in the next short. 
System.out.println("short: " + raf.readShort()); 


// Close the file. 
raf.close(); 


catch (IOException ex) 


{ 
{ 
try 
{ 
} 
{ 
I 
i; 
} 
/* 
Output: 
short: 255 
4 
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RandomAccessFile.readUnsignedByte Method 


Reads the next byte from the file, interpreting the data as a ubyte. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final int readUnsignedByte() throws java.io. IOException; 


Return Value 

The value of the data read as a ubyte. 

Example 

The following example shows how to read a ubyte from a random access file. 
// randomaccessfile_readunsignedbyte.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
try 
{ 
// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 
// Write out a byte. 
raf.writeByte(22); 
// Reposition the file pointer to position @. 
raf.seek(@); 
// Read in the next byte. 
System.out.println("byte: " + raf.readUnsignedByte()); 
// Close the file. 
raf.close(); 
} 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 
byte: 22 
*/ 
See Also 
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RandomAccessFile.readUnsignedShort Method 


Reads the next two bytes from the file, interpreting the data as an unsigned short. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final int readUnsignedShort() throws java.io. IOException; 


Return Value 
The value of the data read as an unsigned short. 
Example 


The following example shows how to read an unsigned short from a random access file. 
// randomaccessfile_readunsignedshort.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
try 
{ 
// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 
// Write out a short. 
raf.writeShort(255); 
// Reposition the file pointer to position @. 
raf.seek(@); 
// Read in the next short. 
System.out.println("short: " + raf.readUnsignedShort()); 
// Close the file. 
raf.close(); 
} 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 
short: 255 
*/ 
See Also 
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RandomAccessFile.readUTF Method 


Reads a string from the file as UTF (Unicode Transfer Format). 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final java.lang.String readUTF() throws java.io. IOException; 


Return Value 
The string printed in UTF (Unicode Transfer Format). 
Example 


The following example shows how to read a UTF string from a random access file. 
// randomaccessfile_readutf.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
try 
{ 
// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 
// Write out a UTF string. 
String utf = "UTF string"; 
raf.writeUTF (utFf) ; 
// Reposition the file pointer to position @. 
raf.seek(@); 
// Read in the next UTF string. 
System.out.println("UTF: " + raf.readUTF()); 
// Close the file. 
raf.close(); 
} 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 
UTF: UTF string 
m/f 
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RandomAccessFile.seek Method 


Moves the pointer for the next read or write operation to the given position in the file. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void seek( 
long pos) throws java.io.IOException; 


Parameters 
pos 


The position in the file where the next read or write operation will occur. 
Example 
The following example demonstrates how to position the pointer for the next read or write operation. 
// randomaccessfile_seek.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 


{ 
try 
{ 
// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 
// Write some data to the file. 
raf.writeBoolean(true) ; 
raf.writeDouble(3.14); 
raf.writeInt (2147483647) ; 
// Reposition the file pointer to position 5. 
raf.seek(5); 
// Read in the next char from the file. 
char c = raf.readChar(); 
System.out.println("The char at position 5 is " +c); 
// Close the file. 
raf.close(); 
catch (IOException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 
} 
/ * 
Output: 
The char at position 5 is ? 
af 
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RandomAccessFile.skipBytes Method 


Skips over the next n bytes in the file. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int skipBytes( 
int n) throws java.io.IOException; 


Parameters 
n 


The number of bytes to skip over before the next read or write operation. 
Return Value 


The actual number of bytes skipped over. This can be less than n if there are less than n bytes remaining in the file when 
skipBytes is called. 


Example 


The following example shows how to skip over data in a random access file. 


// randomaccessfile_skipbytes.jsl 
import java.io.*; 


public class Program 


{ 


public static void main(String[] args) 


{ 
try 


ii 
// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 


// Write some data to the file. 
raf.writeBoolean(true); 
raf.writeDouble(3.14); 

raf .writeInt (2147483647) ; 


// Reposition the file pointer to position @. 
raf.seek(@); 


// Skip over 1 byte (the length of a boolean). 
raf.skipBytes(1); 


// Read in the next double from the file. 
double d = raf.readDouble(); 
System.out.println("The double at position 1 is " + d); 


// Close the file. 
raf.close(); 


catch (IOException ex) 
{ 


} 


System.out.println(ex.toString()); 


/* 


Output: 
The double at position 1 is 3.14 
v7 
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RandomAccessFile.toString Method 


Displays a human-readable representation of a RandomAccessFile object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


Return Value 
A human-readable representation of a RandomAccessFile object. 
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RandomdAccessFile.write Method 


Writes data to the file. 


Overload List 
Name 


RandomAccessFile.write (int) 
RandomAccessFile.write (byte[]) 


RandomAccessFile.write (byte[], int, int) 
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Writes the next character to the file. 
Writes the data contained in the given array to the file. 


Writes len characters from the given array, starting at an offset, to the file. 
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RandomAccessFile.write Method (Int32) 


Writes the next character to the file. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
int b) throws java.io. IOException; 


Parameters 


b 
The character to write to the file. 
Example 


The following example shows how to write a single character to a random access file. 
// randomaccessfile write. jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 


{ 
try 
{ 
// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 
// Write out a single character. 
char c = ‘a’; 
raf.write(c); 
// Reposition the file pointer to position @. 
raf.seek(@); 
// Read in the next character. 
System.out.printin("char: " + (char)raf.read()); 
// Close the file. 
raf.close(); 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
/* 
Output 
char: a 
*/ 
See Also 
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RandomAccessFile.write Method (SByte[ ]) 


Writes the data contained in the given array to the file. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
byte[] b) throws java.io. IOException; 


Parameters 


b 


An array containing the data to write to the file. 


Example 


The following example shows how to write an array of bytes to a random access file. 


// randomaccessfile write _2.jsl 


import java.io.*; 


public class Program 


public static void main(String[] args) 


{ 


} 
/* 


Output: 


try 
{ 


// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 


// Write out a byte array. 
String s = "byte array"; 
byte[] arr = s.getBytes(); 
raf.write(arr); 


// Reposition the file pointer to position @. 
raf.seek(@); 


// Read in the next byte array. 
byte[] newArr = new byte[arr.length]; 
raf.read(newArr) ; 
System.out.println("byte[]: 


+ new String(newArr) ); 


// Close the file. 
raf.close(); 


catch (IOException ex) 


4 
} 


System.out.printin(ex.toString()); 


byte[]: byte array 


i], 
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RandomAccessFile.write Method (SByte[ J, Int32, Int32) 


Writes len characters from the given array, starting at an offset, to the file. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void 


write( 


byte[] b, 
int offset, 
int len) throws java.io. IOException; 


Parameters 


b 


An array containing the data to write to the file. 


offset 


An offset into the array. This value represents the index of the first character in the array to be written to the file. This value 
must be greater than zero. 


len 


The number of characters to be written to the file starting from the offset. This value plus the offset must be less than the 
overall length of the array. 


Example 


The following example shows how to write an array of bytes to a random access file. 


// randomaccessfile write _3.jsl 


import java. 


10.3 


public class Program 


{ 


public static void main(String[] args) 


{ 
try 


d 


} 


// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 


// Write out a byte array from position @ to 6. 
String s = "another byte array"; 

byte[] arr2 = s.getBytes(); 

raf.write(arr2, @, 7); 


// Reposition the file pointer to position @. 
raf.seek(@); 


// Read in the next byte array. 

byte[] newArr2 = new byte[arr2.length]; 
raf.read(newArr2, @, 7); 
System.out.printin("byte[]: "+ new String(newArr2) ); 


// Close the file. 
raf.close(); 


catch (IOException ex) 


{ 


System.out.println(ex.toString()); 


} 
} 
/* 
Output: 


byte[]: another 
*/ 
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RandomdAccessFile.writeBoolean Method 


Writes a boolean to the file. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final void writeBoolean( 


boolean 


Parameters 


bool 


bool) throws java.io. IOException; 


The boolean to write to the file. 


Example 


The following example shows how to write a boolean to a random access file. 


// randomaccessfile_writeboolean.jsl 


import java. 


io.*; 


public class Program 


public static void main(String[] args) 


// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 


// Write out a boolean. 
raf.writeBoolean(true); 


// Reposition the file pointer to position @. 
raf.seek(@); 


// Read in the next boolean. 
System.out.println( "boolean: 


+ raf.readBoolean()); 


// Close the file. 
raf.close(); 


catch (IOException ex) 


System.out.println(ex.toString()); 


{ 
try 
{ 
{ 
ii 
i 
} 
/* 
Output: 
boolean: true 
* f 
See Also 
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RandomAccessFile.writeByte Method 


Writes a byte to the file. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final void writeByte( 
int b) throws java.io.IOException; 


Parameters 


b 
The byte to write to the file. 
Example 


The following example shows how to write a byte to a random access file. 
// randomaccessfile_writebyte.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 


{ 
try 
{ 
// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 
// Write out a byte. 
raf.writeByte(22); 
// Reposition the file pointer to position @. 
raf.seek(@); 
// Read in the next byte. 
System.out.println("byte: " + raf.readByte()); 
// Close the file. 
raf.close(); 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 
byte: 22 
ay 
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RandomAccessFile.writeBytes Method 


Writes a string to the file. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final void writeBytes( 
java.lang.String b) throws java.io. IOException; 


Parameters 


b 


The string to write to the file. 


Example 


The following example shows how to write a string to a random access file. 


// randomaccessfile_writebytes.jsl 


import java.io.*; 


public class Program 


public static void main(String[] args) 


{ 


} 
/* 


Output: 


try 
{ 


// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 


// Write out a string. 
String str = "a string"; 
raf.writeBytes(str); 


// Reposition the file pointer to position @. 
raf.seek(@); 


// Read in the string. 
byte[] arr = new byte[str.length() ]; 
raf.read(arr); 

String s = new String(arr); 
System.out.println("bytes: 


+S); 


// Close the file. 
raf.close(); 


catch (IOException ex) 


4 
} 


System.out.printin(ex.toString()); 


bytes: a string 


he 
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RandomAccessFile.writeChar Method 


Writes a char to the file. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final void writeChar ( 
int b) throws java.io.IOException; 


Parameters 


b 
The char to write to the file. 
Example 


The following example shows how to write a char to a random access file. 
// randomaccessfile_writechar.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 


{ 
try 
{ 
// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 
// Write out a char. 
raf.writeChar('Z'); 
// Reposition the file pointer to position @. 
raf.seek(@); 
// Read in the next char. 
System.out.println("char: " + raf.readChar()); 
// Close the file. 
raf.close(); 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 
char: Z 
ay 
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RandomAccessFile.writeChars Method 


Writes a string to the file. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final void writeChars( 
java.lang.String s) throws java.io. IOException; 


Parameters 
Ss 


The string to write to the file. 


Example 


The following example shows how to write a string to a random access file. 


// randomaccessfile_writechars.jsl 


import java. 


io.*; 


public class Program 


public static void main(String[] args) 


// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 


// Write out a string. 
String str = "a string"; 
raf.writeChars(str); 


// Reposition the file pointer to position @. 
raf.seek(@); 


// Read in the string. 
byte[] arr = new byte[str.length() * 2]; 
raf.read(arr); 

String s = new String(arr); 
System.out.println("chars: 


+ S); 


// Close the file. 
raf.close(); 


catch (IOException ex) 


{ 
try 
{ 
{ 
} 
} 
} 
/* 
Output: 
chars: a 
i) 
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RandomdAccessFile.writeDouble Method 


Writes a double to the file. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final void writeDouble( 
double d) throws java.io. IOException; 


Parameters 


d 


The double to write to the file. 


Example 


The following example shows how to write a double to a random access file. 


// randomaccessfile_writedouble.jsl 


import java. 


io.*; 


public class Program 


public static void main(String[] args) 


// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 


// Write out a double. 
raf.writeDouble(3.14d); 


// Reposition the file pointer to position @. 
raf.seek(@); 


// Read in the next double. 
System.out.println("double: " + raf.readDouble()); 


// Close the file. 
raf.close(); 


catch (IOException ex) 


{ 
try 
{ 
{ 
ii 
i 
} 
/* 
Output: 
double: 3.14 
*/ 
See Also 
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RandomAccessFile.writeFloat Method 


Writes a float to the file. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final void writeFloat( 
float f) throws java.io. IOException; 


Parameters 


f 
The float to write to the file. 
Example 


The following example shows how to write a float to a random access file. 
// randomaccessfile_writefloat.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 


{ 
try 
{ 
// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 
// Write out a float. 
raf.writeFloat(1.717Ff); 
// Reposition the file pointer to position @. 
raf.seek(@); 
// Read in the next float. 
System.out.printlin("float: " + raf.readFloat()); 
// Close the file. 
raf.close(); 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 
float: 1.717 
ey 
See Also 
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RandomAccessFile.writelInt Method 


Writes an int to the file. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final void writeInt( 
int i) throws java.io. IOException; 


Parameters 
l 


The int to write to the file. 
Example 


The following example shows how to write an int to a random access file. 
// randomaccessfile_writeint.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 


{ 
try 
{ 
// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 
// Write out an int. 
raf .writeInt (2147483647) ; 
// Reposition the file pointer to position @. 
raf.seek(@); 
// Read in the next int. 
System.out.printlin("int: " + raf.readInt()); 
// Close the file. 
raf.close(); 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 
int: 2147483647 
a A 
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RandomAccessFile.writeLong Method 


Writes a long to the file. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final void writeLong( 
long 1) throws java.io.IOException; 


Parameters 


l 
The long to write to the file. 
Example 


The following example shows how to write a long to a random access file. 
// randomaccessfile_writelong.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 


{ 
try 
{ 
// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 
// Write out a long. 
raf.writeLong(10000000@@Q@L ) ;s 
// Reposition the file pointer to position @. 
raf.seek(@); 
// Read in the next long. 
System.out.println("long: " + raf.readLong()); 
// Close the file. 
raf.close(); 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 
long: 10@e@eeeeee0 
ey 
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RandomAccessFile.writeShort Method 


Writes a short to the file. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final void writeShort( 
int s) throws java.io.IOException; 


Parameters 
Ss 


The short to write to the file. 
Example 


The following example shows how to write a short to a random access file. 
// randomaccessfile_writeshort.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 


{ 
try 
{ 
// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 
// Write out a short. 
raf.writeShort(255); 
// Reposition the file pointer to position @. 
raf.seek(@); 
// Read in the next short. 
System.out.println("short: " + raf.readShort()); 
// Close the file. 
raf.close(); 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 
short: 255 
=/ 
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RandomAccessFile.writeUTF Method 


Writes a UTF (Unicode Transfer Format) string to the file. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public final void writeUTF( 
java.lang.String s) throws java.io. IOException; 


Parameters 
Ss 


The UTF string to write to the file. 
Example 


The following example shows how to write a UTF string to a random access file. 
// randomaccessfile_writeutf.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 


{ 
try 
{ 
// Create a new random access file. 
RandomAccessFile raf = new RandomAccessFile( 
"C:\\RandomFile.txt", "rw"); 
// Write out a UTF string. 
String utf = "UTF string"; 
raf.writeUTF (utFf) ; 
// Reposition the file pointer to position @. 
raf.seek(@); 
// Read in the next UTF string. 
System.out.println("UTF: " + raf.readUTF()); 
// Close the file. 
raf.close(); 
catch (IOException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 
UTF: UTF string 
*/ 
See Also 
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Reader Class 


An abstract class representing the base for all character readers in the java.io package. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract class java.io.Reader 
extends java.lang.Object 


Example 


The following example demonstrates the close, mark, markSupported, read, and reset methods of the StringReader class, 
which is a specialization of the abstract Reader class. 


// reader_overview.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 


{ 
try 
{ 
// Create a new StringReader. 
String s = "Hello"; 
StringReader reader = new StringReader(s); 
// Read from the underlying string one at a time. 
char firstLetter = (char)reader.read(); 
// Set the mark. 
if (reader.markSupported()) 
// The @ is ignored. 
reader.mark(@) ; 
} 
// Continue reading from the string. 
char secondLetter = (char)reader.read(); 
char thirdLetter = (char)reader.read(); 
char fourthLetter = (char)reader.read(); 
char fifthLetter = (char)reader.read(); 
// Reset the StringReader. 
reader.reset(); 
// Get the first character read after the reset. 
char nextLetter = (char)reader.read(); 
System.out.println("The next letter read after reset is: " + 
nextLetter) ; 
// Close the StringReader. 
reader.close(); 
} 
catch (IOException ex) 
{ 
System. out.println(ex.toString()); 
} 
} 


/* 

Output: 

The next letter read after reset is: e 
/ 
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java.lang.Object 
java.io.Reader 
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Reader Members 


An abstract class representing the base for all character readers in the java.io package. 


The following tables list the members exposed by the Reader type. 


Public Constructors 



























































Name Description 

Reader Overloaded. Initializes a new instance of a Reader object. 

Public Fields 

Name Description 

lock The object used to synchronize operations on the reader. 

Public Methods 

Name Description 

close An abstract method that must be implemented by subclasses. This method should take care of releasing any i 
nternal buffers and resources when called. 

equals (inherited from Object ) 

hashCode (inherited from Object ) 

getClass (inherited from Object ) 

mark Sets the mark to the next character of the characters to be read. 

markSupported|Determines whether the current position of the character can be marked. 

clone Creates a shallow copy of the object. 

read Overloaded. Reads the next character or characters of the characters to be read. 

ready Determines whether the reader is ready for reading. 

reset Resets the reader for the characters such that the next character read is the character that is marked. 

skip Skips over the next count characters of the characters being read or until the end of the array, whichever is les 
S. 

toString Overridden. Displays a human readable representation of the reader. 

Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 

Reader Class 
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java.io Package 
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Reader Fields 


Public Fields 





Name 


Description 





lock 








The object used to synchronize operations on the reader. 





See Also 
Reference 
Reader Class 
Concepts 


java.io Package 
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Reader.lock Field 


The object used to synchronize operations on the reader. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





protected java.lang.Object lock; 





See Also 
Reference 
Reader Class 
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Reader Constructor 


Initializes a new instance of a Reader object. 


ae List 


Reader () Initializes a new instance of a Reader object. 





Reader (Object) |Initializes a new instance of a Reader object. The given lock is used to synchronize operations on the reader. 


See Also 
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Reader Constructor () 


Initializes a new instance of a Reader object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





protected java.io.Reader(); 





Remarks 
The default constructor initializes any fields to their default values. 
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Reader Constructor (Object) 


Initializes a new instance of a Reader object. The given lock is used to synchronize operations on the reader. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected java.io.Reader( 
java.lang.Object lock); 


Parameters 


lock 
The object used to synchronize operations on the reader. 


See Also 
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Reader Methods 


Public Methods 












































Name Description 

close An abstract method that must be implemented by subclasses. This method should take care of releasing any i 
nternal buffers and resources when called. 

equals (inherited from Object ) 

hashCode (inherited from Object ) 

getClass (inherited from Object ) 

mark Sets the mark to the next character of the characters to be read. 

markSupported|Determines whether the current position of the character can be marked. 

clone Creates a shallow copy of the object. 

read Overloaded. Reads the next character or characters of the characters to be read. 

ready Determines whether the reader is ready for reading. 

reset Resets the reader for the characters such that the next character read is the character that is marked. 

skip Skips over the next count characters of the characters being read or until the end of the array, whichever is les 
S. 

toString Overridden. Displays a human readable representation of the reader. 

Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 
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Reader.clone Method 


Creates a shallow copy of the object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





Return Value 
A shallow copy of the object. 


See Also 
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Reader.close Method 


An abstract method that must be implemented by subclasses. This method should take care of releasing any internal buffers 
and resources when called. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract void close() throws java.io. IOException; 


Example 

The following example demonstrates how to close a StringReader object, which is a specialization of the abstract Reader class. 
// reader_close.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
try 
{ 
// Create a new StringReader. 
String s = "Hello"; 
StringReader reader = new StringReader(s); 
// Read from the underlying String. 
char[] newArr = new char[s.length()]; 
reader.read(newArr) ; 
System.out.println("The new array contains: " + 
newArr) ; 
// Close the StringReader. 
reader.close(); 
catch (IOException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 
} 
/* 
Output: 
The new array contains: Hello 
ef 
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Reader.mark Method 


Sets the mark to the next character of the characters to be read. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void mark( 
int readLimit) throws java.io. IOException; 


Parameters 
readLimit 

Derived classes use this parameter differently. Consult the documentation for the particular reader that you are using. 
Example 


The following example demonstrates the effect that the mark method has when you call reset. The StringReader class is a 
specialization of the abstract Reader class. 


// reader_mark.jsl 
import java.io.*; 


public class Program 


+ 
public static void main(String[] args) 
{ 
try 
{ 


// Create a new StringReader. 
String s = "Hello"; 
StringReader reader = new StringReader(s); 


// Read from the underlying string one at a time. 
char firstLetter = (char)reader.read(); 


// Set the mark. 
if (reader.markSupported()) 


// The @ is ignored. 
reader.mark(@) ; 


} 


// Continue reading from the string. 
char secondLetter = (char)reader.read(); 
char thirdLetter = (char)reader.read(); 
char fourthLetter = (char)reader.read(); 
char fifthLetter = (char)reader.read(); 


// Reset the StringReader. 
reader.reset(); 


// Get the first character read after the reset. 

char nextLetter = (char)reader.read(); 

System.out.println("The next letter read after reset is: + 
nextLetter) ; 


// Close the StringReader. 
reader.close(); 


} 
catch (IOException ex) 


{ 


System.out.println(ex.toString()); 


} 
} 
} 
/* 
Output: 


The next letter read after reset is: e 


ser 
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Reader.markSupported Method 


Determines whether the current position of the character can be marked. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean markSupported(); 


Return Value 


true if the current position of the character can be marked; false otherwise. 


Example 


The following example demonstrates the effect that the mark method has when you call reset. The StringReader class is a 
specialization of the abstract Reader class. 


// reader_marksupported.jsl 


import java. 


io.*; 


public class Program 


{ 


public static void main(String[] args) 


{ 
try 


{ 


// Create a new StringReader. 
String s = "Hello"; 
StringReader reader = new StringReader(s); 


// Read from the underlying string one at a time. 
char firstLetter = (char)reader.read(); 


// Set the mark. 
if (reader.markSupported()) 


// The @ is ignored. 
reader.mark(@); 


} 


// Continue reading from the string. 

char secondLetter = (char)reader.read(); 
char thirdLetter = (char)reader.read(); 
char fourthLetter = (char)reader.read(); 
char fifthLetter = (char)reader.read(); 


// Reset the StringReader. 
reader.reset(); 


// Get the first character read after the reset. 
char nextLetter = (char)reader.read(); 


System.out.println("The next letter read after reset is: 


nextLetter) ; 


// Close the StringReader. 
reader.close(); 


catch (IOException ex) 


{ 
} 


System.out.println(ex.toString()); 


} 


/* 
Output: 
The next letter read after reset is: e 


*/ 











Remarks 


The default implementation for markSupported always returns false. Subclasses should return true if they implement 
functionality for supporting mark and reset. 
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Reader.read Method 


Reads the next character or 


Overload List 
Name 


Reader.read () 


Reader.read (char[]) 


characters of the characters to be read. 


Description 


Reads the next character of the characters to be read. 


Reads the characters in the array starting at an offset for the length specified and stores them in th 
e provided array of characters. 





Reader.read (char[], int, int) 





See Also 
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Reads the characters starting at an offset for the length specified, and stores them in the provided 
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Reader.read Method () 


Reads the next character of the characters to be read. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read() throws java.io. IOException; 


Return Value 


A numeric value of the character that was read. Derived classes use this return value differently. Consult the documentation for 
the particular reader that you are using. 


Example 


The following example demonstrates how to read one character at a time from the StringReader buffer, which is a 
specialization of the abstract Reader class. 


// reader_read.jsl 
import java.io.*; 


public class Program 


1 


public static void main(String[] args) 
1 
try 
{ 
// Create a new StringReader. 
String s = "Hello"; 
StringReader reader = new StringReader(s); 


// Read from the underlying string. 
for (int i = @; i < s.length(); i++) 


if (reader.ready()) 
{ 


char charRead = (char)reader.read(); 
System.out.println(charRead) ; 


} 


else 


{ 
} 


break; 


} 


// Close the StringReader. 
reader.close(); 


catch (IOException ex) 


{ 
System.out.println(ex.toString()); 


fo) 
mi 
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Reader.read Method (Char[]) 


Reads the characters in the array starting at an offset for the length specified and stores them in the provided array of 
characters. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read( 
char[] buf) throws java.io. IOException; 


Parameters 


buf 

The array of characters to store the characters read. 
Return Value 
The number of characters read. 


See Also 
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Reader.read Method (CharT J, Int32, Int32) 


Reads the characters starting at an offset for the length specified, and stores them in the provided array of characters. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract int read( 
char[] buf, 
int offset, 
int count) throws java.io. IOException; 


Parameters 


buf 
The array of characters to store the characters read. 
offset 


An offset into the characters. This value represents the index of the first character to be read. This value must be greater than 
zero. 


count 


The number of characters to be read starting from the offset. This value plus the offset must be less than the overall length of 
the characters. 


Return Value 

The number of characters read. 

Example 

The following example demonstrates how to read from the StringReader buffer and populate an already existing array with the 


contents just read. The StringReader class is a specialization of the abstract Reader class. 


// reader_read_2.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
try 
{ 


// Create a new StringReader. 
String s = "Hello"; 
StringReader reader = new StringReader(s); 


// Read from the underlying array. 
char[] newArr = new char[s.length() + 6]; 


newArr[6] = ‘'W'; 
newArr[7] = '0'5 
newArr[8] = 'r'; 
newArr[9] = '1'; 
newArr[10] = 'd'; 


reader.read(newArr, 8, s.length()); 
System.out.println("The new array contains: " + 
newArr) ; 


// Close the StringReader. 
reader.close(); 


catch (IOException ex) 


: 
System. out.print1ln(ex.toString()); 
} 
} 
} 
/* 
Output: 


The new array contains: Hello World 


*/ 











See Also 
Reference 
Reader Class 
Concepts 

Reader Members 
java.io Package 
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Reader.ready Method 


Determines whether the reader is ready for reading. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean ready() throws java.io. IOException; 


Return Value 
true if the characters are ready for reading; false otherwise. 
Example 


The following example demonstrates how to determine if a StringReader object is ready for reading. The StringReader class is 
a specialization of the abstract Reader class. 


// reader_ready.jsl 
import java.io.*; 


public class Program 


{ 


public static void main(String[] args) 


{ 
try 


{ 


// Create a new StringReader. 
String s = "Hello"; 
StringReader reader = new StringReader(s); 


// Read from the underlying string. 
for (int i = @; i < s.length(); i++) 


if (reader.ready()) 
{ 


char charRead = (char)reader.read(); 
System.out.println(charRead) ; 


} 


else 


{ 
} 


break; 


} 


// Close the StringReader. 
reader.close(); 


catch (IOException ex) 


{ 
System.out.printin(ex.toString()); 


ef 





Remarks 


The default implementation for ready always returns false. Subclasses should override this method and return the appropriate 
boolean value. 


See Also 
Reference 
Reader Class 
Concepts 

Reader Members 
java.io Package 
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Reader.reset Method 


Resets the reader for the characters such that the next character read is the character that is marked. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void reset() throws java.io. IOException; 


Example 


The following example demonstrates the effect that the mark method has when you call reset. The StringReader class is a 
specialization of the abstract Reader class. 


// reader_reset.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
try 
{ 
// Create a new StringReader. 
String s = "Hello"; 
StringReader reader = new StringReader(s); 
// Read from the underlying string one at a time. 
char firstLetter = (char)reader.read(); 
// Set the mark. 
if (reader.markSupported()) 
// The @ is ignored. 
reader.mark(@) ; 
} 
// Continue reading from the string. 
char secondLetter = (char)reader.read(); 
char thirdLetter = (char)reader.read(); 
char fourthLetter = (char)reader.read(); 
char fifthLetter = (char)reader.read(); 
// Reset the StringReader. 
reader.reset(); 
// Get the first character read after the reset. 
char nextLetter = (char)reader.read(); 
System.out.println("The next letter read after reset is: " + 
nextLetter) ; 
// Close the StringReader. 
reader.close(); 
} 
catch (IOException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 
} 


p® 


Output: 
The next letter read after reset is: 
ey, 





See Also 
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Reader.skip Method 


Skips over the next count characters of the characters being read or until the end of the array, whichever is less. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public long skip( 
long count) throws java.io.IOException; 


Parameters 


count 


The number of characters to skip over. This value must be greater than zero. If this number is greater than the number of 
characters remaining, then only the number of remaining characters will be skipped. 


Return Value 

The number of characters skipped. 

Example 

The following example demonstrates how to skip over character while you are performing a read operation on a StringReader 


object, which is a specialization of the abstract Reader class. 


// reader_skip.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
1 
try 
{ 


// Create a new StringReader. 
String s = "Hello"; 
StringReader reader = new StringReader(s); 


// Read from the underlying string. 
for (int i = @; i < s.length(); i++) 


if (reader.ready()) 


{ 
char charRead = (char)reader.read(); 
System.out.println(charRead) ; 
// Skip over one character. 
long num = reader.skip(1); 
System.out.printlin("skipping " + num); 
} 
else 
{ 
break; 
} 


// Close the StringReader. 
reader.close(); 


catch (IOException ex) 
{ 


i 


System.out.println(ex.toString()); 


} 


/* 

Output: 

H 

skipping 1 
dl 


skipping 1 
fo) 
skipping @ 
? 
skipping @ 
? 


skipping @ 
i 





See Also 
Reference 
Reader Class 
Concepts 
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java.io Package 
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Reader.toString Method 


Displays a human readable representation of the reader. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


Return Value 
A human readable representation of the reader. 


See Also 
Reference 
Reader Class 
Concepts 

Reader Members 
java.io Package 
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SequencelnputStream Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.SequenceInputStream 
extends java.io.InputStream 





Inheritance Hierarchy 

java.lang.Object 
java.io.InputStream 
java.io.SequencelnputStream 


See Also 

Concepts 

SequencelnputStream Members 
java.io Package 
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SequencelnputStream Members 


The following tables list the members exposed by the SequencelnputStream type. 


Public Constructors 









































Name 

SequencelnputStream 

Public Methods 

Name Description 

available Overridden. 

close Overridden. 

equals (inherited from Object ) 
hashCode (inherited from Object ) 
getClass (inherited from Object ) 

mark (inherited from InputStream ) 
markSupported (inherited from InputStream ) 
clone (inherited from InputStream ) 
read Overloaded. Overridden. 
reset (inherited from InputStream ) 
skip (inherited from InputStream ) 
toString (inherited from InputStream ) 
Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 

SequencelnputStream Class 

Concepts 


java.io Package 


Visual J# Reference 


SequencelnputStream Constructor 


Overload List 





Name Description 





SequencelnputStream (Enumeration) 





SequencelnputStream (InputStream, InputStream) 











See Also 

Reference 
SequencelnputStream Class 
Concepts 

SequencelnputStream Members 
java.io Package 
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SequencelnputStream Constructor (Enumeration) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.SequenceInputStream( 
java.util.Enumeration e); 


Parameters 
e 


See Also 

Reference 
SequencelnputStream Class 
Concepts 

SequencelnputStream Members 
java.io Package 
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SequencelnputStream Constructor (InputStream, InputStream) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.SequenceInputStream( 
java.io.InputStream si, 
java.io.InputStream s2); 


Parameters 
s1 


s2 


See Also 

Reference 
SequencelnputStream Class 
Concepts 

SequencelnputStream Members 
java.io Package 
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SequencelnputStream Methods 


Public Methods 









































Name Description 

available Overridden. 

close Overridden. 

equals (inherited from Object ) 
hashCode (inherited from Object ) 
getClass (inherited from Object ) 

mark (inherited from InputStream ) 
markSupported (inherited from InputStream ) 
clone (inherited from InputStream ) 
read Overloaded. Overridden. 
reset (inherited from InputStream ) 
skip (inherited from InputStream ) 
toString (inherited from InputStream ) 
Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 

SequencelnputStream Class 

Concepts 


java.io Package 
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SequencelnputStream.available Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int available() throws java.io. IOException; 


See Also 

Reference 
SequencelnputStream Class 
Concepts 

SequencelnputStream Members 
java.io Package 
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SequencelnputStream.close Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void close() throws java.io. IOException; 


See Also 

Reference 
SequencelnputStream Class 
Concepts 

SequencelnputStream Members 
java.io Package 
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SequencelnputStream.read Method 


Overload List 





Name Description 





SequencelnputStream.read () 





SequencelnputStream.read (byte[]) 





SequencelnputStream.read (bytef], int, int) 











See Also 

Reference 
SequencelnputStream Class 
Concepts 

SequencelnputStream Members 
java.io Package 
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SequencelnputStream.read Method () 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read() throws java.io. IOException; 


See Also 

Reference 
SequencelnputStream Class 
Concepts 

SequencelnputStream Members 
java.io Package 
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SequencelnputStream.read Method (SByte[ ], Int32, Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read( 
byte[] b, 
int off, 
int len) throws java.io. IOException; 


Parameters 


b 


off 
len 


See Also 

Reference 
SequencelnputStream Class 
Concepts 

SequencelnputStream Members 
java.io Package 


Visual J# Reference 


StreamCorruptedException Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.StreamCorruptedException 
extends java.io.ObjectStreamException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.io.IOException 
java.io.ObjectStreamException 
java.io.StreamCorruptedException 


See Also 

Concepts 

StreamCorruptedException Members 
java.io Package 
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StreamCorruptedException Members 


The following tables list the members exposed by the StreamCorruptedException type. 


Public Constructors 
Name 


StreamCorruptedException 


Public Properties (see also Protected Properties ) 














Name Description 

HelpLink (inherited from Exception ) 
InnerException (inherited from Exception ) 
Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 


Protected Properties 





Name Description 





HResult (inherited from Exception ) 








Public Methods 











Name Description 

equals (inherited from Object ) 
filllnStackTrace (inherited from Throwable ) 
GetBaseException (inherited from Exception ) 
hashCode (inherited from Object ) 
getLocalizedMessage (inherited from Throwable ) 
getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 
clone (inherited from Throwable ) 
printStackTrace Overloaded. (inherited from Throwable ) 





toString (inherited from Throwable ) 











Protected Methods 





See Also 

Reference 
StreamCorruptedException Class 
Concepts 
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StreamCorruptedException Constructor 


Overload List 





Name Description 





StreamCorruptedException () 





StreamCorruptedException (String) 





StreamCorruptedException (SerializationInfo, StreamingContext) 





StreamCorruptedException (String, Exception) 














See Also 

Reference 
StreamCorruptedException Class 
Concepts 

StreamCorruptedException Members 
java.io Package 
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StreamCorruptedException Constructor () 


Initializes a new instance of the StreamCorruptedException Class . 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.StreamCorruptedException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
StreamCorruptedException Class 
Concepts 

StreamCorruptedException Members 
java.io Package 
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StreamCorruptedException Constructor (String) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.StreamCorruptedException( 
java.lang.String msg); 


Parameters 
msg 


See Also 

Reference 
StreamCorruptedException Class 
Concepts 

StreamCorruptedException Members 
java.io Package 
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StreamCorruptedException Constructor (SerializationInfo, 
StreamingContext) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected java.io.StreamCorruptedException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


context 


See Also 

Reference 
StreamCorruptedException Class 
Concepts 

StreamCorruptedException Members 
java.io Package 
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StreamCorruptedException Constructor (String, Exception) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.StreamCorruptedException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
S 


inner 


See Also 

Reference 
StreamCorruptedException Class 
Concepts 

StreamCorruptedException Members 
java.io Package 
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StreamCorruptedException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


StreamCorruptedException Class 


Concepts 
java.io Package 
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StreamCorruptedException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 


StreamCorruptedException Class 


Concepts 
java.io Package 
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StreamTokenizer Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.StreamTokenizer 
extends java.lang.Object 





Inheritance Hierarchy 
java.lang.Object 
java.io.StreamTokenizer 


See Also 

Concepts 

StreamTokenizer Members 
java.io Package 
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StreamTokenizer Members 


The following tables list the members exposed by the StreamTokenizer type. 


Public Constructors 
Name 


StreamTokenizer 


Public Fields 


Description 








Name 


Description 





nval 





sval 


TTLEOF 


TT_EOL 


TT_NUMBER 


TT_WORD 


ttype 





Public Methods 








Name 


Description 





commentChar 





eollsSignificant 





equals 


(inherited from Object ) 





hashCode 


(inherited from Object ) 





getClass 


(inherited from Object ) 





lineno 





lowerCaseMode 





clone 





nextToken 


ordinaryChar 


ordinaryChars 


parseNumbers 














pushBack 





quoteChar 


resetSyntax 


slashSlashComments 


slashStarComments 


toString 


whitespaceChars 


wordChars 


Overridden. 





Protected Methods 


Name Description 


finalize (inherited from Object ) 








See Also 

Reference 
StreamTokenizer Class 
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java.io Package 
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StreamTokenizer Fields 


Public Fields 





Name 


Description 





nval 





sval 





TT_EOF 





TT_EOL 





TT_NUMBER 


TT_WORD 


ttype 





See Also 

Reference 
StreamTokenizer Class 
Concepts 

java.io Package 
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StreamTokenizer.nval Field 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public double nval; 





See Also 

Reference 
StreamTokenizer Class 
Concepts 

StreamTokenizer Members 
java.io Package 
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StreamTokenizer.sval Field 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public java.lang.String sval; 





See Also 

Reference 
StreamTokenizer Class 
Concepts 

StreamTokenizer Members 
java.io Package 
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StreamTokenizer.TT_ EOF Field 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public static final int TT_EOF; 





See Also 

Reference 
StreamTokenizer Class 
Concepts 

StreamTokenizer Members 
java.io Package 
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StreamTokenizer.TT_ EOL Field 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public static final int TT_EOL; 





See Also 

Reference 
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java.io Package 
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StreamTokenizer.TT_ NUMBER Field 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public static final int TT_NUMBER; 


See Also 

Reference 
StreamTokenizer Class 
Concepts 

StreamTokenizer Members 
java.io Package 
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StreamTokenizer.TT_ WORD Field 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public static final int TT_WORD; 


See Also 

Reference 
StreamTokenizer Class 
Concepts 

StreamTokenizer Members 
java.io Package 
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StreamTokenizer.ttype Field 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public int ttype; 





See Also 

Reference 
StreamTokenizer Class 
Concepts 

StreamTokenizer Members 
java.io Package 
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StreamTokenizer Constructor 


Overload List 





Name Description 





StreamTokenizer (InputStream) 





StreamTokenizer (Reader) 











See Also 
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StreamTokenizer Constructor (InputStream) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.StreamTokenizer( 
java.io.InputStream in); 


Parameters 
in 


See Also 

Reference 
StreamTokenizer Class 
Concepts 

StreamTokenizer Members 
java.io Package 
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StreamTokenizer Constructor (Reader) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.StreamTokenizer( 
java.io.Reader reader); 


Parameters 
reader 


See Also 

Reference 
StreamTokenizer Class 
Concepts 

StreamTokenizer Members 
java.io Package 
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StreamTokenizer Methods 


Public Methods 





Name Description 





commentChar 





eollsSignificant 





equals (inherited from Object ) 





hashCode (inherited from Object ) 





getClass (inherited from Object ) 
lineno 

lowerCaseMode 

clone 

nextToken 

ordinaryChar 

ordinaryChars 

parseNumbers 

pushBack 

quoteChar 

resetSyntax 

slashSlashComments 

slashStarComments 

toString Overridden. 
whitespaceChars 


wordChars 





Protected Methods 


Name Description 


finalize (inherited from Object ) 








See Also 
Reference 
StreamTokenizer Class 
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StreamTokenizer.clone Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 





See Also 

Reference 
StreamTokenizer Class 
Concepts 

StreamTokenizer Members 
java.io Package 
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StreamTokenizer.commentChar Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void commentChar ( 
int ch); 


Parameters 
ch 


See Also 

Reference 
StreamTokenizer Class 
Concepts 

StreamTokenizer Members 
java.io Package 
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StreamTokenizer.eollsSignificant Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void eolIsSignificant( 
boolean flag); 


Parameters 


flag 


See Also 

Reference 
StreamTokenizer Class 
Concepts 

StreamTokenizer Members 
java.io Package 
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StreamTokenizer.lineno Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int lineno(); 


See Also 

Reference 
StreamTokenizer Class 
Concepts 

StreamTokenizer Members 
java.io Package 
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StreamTokenizer.lowerCaseMode Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void lowerCaseMode( 
boolean flag); 


Parameters 


flag 


See Also 

Reference 
StreamTokenizer Class 
Concepts 

StreamTokenizer Members 
java.io Package 
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StreamTokenizer.nextToken Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int nextToken() throws java.io. IOException; 


See Also 

Reference 
StreamTokenizer Class 
Concepts 

StreamTokenizer Members 
java.io Package 
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StreamTokenizer.ordinaryChar Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void ordinaryChar( 
int ch); 


Parameters 
ch 


See Also 

Reference 
StreamTokenizer Class 
Concepts 

StreamTokenizer Members 
java.io Package 
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StreamTokenizer.ordinaryChars Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void ordinaryChars( 
int low, 
int hi); 


Parameters 
low 


hi 


See Also 

Reference 
StreamTokenizer Class 
Concepts 

StreamTokenizer Members 
java.io Package 
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StreamTokenizer.parseNumbers Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void parseNumbers(); 


See Also 

Reference 
StreamTokenizer Class 
Concepts 

StreamTokenizer Members 
java.io Package 
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StreamTokenizer.pushBack Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void pushBack(); 


See Also 

Reference 
StreamTokenizer Class 
Concepts 

StreamTokenizer Members 
java.io Package 
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StreamTokenizer.quoteChar Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void quoteChar( 
int ch); 


Parameters 
ch 


See Also 

Reference 
StreamTokenizer Class 
Concepts 

StreamTokenizer Members 
java.io Package 


Visual J# Reference 


StreamTokenizer.resetSyntax Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void resetSyntax(); 


See Also 

Reference 
StreamTokenizer Class 
Concepts 

StreamTokenizer Members 
java.io Package 
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StreamTokenizer.slashSlashComments Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void slashSlashComments( 
boolean flag); 


Parameters 


flag 


See Also 

Reference 
StreamTokenizer Class 
Concepts 

StreamTokenizer Members 
java.io Package 
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StreamTokenizer.slashStarComments Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void slashStarComments( 
boolean flag); 


Parameters 


flag 


See Also 

Reference 
StreamTokenizer Class 
Concepts 

StreamTokenizer Members 
java.io Package 
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StreamTokenizer.toString Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toString(); 


See Also 

Reference 
StreamTokenizer Class 
Concepts 

StreamTokenizer Members 
java.io Package 
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StreamTokenizer.whitespaceChars Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void whitespaceChars ( 
int low, 
int hi); 


Parameters 
low 


hi 


See Also 

Reference 
StreamTokenizer Class 
Concepts 

StreamTokenizer Members 
java.io Package 
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StreamTokenizer.wordChars Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void wordChars( 
int low, 
int hi); 


Parameters 
low 


hi 


See Also 

Reference 
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StreamTokenizer Members 
java.io Package 


Visual J# Reference 


StringBufferlnputStream Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.StringBufferInputStream 
extends java.io.InputStream 





Inheritance Hierarchy 

java.lang.Object 
java.io.InputStream 
java.io.StringBufferlnputStream 


See Also 

Concepts 

StringBufferInputStream Members 
java.io Package 
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StringBufferlnputStream Members 


The following tables list the members exposed by the StringBufferlnputStream type. 


Public Constructors 






























































Name Description 
StringBufferInputStream 

Public Fields 

Name Description 

buffer 

count 

pos 

Public Methods 

Name Description 

available Overridden. 

close (inherited from InputStream ) 
equals (inherited from Object ) 
hashCode (inherited from Object ) 
getClass (inherited from Object ) 

mark (inherited from InputStream ) 
markSupported (inherited from InputStream ) 
clone (inherited from InputStream ) 
read Overloaded. Overridden. 
reset Overridden. 

skip Overridden. 

toString (inherited from InputStream ) 








Protected Methods 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


StringBufferInputStream Class 


Concepts 
java.io Package 
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StringBufferlnputStream Fields 


Public Fields 





Name Description 





buffer 





count 








pos 











See Also 

Reference 
StringBufferInputStream Class 
Concepts 

java.io Package 
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StringBufferlnputStream.buffer Field 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected java.lang.String buffer; 


See Also 

Reference 
StringBufferInputStream Class 
Concepts 

StringBufferInputStream Members 
java.io Package 
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StringBufferlnputStream.count Field 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected int count; 


See Also 

Reference 
StringBufferInputStream Class 
Concepts 

StringBufferInputStream Members 
java.io Package 
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StringBufferlnputStream.pos Field 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 





protected int pos; 





See Also 

Reference 
StringBufferInputStream Class 
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StringBufferlnputStream Constructor 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.StringBufferInputStream( 
java.lang.String s); 


Parameters 
S 


See Also 

Reference 
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StringBufferlnputStream Methods 


Public Methods 






































Name Description 

available Overridden. 

close (inherited from InputStream ) 
equals (inherited from Object ) 
hashCode (inherited from Object ) 
getClass (inherited from Object ) 

mark (inherited from InputStream ) 
markSupported (inherited from InputStream ) 
clone (inherited from InputStream ) 
read Overloaded. Overridden. 
reset Overridden. 

skip Overridden. 

toString (inherited from InputStream ) 
Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 
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StringBufferlnputStream.available Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized int available(); 


See Also 

Reference 
StringBufferInputStream Class 
Concepts 
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StringBufferlnputStream.read Method 


Overload List 





Name Description 





StringBufferlnputStream.read () 





StringBufferInputStream.read (byte[]) 





StringBufferInputStream.read (byte[], int, int) 











See Also 
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StringBufferlnputStream.read Method () 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized int read(); 


See Also 

Reference 
StringBufferInputStream Class 
Concepts 

StringBufferInputStream Members 
java.io Package 
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StringBufferlnputStream.read Method (SByte[ ], Int32, Int32) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized int read( 
byte[] b, 
int off, 
int len); 


Parameters 


b 


off 
len 


See Also 

Reference 
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StringBufferlnputStream.reset Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized void reset(); 


See Also 

Reference 
StringBufferInputStream Class 
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StringBufferlnputStream.skip Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public synchronized long skip( 
long n); 


Parameters 
n 


See Also 
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StringReader Class 


Provides an implementation of the abstract Reader class used to read characters from a given string. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.StringReader 
extends java.io.Reader 


Example 

The following example demonstrates the close, mark, markSupported, read, and reset methods of the StringReader class. 
// stringreader_overview.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
try 
{ 
// Create a new StringReader. 
String s = "Hello"; 
StringReader reader = new StringReader(s); 
// Read from the underlying string one at a time. 
char firstLetter = (char)reader.read(); 
// Set the mark. 
if (reader.markSupported()) 
// The @ is ignored. 
reader.mark(@); 
} 
// Continue reading from the string. 
char secondLetter = (char)reader.read(); 
char thirdLetter = (char)reader.read(); 
char fourthLetter = (char)reader.read(); 
char fifthLetter = (char)reader.read(); 
// Reset the StringReader. 
reader.reset(); 
// Get the first character read after the reset. 
char nextLetter = (char)reader.read(); 
System.out.printlin("The next letter read after reset is: " + 
nextLetter) ; 
// Close the StringReader. 
reader.close(); 
catch (IOException ex) 
{ 
System. out.println(ex.toString()); 
} 
} 
} 


/* 


Output: 
The next letter read after reset is: 


ur 





Inheritance Hierarchy 

java.lang.Object 
java.io.Reader 
java.io.StringReader 


See Also 

Concepts 

StringReader Members 
java.io Package 
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StringReader Members 


Provides an implementation of the abstract Reader class used to read characters from a given string. 


The following tables list the members exposed by the StringReader type. 


Public Constructors 



































Name Description 

StringReader Initializes a new instance of a StringReader object with the given string. 
Public Fields 

Name [Description 

lock The object used to synchronize operations on the reader.(inherited from Reader) 
Public Methods 

Name Description 

close Overridden. Closes the reader. 

equals (inherited from Object ) 

hashCode (inherited from Object ) 

getClass (inherited from Object ) 

mark Overridden. Sets the mark to the next character in the string to be read. 
markSupported |Overridden. Determines whether this reader supports marking. 

clone Creates a shallow copy of the object. (inherited from Reader) 

read Overloaded. Overridden. Reads the next character or characters in the string. 
ready Overridden. Determines whether the reader is ready for reading. 

reset Overridden. Resets the reader for the string such that the next character read is the character that is marked. 
skip Overridden. Skips over the next n characters in the string or until the end of the string, whichever is less. 
toString Displays a human readable representation of the reader. (inherited from Reader) 
Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 
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StringReader Fields 


Public Fields 





Name _ Description 





lock The object used to synchronize operations on the reader. (inherited from Reader ) 











See Also 
Reference 
StringReader Class 
Concepts 

java.io Package 
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StringReader Constructor 


Initializes a new instance of a StringReader object with the given string. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.StringReader ( 


java.lang.String s); 
| 


Parameters 
Ss 


The string to be read. 


See Also 

Reference 
StringReader Class 
Concepts 

StringReader Members 
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StringReader Methods 


Public Methods 






































Name Description 

close Overridden. Closes the reader. 

equals (inherited from Object ) 

hashCode (inherited from Object ) 

getClass (inherited from Object ) 

mark Overridden. Sets the mark to the next character in the string to be read. 

markSupported |Overridden. Determines whether this reader supports marking. 

clone Creates a shallow copy of the object. (inherited from Reader ) 

read Overloaded. Overridden. Reads the next character or characters in the string. 

ready Overridden. Determines whether the reader is ready for reading. 

reset Overridden. Resets the reader for the string such that the next character read is the character that is marked. 
skip Overridden. Skips over the next n characters in the string or until the end of the string, whichever is less. 
toString Displays a human readable representation of the reader. (inherited from Reader ) 

Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 
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StringReader.close Method 


Closes the reader. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void close(); 


Example 

The following example demonstrates how to close a StringReader object. 
// stringreader_close.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 


{ 
try 
{ 
// Create a new StringReader. 
String s = "Hello"; 
StringReader reader = new StringReader(s); 
// Read from the underlying String. 
char[] newArr = new char[s.length()]; 
reader.read(newArr) ; 
System.out.println("The new array contains: 
newArr) ; 
// Close the StringReader. 
reader.close(); 
} 
catch (IOException ex) 
{ 
System. out.print1ln(ex.toString()); 
} 
} 
} 
/* 
Output: 
The new array contains: Hello 
*// 
See Also 
Reference 
StringReader Class 
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StringReader.mark Method 


Sets the mark to the next character in the string to be read. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void mark( 
int readlimit) throws java.io. IOException; 


Parameters 
readlimit 


Ignored. 
Example 


The following example demonstrates the effect that the mark method has when you call reset. 


// stringreader_mark.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 
{ 
try 
{ 
// Create a new StringReader. 
String s = "Hello"; 
StringReader reader = new StringReader(s); 


// Read from the underlying string one at a time. 
char firstLetter = (char)reader.read(); 


// Set the mark. 
if (reader.markSupported()) 


// The @ is ignored. 
reader.mark(@); 


} 


// Continue reading from the string. 
char secondLetter = (char)reader.read(); 
char thirdLetter = (char)reader.read(); 
char fourthLetter = (char)reader.read(); 
char fifthLetter = (char)reader.read(); 


// Reset the StringReader. 
reader.reset(); 


// Get the first character read after the reset. 

char nextLetter = (char)reader.read(); 

System.out.println("The next letter read after reset is: 
nextLetter) ; 


// Close the StringReader. 
reader.close(); 


} 
catch (IOException ex) 


{ 
} 


System.out.printin(ex.toString()); 


} 


/* 
Output: 


*/ 





The next letter read after reset is: 


e 





See Also 
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StringReader.markSupported Method 


Determines whether this reader supports marking. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean markSupported(); 


Return Value 
Always true. 


Example 


The following example demonstrates the effect that the mark method has when you call reset. 


// stringreader_marksupported.jsl 


import java. 


io.*; 


public class Program 


public static void main(String[] args) 


// Create a new StringReader. 
String s = "Hello"; 
StringReader reader = new StringReader(s); 


// Read from the underlying string one at a time. 
char firstLetter = (char)reader.read(); 


// Set the mark. 
if (reader.markSupported()) 


// The @ is ignored. 
reader.mark(@) ; 


} 


// Continue reading from the string. 

char secondLetter = (char)reader.read(); 
char thirdLetter = (char)reader.read(); 
char fourthLetter = (char)reader.read(); 
char fifthLetter = (char)reader.read(); 


// Reset the StringReader. 
reader.reset(); 


// Get the first character read after the reset. 
char nextLetter = (char)reader.read(); 


System.out.println("The next letter read after reset is: 


nextLetter) ; 


// Close the StringReader. 
reader.close(); 


catch (IOException ex) 


{ 
if 
try 
{ 
{ 
} 
} 


System.out.printin(ex.toString()); 


/* 
Output: 


The next letter read after reset is: 


*/ 


e 





See Also 
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StringReader.read Method 


Reads the next character or characters in the string. 


Overload List 


Name Description 
StringReader.read () Reads the next character in the string. 
StringReader.read (char[]) Reads the characters in the array starting at an offset for the length specified and stores the 


m in the provided array of characters. 





StringReader.read (char[], int, int)/Reads the characters in the underlying string for the length specified and stores them in the 
provided array of characters, starting at an offset. 








See Also 
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StringReader.read Method () 


Reads the next character in the string. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read() throws java.io. IOException; 


Return Value 


The numeric value of the character read from the current position in string, or -1 if all the characters were already read. 


Example 


The following example demonstrates how to read one character at a time from the StringReader buffer. 


// stringreader_read.jsl 
import java.io.*; 


public class Program 


{ 


public static void main(String[] args) 


if 
try 


{ 


// Create a new StringReader. 
String s = "Hello"; 
StringReader reader = new StringReader(s); 


// Read from the underlying string. 
for (int i = @; i < s.length(); i++) 


{ 
if (reader.ready()) 


{ 


char charRead = (char)reader.read(); 
System.out.println(charRead) ; 


} 


else 


break; 


} 


// Close the StringReader. 
reader.close(); 


catch (IOException ex) 


{ 
System.out.println(ex.toString()); 


See Also 
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StringReader.read Method (CharT J, Int32, Int32) 


Reads the characters in the underlying string for the length specified and stores them in the provided array of characters, 
starting at an offset. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public int read( 
char[] b, 
int off, 
int len) throws java.io.IOException; 


Parameters 


b 
The array of characters to store the characters read. 


off 


An offset into the array of characters. This value represents the index of the first character in the array to be written. This 
value must be greater than zero. 


len 


The number of characters to be read from the underlying string. This value plus the offset must be less than the overall 
length of the array. 


Return Value 
The number of characters read. 
Example 


The following example demonstrates how to read from the StringReader buffer and populate an already existing array with the 
contents just read. 


// stringreader_read_2.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 
{ 
try 
{ 
// Create a new StringReader. 
String s = "Hello"; 
StringReader reader = new StringReader(s); 


// Read from the underlying array. 

char[] newArr = new char[s.length() + 6]; 
newArr[6] = ‘W' 

newArr[7] = 'o 
newArr[8] = 'r 
newArr[9] = '1' 
newArr[1@] = ‘'d'; 


J 
3 
) 
3 

1 


reader.read(newArr, @, s.length()); 
System.out.println("The new array contains: " + 
newArr) ; 


// Close the StringReader. 
reader.close(); 


catch (IOException ex) 


: System. out.println(ex.toString()); 
} 
} 
} 
/* 
Output: 


The new array contains: Hello World 
aa 
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StringReader.ready Method 


Determines whether the reader is ready for reading. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public boolean ready(); 


Return Value 
Always true. 
Example 


The following example demonstrates how to determine if a StringReader object is ready for reading. 


// stringreader_ready.jsl 
import java.io.*; 


public class Program 


{ 


public static void main(String[] args) 


if 
try 


{ 


// Create a new StringReader. 
String s = "Hello"; 
StringReader reader = new StringReader(s); 


// Read from the underlying string. 
for (int i = @; i < s.length(); i++) 


{ 
if (reader.ready()) 


{ 


char charRead = (char)reader.read(); 
System.out.println(charRead) ; 


} 


else 


break; 


} 


// Close the StringReader. 
reader.close(); 


catch (IOException ex) 


{ 
System.out.println(ex.toString()); 


See Also 
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StringReader.reset Method 


Resets the reader for the string such that the next character read is the character that is marked. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void reset() throws java.io. IOException; 


Example 

The following example demonstrates the effect that the mark method has when you call reset. 
// stringreader_reset.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 


{ 
try 
{ 
// Create a new StringReader. 
String s = "Hello"; 
StringReader reader = new StringReader(s); 
// Read from the underlying string one at a time. 
char firstLetter = (char)reader.read(); 
// Set the mark. 
if (reader.markSupported()) 
// The @ is ignored. 
reader.mark(@) ; 
} 
// Continue reading from the string. 
char secondLetter = (char)reader.read(); 
char thirdLetter = (char)reader.read(); 
char fourthLetter = (char)reader.read(); 
char fifthLetter = (char)reader.read(); 
// Reset the StringReader. 
reader.reset(); 
// Get the first character read after the reset. 
char nextLetter = (char)reader.read(); 
System.out.println("The next letter read after reset is: " 
nextLetter) ; 
// Close the StringReader. 
reader.close(); 
} 
catch (IOException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 
} 
/* 


Output: 


The next letter read after reset is: e 
oy 


See Also 
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StringReader.skip Method 


Skips over the next n characters in the string or until the end of the string, whichever is less. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public long skip( 
long n) throws java.io.IOException; 


Parameters 


n 


The number of characters to skip over. This value must be greater than zero. If this number is greater than the number of 
characters remaining in the string, then only the number of remaining characters will be skipped. 


Return Value 
The number of characters skipped. 
Example 
The following example demonstrates how to skip over character while you are performing a read operation on a StringReader 
object. 
// stringreader_skip.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
1 
try 
{ 


// Create a new StringReader. 
String s = "Hello"; 
StringReader reader = new StringReader(s); 


// Read from the underlying string. 
for (int i = @; i < s.length(); i++) 


if (reader.ready()) 


{ 
char charRead = (char)reader.read(); 
System.out.println(charRead) ; 
// Skip over one character. 
long num = reader.skip(1); 
System.out.printlin("skipping " + num); 
} 
else 
{ 
break; 
} 


// Close the StringReader. 
reader.close(); 


catch (IOException ex) 
{ 


i 


System.out.println(ex.toString()); 


} 


/* 

Output: 

H 

skipping 1 
dl 


skipping 1 
fo) 
skipping @ 
? 
skipping @ 
? 


skipping @ 
i 
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StringWriter Class 


Provides an implementation of the abstract Writer class used to write characters into a StringBuffer object that can be resized 
as required. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.StringWriter 
extends java.io.Writer 


Example 


The following example demonstrates the close, flush, getBuffer, and write methods of the StringWriter class. 


// stringwriter_overview.jsl 
import java.io.*; 


public class Program 


{ 


public static void main(String[] args) 


{ 
// Create a StringWriter object. 


StringWriter writer = new StringWriter(); 


// Write some data to the StringWriter object. 

// Start with the 7th character and write to the end. 
String s = "Hello World"; 

writer.write("Hello World", 6, s.length() - 6); 


// Print out the contents of the StringWriter buffer. 
System.out.println("The StringWriter buffer contains: " + 
writer.toString()); 


// Now flush the buffer we just populated. 
writer.flush(); 


// Print out the contents of the StringWriter buffer. 
System.out.println("The post-flush StringWriter buffer " + 
"contains: " + writer.getBuffer().toString()); 


// Close the StringWriter buffer. 
writer.close(); 


} 
/* 
Output: 
The StringWriter buffer contains: World 
The post-flush StringWriter buffer contains: World 
oy 

Inheritance Hierarchy 

java.lang.Object 

java.io.Writer 


java.io.StringWriter 


See Also 
Concepts 


StringWriter Members 
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StringWriter Members 


Provides an implementation of the abstract Writer class used to write characters into a StringBuffer object that can be resized 
as required. 


The following tables list the members exposed by the StringWriter type. 


Public Constructors 





Overloaded. Initializes a new instance of a StringWriter object. 
Public Fields 


Name __ |Description 








lock The object used to synchronize operations on the writer.(inherited from Writer) 











Public Methods 





Name ___ Description 





close Overridden. Closes the writer once the string has been processed. 





equals _|(inherited from Object ) 





flush Overridden. Flushes the buffer representing the string to be written. 





getBuffer |Retrieves the StringBuffer object used to store the string. 





hashCodei(inherited from Object ) 


getClass |(inherited from Object ) 
clone Creates a shallow copy of this reader. (inherited from Writer) 


toString |Overridden. Displays a human readable representation of a StringWriter object. The contents of the buffer holding t 
he string is returned. 





write Overloaded. Appends a character or characters to the end of the string buffer. 








Protected Methods 


Name Description 


finalize (inherited from Object ) 











See Also 
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StringWriter Fields 


Public Fields 





Name |Description 





lock The object used to synchronize operations on the writer. (inherited from Writer ) 














See Also 
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StringWriter Constructor 


Initializes a new instance of a StringWriter object. 


Overload List 


Name Description 


StringWriter () _ {Initializes a new instance of a StringWriter object. 





StringWriter (int)|Initializes a new instance of a StringWriter object. The buffer containing the string is initialized to the given si 











ze, 
See Also 
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StringWriter Constructor () 


Initializes a new instance of a StringWriter object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





public java.io.StringwWriter(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 
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StringWriter Constructor (Int32) 


Initializes a new instance of a StringWriter object. The buffer containing the string is initialized to the given size. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected java.io.StringwWriter( 
int initialSize); 


Parameters 
initialSize 
The length for the buffer that will store the array of characters. This value must be greater than zero. 


See Also 
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StringWriter Methods 


Public Methods 





Name __ Description 





close Overridden. Closes the writer once the string has been processed. 





equals (inherited from Object ) 





flush Overridden. Flushes the buffer representing the string to be written. 





getBuffer |Retrieves the StringBuffer object used to store the string. 





hashCode\(inherited from Object ) 





getClass |(inherited from Object ) 





clone Creates a shallow copy of this reader. (inherited from Writer ) 





he string is returned. 





Protected Methods 


toString |Overridden. Displays a human readable representation of a StringWriter object. The contents of the buffer holding t 


write Overloaded. Appends a character or characters to the end of the string buffer. 





Name 


Description 





finalize 








(inherited from Object ) 
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StringWriter.close Method 


Closes the writer once the string has been processed. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void close(); 


Example 

The following example demonstrates how to close a StringWriter object. 
// stringwriter_close.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 


{ 
// Create a StringWriter object. 
StringWriter writer = new StringWriter(); 
// Write some data to the StringWriter object. 
char[] arr = new char[] {'H', ‘e', ‘l', 'l', ‘'o',7 
' aa ‘W', ‘o',*, a ae May ‘d' } 
for (int i = @; i < arr.length; i++) 
{ 
writer.write(arr[i]); 
} 
// Print out the contents of the StringWriter buffer. 
System.out.println("The StringWriter buffer contains: 
writer.getBuffer().toString()); 
// Close the StringWriter buffer. 
writer.close(); 
} 
} 
/* 
Output: 
The StringWriter buffer contains: Hello World 
m/f 
Remarks 


This method does nothing for StringWriter objects. 
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StringWriter.flush Method 


Flushes the buffer representing the string to be written. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void flush(); 


Example 


The following example demonstrates that the flush method for StringWriter objects has no effect on the underlying buffer. 


// stringwriter_flush.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 

{ 
// Create a StringWriter object. 
StringWriter writer = new StringWriter(); 


// Write some data to the StringWriter object. 
char[] arr = new char[] {'H', ‘e', ‘l', ‘l', ' 
' aa ‘W', ‘o',*, a ae May ‘d' } 


o'*" 
for (int i = @; i < arr.length; i++) 

{ 

} 


// Print out the contents of the StringWriter buffer. 
System.out.println("The StringWriter buffer contains: " + 
writer. getBuffer().toString()); 


writer.write(arr[i]); 


// Now flush the buffer we just populated. 
writer.flush(); 


// Print out the contents of the StringWriter buffer. 
System.out.println("The post-flush StringWriter buffer " + 
"contains: " + writer.getBuffer().toString()); 


// Close the StringWriter buffer. 
writer.close(); 


} 


/* 

Output: 

The StringWriter buffer contains: Hello World 

The post-flush StringWriter buffer contains: Hello World 


*/ 
Remarks 


This method does nothing for StringWriter objects. 


See Also 
Reference 
StringWriter Class 
Concepts 


StringWriter Members 
java.io Package 


Visual J# Reference 


StringWriter.getBuffer Method 


Retrieves the StringBuffer object used to store the string. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.lang.StringBuffer getBuffer(); 


Return Value 


The StringBuffer object used to store the string. This object is not a copy of the buffer that this writer is writing into. Any 
modifications made to the buffer will modify the buffer that this writer is using. 


Example 

The following example shows how to display the contents of the StringWriter buffer. 
// stringwriter_getbuffer.jsl 
import java.io.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
// Create a StringWriter object. 
StringWriter writer = new StringWriter(); 
// Write some data to the StringWriter object. 
char[] arr = new char[] {'H', ‘e', ‘l', 'l', ‘'o',7 
' mG ‘W', ‘o',*, "rs mL ‘d' }3 
for (int i = @; i < arr.length; i++) 
{ 
writer.write(arr[i]); 
} 
// Print out the contents of the StringWriter buffer. 
System.out.println("The StringWriter buffer contains: " + 
writer. getBuffer().toString()); 
// Close the StringWriter buffer. 
writer.close(); 
} 
/* 
Output: 
The StringWriter buffer contains: Hello World 
*/ 
See Also 
Reference 
StringWriter Class 
Concepts 


StringWriter Members 
java.io Package 


Visual J# Reference 


StringWriter.toString Method 


Displays a human readable representation of a StringWriter object. The contents of the buffer holding the string is returned. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toString(); 


Return Value 
A human readable representation of a StringWriter object. The contents of the buffer holding the string is returned. 


See Also 

Reference 
StringWriter Class 
Concepts 

StringWriter Members 
java.io Package 


Visual J# Reference 


StringWriter.write Method 


Appends a character or characters to the end of the string buffer. 


Overload List 


Name Description 

StringWriter.write (char[]) Places the given array of characters into the internal buffer holding the characters. 
StringWriter.write (int) Appends a character to the end of the string buffer. 

StringWriter.write (String) Appends a string of characters to the end of the string buffer. 


StringWriter.write (char[], int, int)|Appends the given string, starting from the offset and for the length specified, to the end of t 
he string buffer. 


StringWriter.write (String, int, int)|Appends a string, starting from the offset and for the length specified, to the end of the strin 
g buffer. 








See Also 

Reference 
StringWriter Class 
Concepts 

StringWriter Members 
java.io Package 
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StringWriter.write Method (Int32) 


Appends a character to the end of the string buffer. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
int oneChar); 


Parameters 
oneChar 


The character to append to the end of the string buffer. 
Example 
The following example shows how to write one character at a time to a StringWriter object. 
// stringwriter_write.jsl 
import java.io.*; 
public class Program 


public static void main(String[] args) 


{ 
// Create a StringWriter object. 
StringWriter writer = new StringWriter(); 
// Write some data to the StringWriter object. 
char[] arr = new char[] {'H', ‘e', ‘l', 'l', 'o',7 
' sy ‘Wi, "0" "rhy Ly 'd' } 
for (int i = @; i < arr.length; i++) 
{ 
writer.write(arr[i]); 
} 
// Print out the contents of the StringWriter buffer. 
System.out.println("The StringWriter buffer contains: " + 
writer. getBuffer().toString()); 
// Close the StringWriter buffer. 
writer.close(); 
} 
} 
/* 
Output: 
The StringWriter buffer contains: Hello World 
*/ 
See Also 
Reference 
StringWriter Class 
Concepts 


StringWriter Members 
java.io Package 


Visual J# Reference 


StringWriter.write Method (String) 


Appends a string of characters to the end of the string buffer. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
java.lang.String str); 


Parameters 


str 


The string to append to the end of the string buffer. 


Example 


The following example shows how to write a string to a StringWriter object. 


// stringwriter_write_2.jsl 


import java.io.*; 


public class Program 


public static void main(String[] args) 


{ 


} 
/* 


Output: 


// Create a StringWriter object. 
StringWriter writer = new StringWriter(); 


// Write some data to the StringWriter object. 
String s = "Hello world"; 
writer.write(s); 


// Print out the contents of the StringWriter buffer. 
System.out.println("The StringWriter buffer contains: 


writer. getBuffer().toString()); 


// Close the StringWriter buffer. 
writer.close(); 


The StringWriter buffer contains: Hello World 


*/ 


See Also 
Reference 


StringWriter Class 


Concepts 


StringWriter Members 
java.io Package 


Visual J# Reference 


StringWriter.write Method (Char[ ], Int32, Int32) 


Appends the given string, starting from the offset and for the length specified, to the end of the string buffer. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 


Parameters 


b 


char[] b, 


int off, 
int len); 


The array of characters to append to the string buffer. 


off 


An offset into the array of characters. This value represents the index of the first character in the array to be written to the 
string buffer. This value must be greater than zero. 


len 


The number of characters to be written to the string buffer starting from the offset. This value plus the offset must be less 
than the overall length of the array. 


Example 


The following example shows how to write an array of characters to an underlying StringWriter buffer. 


// stringwriter_write_3.jsl 


import java.io.*; 


public class Program 


{ 
{ 
} 
} 
/* 
Output: 


public static void main(String[] args) 


// Create a StringWriter object. 
StringWriter writer = new StringWriter(); 


// Write some data to the StringWriter object. 


char[] arr = new char[] {'H', ‘e', ‘l', 'l', 'o',7 
' G ‘Wi, ‘o',*, AI SS 'l', ‘d' } 


// Start with the 7th character and write to the end. 


writer.write(arr, 6, arr.length - 6); 


// Print out the contents of the StringWriter buffer. 
System.out.println("The StringWriter buffer contains: 


writer. getBuffer().toString()); 


// Close the StringWriter buffer. 
writer.close(); 


The StringWriter buffer contains: World 


i 


See Also 


Reference 
StringWriter Class 
Concepts 

StringWriter Members 
java.io Package 


Visual J# Reference 


StringWriter.write Method (String, Int32, Int32) 


Appends a string, starting from the offset and for the length specified, to the end of the string buffer. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
java.lang.String str, 
int off, 
int len); 


Parameters 


str 


The string to append to the end of the string buffer. 


off 


An offset into the string. This value represents the index of the first character in the string to be written to the string buffer. 
This value must be greater than zero. 


len 


The number of characters to be written to the string buffer starting from the offset. This value plus the offset must be less 
than the overall length of the string. 


Example 


The following example shows how to write a string to an underlying StringWriter buffer. 


// stringwriter_write_4.jsl 


import java.io.*; 


public class Program 


public static void main(String[] args) 


// Create a StringWriter object. 
StringWriter writer = new StringWriter(); 


// Write some data to the StringWriter object. 


// Start with the 7th character and write to the end. 


String s = "Hello World"; 
writer.write(s, 6, s.length() - 6); 


// Print out the contents of the StringWriter buffer. 
System.out.println("The StringWriter buffer contains: 


writer. getBuffer().toString()); 


// Close the StringWriter buffer. 
writer.close(); 


The StringWriter buffer contains: World 


{ 
{ 
i; 
} 
/* 
Output: 
at | 
See Also 
Reference 


StringWriter Class 


Concepts 
StringWriter Members 
java.io Package 
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SyncFailedException Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.SyncFailedException 
extends java.io.IOException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.io.IOException 
java.io.SyncFailedException 


See Also 

Concepts 

SyncFailedException Members 
java.io Package 


Visual J# Reference 


SyncFailedException Members 


The following tables list the members exposed by the SyncFailedException type. 


Public Constructors 
Name 


SyncFailedException 


Description 





Public Properties (see also Protected Properties ) 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 
Message 
Source 
StackTrace 


TargetSite 


Protected Properties 


(inherited from Exception ) 


(inherited from Exception ) 


(inherited from Exception ) 


(inherited from Exception ) 


(inherited from Exception ) 





Name 


Description 





HResult 





(inherited from Exception ) 





Public Methods 
Name 


equals 


filllnStackTrace 


GetBaseException 


hashCode 


getLocalizedMessage 


Description 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Exception ) 


(inherited from Object ) 


(inherited from Throwable ) 








getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 

clone (inherited from Throwable ) 





printStackTrace 


Overloaded. (inherited from Throwable ) 





toString 





(inherited from Throwable ) 








Protected Methods 





See Also 

Reference 
SyncFailedException Class 
Concepts 

java.io Package 


Visual J# Reference 


SyncFailedException Constructor 


Overload List 





Name 


Description 





SyncFailedException (String) 





SyncFailedException (SerializationInfo, StreamingContext) 





SyncFailedException (String, Exception) 











See Also 

Reference 
SyncFailedException Class 
Concepts 

SyncFailedException Members 
java.io Package 
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SyncFailedException Constructor (String) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.SyncFailedException( 
java.lang.String s); 


Parameters 
S 


See Also 

Reference 
SyncFailedException Class 
Concepts 

SyncFailedException Members 
java.io Package 


Visual J# Reference 


SyncFailedException Constructor (SerializationInfo, 
StreamingContext) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected java.io.SyncFailedException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


context 


See Also 

Reference 
SyncFailedException Class 
Concepts 

SyncFailedException Members 
java.io Package 


Visual J# Reference 


SyncFailedException Constructor (String, Exception) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.SyncFailedException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
S 


inner 


See Also 

Reference 
SyncFailedException Class 
Concepts 

SyncFailedException Members 
java.io Package 
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SyncFailedException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


SyncFailedException Class 


Concepts 
java.io Package 
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SyncFailedException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
SyncFailedException Class 
Concepts 

java.io Package 
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UnsupportedEncodingException Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.UnsupportedEncodingException 
extends java.io.IOException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.io.IOException 
java.io. UnsupportedEncodingException 


See Also 

Concepts 

UnsupportedEncodingException Members 
java.io Package 


Visual J# Reference 


UnsupportedEncodingException Members 


The following tables list the members exposed by the UnsupportedEncodingException type. 


Public Constructors 
Name 


UnsupportedEncodingException 





Public Properties (see also Protected Properties ) 











Name Description 

HelpLink (inherited from Exception ) 
InnerException (inherited from Exception ) 
Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 


Protected Properties 





Name Description 





HResult (inherited from Exception ) 








Public Methods 











Name Description 

equals (inherited from Object ) 
filllnStackTrace (inherited from Throwable ) 
GetBaseException (inherited from Exception ) 
hashCode (inherited from Object ) 
getLocalizedMessage (inherited from Throwable ) 
getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 
clone (inherited from Throwable ) 
printStackTrace Overloaded. (inherited from Throwable ) 





toString (inherited from Throwable ) 











Protected Methods 





See Also 

Reference 
UnsupportedEncodingException Class 
Concepts 

java.io Package 
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UnsupportedEncodingException Constructor 


Overload List 





Name 


Description 





UnsupportedEncodingException () 





UnsupportedEncodingException (String) 





UnsupportedEncodingException (SerializationInfo, StreamingContext) 





UnsupportedEncodingException (String, Exception) 








See Also 

Reference 
UnsupportedEncodingException Class 
Concepts 

UnsupportedEncodingException Members 
java.io Package 
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UnsupportedEncodingException Constructor () 


Initializes a new instance of the UnsupportedEncodingException Class . 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.UnsupportedEncodingException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
UnsupportedEncodingException Class 
Concepts 

UnsupportedEncodingException Members 
java.io Package 


Visual J# Reference 


UnsupportedEncodingException Constructor (String) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.UnsupportedEncodingException( 
java.lang.String s); 


Parameters 
S 


See Also 

Reference 
UnsupportedEncodingException Class 
Concepts 

UnsupportedEncodingException Members 
java.io Package 
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UnsupportedEncodingException Constructor (Serialization|nfo, 
StreamingContext) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected java.io.UnsupportedEncodingException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


context 


See Also 

Reference 
UnsupportedEncodingException Class 
Concepts 

UnsupportedEncodingException Members 
java.io Package 
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UnsupportedEncodingException Constructor (String, 
Exception) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.UnsupportedEncodingException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


inner 


See Also 

Reference 
UnsupportedEncodingException Class 
Concepts 

UnsupportedEncodingException Members 
java.io Package 
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UnsupportedEncodingException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


UnsupportedEncodingException Class 


Concepts 
java.io Package 
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UnsupportedEncodingException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 


UnsupportedEncodingException Class 


Concepts 
java.io Package 
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UTFDataFormatException Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.UTFDataFormatException 
extends java.io.IOException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.io.IOException 
java.io. UTFDataFormatException 


See Also 

Concepts 

UTFDataFormatException Members 
java.io Package 
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UTFDataFormatException Members 


The following tables list the members exposed by the UTFDataFormatException type. 


Public Constructors 
Name 


UTFDataFormatException 





Public Properties (see also Protected Properties ) 











Name Description 

HelpLink (inherited from Exception ) 
InnerException (inherited from Exception ) 
Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 


Protected Properties 





Name Description 





HResult (inherited from Exception ) 








Public Methods 











Name Description 

equals (inherited from Object ) 
filllnStackTrace (inherited from Throwable ) 
GetBaseException (inherited from Exception ) 
hashCode (inherited from Object ) 
getLocalizedMessage (inherited from Throwable ) 
getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 
clone (inherited from Throwable ) 
printStackTrace Overloaded. (inherited from Throwable ) 





toString (inherited from Throwable ) 











Protected Methods 





See Also 

Reference 
UTFDataFormatException Class 
Concepts 

java.io Package 
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UTFDataFormatException Constructor 


Overload List 





Name Description 





UTFDataFormatException () 





UTFDataFormatException (String) 





UTFDataFormatException (SerializationInfo, StreamingContext) 





UTFDataFormatException (String, Exception) 














See Also 

Reference 
UTFDataFormatException Class 
Concepts 

UTFDataFormatException Members 
java.io Package 
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UTFDataFormatException Constructor () 


Initializes a new instance of the UTFDataFormatException Class . 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.UTFDataFormatException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
UTFDataFormatException Class 
Concepts 

UTFDataFormatException Members 
java.io Package 


Visual J# Reference 


UTFDataFormatException Constructor (String) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.UTFDataFormatException( 
java.lang.String s); 


Parameters 
S 


See Also 

Reference 
UTFDataFormatException Class 
Concepts 

UTFDataFormatException Members 
java.io Package 
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UTFDataFormatException Constructor (SerializationInfo, 
StreamingContext) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected java.io.UTFDataFormatException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


context 


See Also 

Reference 
UTFDataFormatException Class 
Concepts 

UTFDataFormatException Members 
java.io Package 
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UTFDataFormatException Constructor (String, Exception) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.UTFDataFormatException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
S 


inner 


See Also 

Reference 
UTFDataFormatException Class 
Concepts 

UTFDataFormatException Members 
java.io Package 
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UTFDataFormatException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


UTFDataFormatException Class 


Concepts 
java.io Package 
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UTFDataFormatException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 


UTFDataFormatException Class 


Concepts 
java.io Package 
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WriteAbortedException Class 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public class java.io.WriteAbortedException 
extends java.io.ObjectStreamException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.io.IOException 
java.io.ObjectStreamException 
java.io.WriteAbortedException 


See Also 

Concepts 

WriteAbortedException Members 
java.io Package 
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WriteAbortedException Members 


The following tables list the members exposed by the WriteAbortedException type. 


Public Constructors 
Name 


WriteAbortedException 


Public Fields 


Description 








Name 


Description 





detail 








Public Properties (see also Protected Properties ) 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 





(inherited from Exception ) 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 





(inherited from Throwable ) 


Overridden. 


Overridden. 


(inherited from Object ) 


(inherited from Throwable ) 








printStackTrace 


toString 


Protected Methods 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 








Name 


Description 





finalize 








(inherited from Object ) 





See Also 

Reference 
WriteAbortedException Class 
Concepts 

java.io Package 
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WriteAbortedException Fields 


Public Fields 





Name Description 





detail 














See Also 

Reference 
WriteAbortedException Class 
Concepts 

java.io Package 
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WriteAbortedException.detail Field 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Exception detail; 


See Also 

Reference 
WriteAbortedException Class 
Concepts 

WriteAbortedException Members 
java.io Package 
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WriteAbortedException Constructor 


Overload List 





Name 


Description 





WriteAbortedException (SerializationInfo, StreamingContext) 





WriteAbortedException (String, Exception) 





WriteAbortedException (String, Exception) 











See Also 

Reference 
WriteAbortedException Class 
Concepts 

WriteAbortedException Members 
java.io Package 
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WriteAbortedException Constructor (SerializationInfo, 
StreamingContext) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected java.io.WriteAbortedException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


context 


See Also 

Reference 
WriteAbortedException Class 
Concepts 

WriteAbortedException Members 
java.io Package 
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WriteAbortedException Constructor (String, Exception) 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.io.WriteAbortedException( 
java.lang.String msg, 
System.Exception inner); 


Parameters 
msg 


inner 


See Also 

Reference 
WriteAbortedException Class 
Concepts 

WriteAbortedException Members 
java.io Package 
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WriteAbortedException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


Overridden. 


Overridden. 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


WriteAbortedException Class 


Concepts 
java.io Package 
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WriteAbortedException.getMessage Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getMessage(); 


See Also 

Reference 
WriteAbortedException Class 
Concepts 

WriteAbortedException Members 
java.io Package 
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WriteAbortedException.GetObjectData Method 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void GetObjectData( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


context 


See Also 

Reference 
WriteAbortedException Class 
Concepts 

WriteAbortedException Members 
java.io Package 
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WriteAbortedException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
WriteAbortedException Class 
Concepts 

java.io Package 
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Writer Class 


An abstract class representing the base for all character writers in the java.io package. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract class java.io.Writer 
extends java.lang.Object 


Example 


The following example demonstrates the close, flush, getBuffer, and write methods of the StringWriter class, which is a 
specialization of the abstract Writer class. 


// writer_overview.jsl 
import java.io.*; 


public class Program 


{ 


public static void main(String[] args) 


{ 
// Create a StringWriter object. 


StringWriter writer = new StringWriter(); 


// Write some data to the StringWriter object. 

// Start with the 7th character and write to the end. 
String s = "Hello World"; 

writer.write("Hello World", 6, s.length() - 6); 


// Print out the contents of the StringWriter buffer. 


System.out.println("The StringWriter buffer contains: + 
writer.toString()); 


// Now flush the buffer we just populated. 
writer.flush(); 


// Print out the contents of the StringWriter buffer. 
System.out.println("The post-flush StringWriter buffer " + 
"contains: " + writer.getBuffer().toString()); 


// Close the StringWriter buffer. 
writer.close(); 


} 
/* 
Output: 
The StringWriter buffer contains: World 
The post-flush StringWriter buffer contains: World 
oy 
Inheritance Hierarchy 
java.lang.Object 
java.io.Writer 


Derived Classes 


See Also 
Concepts 


Writer Members 
java.io Package 
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Writer Members 


An abstract class representing the base for all character writers in the java.io package. 


The following tables list the members exposed by the Writer type. 


Public Constructors 





Name Description 





Writer Overloaded. Initializes a new instance of a Writer object. 








Public Fields 
Name Description 





lock The object used to synchronize operations on the writer. 





Public Methods 
Name __ Description 


close An abstract method that must be implemented by subclasses. This method should take care of flushing any internal 
buffers and resources when called. 





equals —_ |(inherited from Object ) 





flush Flushes the buffer representing the characters to be written. 





hashCode|(inherited from Object ) 


getClass |(inherited from Object ) 


clone Creates a shallow copy of this reader. 


toString |Overridden. Displays a human readable representation of a Writer object. 


write Overloaded. Writes the next character or characters to the characters written. 








Protected Methods 








Name Description 





finalize (inherited from Object ) 














See Also 
Reference 
Writer Class 
Concepts 
java.io Package 
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Writer Fields 


Public Fields 





Name Description 





lock The object used to synchronize operations on the writer. 











See Also 
Reference 
Writer Class 
Concepts 
java.io Package 
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Writer.lock Field 


The object used to synchronize operations on the writer. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





protected java.lang.Object lock; 





See Also 
Reference 
Writer Class 
Concepts 

Writer Members 
java.io Package 
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Writer Constructor 


Initializes a new instance of a Writer object. 


Overload List 


Name Description 


Writer () Initializes a new instance of a Writer object. 


Writer (Object) |Initializes a new instance of a Writer object. The given lock is used to synchronize operations on the writer. 





See Also 
Reference 
Writer Class 
Concepts 

Writer Members 
java.io Package 
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Writer Constructor () 


Initializes a new instance of a Writer object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





protected java.io.Writer(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 
Reference 
Writer Class 
Concepts 

Writer Members 
java.io Package 
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Writer Constructor (Object) 


Initializes a new instance of a Writer object. The given lock is used to synchronize operations on the writer. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


protected java.io.Writer( 
java.lang.Object lock); 


Parameters 


lock 
The object used to synchronize operations on the reader. 


See Also 
Reference 
Writer Class 
Concepts 

Writer Members 
java.io Package 
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Writer Methods 


Public Methods 





Name Description 








Protected Methods 


close An abstract method that must be implemented by subclasses. This method should take care of flushing any internal 
buffers and resources when called. 


equals (inherited from Object ) 
flush Flushes the buffer representing the characters to be written. 


hashCode|(inherited from Object ) 


getClass |(inherited from Object ) 
clone Creates a shallow copy of this reader. 
toString |Overridden. Displays a human readable representation of a Writer object. 


write Overloaded. Writes the next character or characters to the characters written. 





Name 


Description 





finalize 








(inherited from Object ) 





See Also 
Reference 
Writer Class 
Concepts 
java.io Package 
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Writer.clone Method 


Creates a shallow copy of this reader. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 





Return Value 
A shallow copy of this reader. 


See Also 
Reference 
Writer Class 
Concepts 

Writer Members 
java.io Package 
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Writer.close Method 


An abstract method that must be implemented by subclasses. This method should take care of flushing any internal buffers 


and resources when called. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract void close() throws java.io. IOException; 


Example 


The following example demonstrates how to close a StringWriter object, which is a specialization of the abstract Writer class. 


// writer_close.jsl 


import java.io.*; 


public class Program 


{ 


public static void main(String[] args) 


a! 


} 
/* 


Output: 


// Create a StringWriter object. 
StringWriter writer = new StringWriter(); 


// Write some data to the StringWriter object. 
char[] arr = new char[] {'H', ‘e', ‘l', 'l', ‘'o',7 
' Oy ‘W', "0" 5 a aaa ML y ‘d' }3 


for (int i = @; i < arr.length; i++) 


d 
7 


writer.write(arr[i]); 


// Print out the contents of the StringWriter buffer. 
System.out.println("The StringWriter buffer contains: 


writer. getBuffer().toString()); 


// Close the StringWriter buffer. 
writer.close(); 


The StringWriter buffer contains: Hello World 


mi 


See Also 
Reference 
Writer Class 
Concepts 


Writer Members 
java.io Package 
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Writer.flush Method 


Flushes the buffer representing the characters to be written. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract void flush() throws java.io. IOException; 


Example 


The following example demonstrates that the flush method for StringWriter objects has no effect on the underlying buffer. The 
StringWriter class is a specialization of the abstract Writer class. 


// writer_flush.jsl 
import java.io.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Create a StringWriter object. 
StringWriter writer = new StringWriter(); 


// Write some data to the StringWriter object. 


char[] arr = new char[] {'H', ‘e', ‘l', 'l', ‘'o',7 
' Oy ‘W', "0" 5 a aaa ML y ‘d' }3 


for (int i = @; i < arr.length; i++) 


d 
7 


// Print out the contents of the StringWriter buffer. 
System.out.println("The StringWriter buffer contains: " + 
writer. getBuffer().toString()); 


writer.write(arr[i]); 


// Now flush the buffer we just populated. 
writer. flush(); 


// Print out the contents of the StringWriter buffer. 
System.out.println("The post-flush StringWriter buffer " + 
"contains: " + writer.getBuffer().toString()); 


// Close the StringWriter buffer. 
writer.close(); 


i 


/* 

Output: 

The StringWriter buffer contains: Hello World 

The post-flush StringWriter buffer contains: Hello World 
ay A 


See Also 
Reference 
Writer Class 
Concepts 

Writer Members 
java.io Package 
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Writer.toString Method 


Displays a human readable representation of a Writer object. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


Return Value 
A human readable representation of a Writer object. 


See Also 
Reference 
Writer Class 
Concepts 

Writer Members 
java.io Package 
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Writer.write Method 


Writes the next character or characters to the characters written. 


Overload List 


Name Description 

Writer.write (char[]) Places the given array of characters into the internal buffer holding the characters. 
Writer.write (int) Places a character into the next position of the internal character buffer. 
Writer.write (String) Places the given string into the internal buffer holding characters. 


Writer.write (char[], int, int) Places the given array of characters, starting from the offset and for the length specified, into the in 
ternal buffer holding the characters. 


Writer.write (String, int, int)/Places the given string, starting from the offset and for the length specified, into the internal buffer 
holding the characters. 











See Also 
Reference 
Writer Class 
Concepts 

Writer Members 
java.io Package 
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Writer.write Method (Char [ ]) 


Places the given array of characters into the internal buffer holding the characters. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
char[] buf) throws java.io. IOException; 


Parameters 


buf 
The array of characters to be written to the internal buffer. 


See Also 
Reference 
Writer Class 
Concepts 

Writer Members 
java.io Package 
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Writer.write Method (Int32) 


Places a character into the next position of the internal character buffer. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
int oneChar) throws java.io.IOException; 


Parameters 
oneChar 
The character to be placed into the next position of the internal buffer. 
Example 
The following example shows how to write one character at a time to a StringWriter object, which is a specialization of the 


abstract Writer class. 


// writer_write.jsl 
import java.io.*; 


public class Program 


+ 
public static void main(String[] args) 
{ 
// Create a StringWriter object. 
StringWriter writer = new StringWriter(); 
// Write some data to the StringWriter object. 
char[] arr = new char[] {'H', ‘e', ‘l', 'l', ‘'o',7 
' ts "Wi, ‘o',*, a ear My ‘d' } 
for (int i = @; i < arr.length; i++) 
{ 
writer.write(arr[i]); 
} 
// Print out the contents of the StringWriter buffer. 
System.out.println("The StringWriter buffer contains: " + 
writer. getBuffer().toString()); 
// Close the StringWriter buffer. 
writer.close(); 
} 
} 
/* 
Output: 
The StringWriter buffer contains: Hello World 
o/ 
See Also 
Reference 
Writer Class 
Concepts 


Writer Members 
java.io Package 
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Writer.write Method (String) 


Places the given string into the internal buffer holding characters. 
Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
java.lang.String str) throws java.io. IOException; 


Parameters 
str 


The string to be written to the internal buffer. 


Example 


The following example shows how to write a string to a StringWriter object, which is a specialization of the abstract Writer 
class. 


// writer_write_2.jsl 
import java.io.*; 


public class Program 


+ 
public static void main(String[] args) 
{ 
// Create a StringWriter object. 
StringWriter writer = new StringWriter(); 
// Write some data to the StringWriter object. 
String s = "Hello world"; 
writer.write(s); 
// Print out the contents of the StringWriter buffer. 
System.out.println("The StringWriter buffer contains: " + 
writer.getBuffer().toString()); 
// Close the StringWriter buffer. 
writer.close(); 
} 
} 
f® 
Output: 
The StringWriter buffer contains: Hello World 
“7 
See Also 
Reference 
Writer Class 
Concepts 


Writer Members 
java.io Package 
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Writer.write Method (Char ], Int32, Int32) 


Places the given array of characters, starting from the offset and for the length specified, into the internal buffer holding the 


characters. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public abstract void write( 
char[] buf, 
int offset, 
int count) throws java.io. IOException; 


Parameters 


buf 


The array of characters to be written to the internal buffer. 


offset 


An offset into the array of characters. This value represents the index of the first character in the array to be written to the 
internal buffer. This value must be greater than zero. 


count 


The number of characters to be written to the internal buffer starting from the offset. This value plus the offset must be less 
than the overall length of the array. 


Example 


The following example shows how to write an array of characters to an underlying StringWriter buffer, which is a specialization 
of the abstract Writer class. 


// writer_write_3.jsl 


import java.io.*; 


public class Program 


public static void main(String[] args) 


{ 
{ 
} 
} 
Phi 
Output: 


// Create a StringWriter object. 
StringWriter writer = new StringWriter(); 


// Write some data to the StringWriter object. 
char[] arr = new char[] {'H', ‘e', ‘l', 'l', ‘o',7 
' my ‘W', ‘o',*, i ae 5 ‘d' }3 


// Start with the 7th character and write to the end. 


writer.write(arr, 6, arr.length - 6); 


// Print out the contents of the StringWriter buffer. 
System.out.println("The StringWriter buffer contains: 


writer. getBuffer().toString()); 


// Close the StringWriter buffer. 
writer.close(); 


The StringWriter buffer contains: World 


*/ 





See Also 
Reference 
Writer Class 
Concepts 

Writer Members 
java.io Package 
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Writer.write Method (String, Int32, Int32) 


Places the given string, starting from the offset and for the length specified, into the internal buffer holding the characters. 


Package: java.io 


Assembly: vjslib (in vjslib.dll) 


public void write( 
java.lang.String str, 
int offset, 
int count) throws java.io. IOException; 


Parameters 


str 


The string to be written to the internal buffer. 


offset 


An offset into the string. This value represents the index of the first character in the string to be written to the internal buffer. 
This value must be greater than zero. 


count 


The number of characters to be written to the internal buffer starting from the offset. This value plus the offset must be less 
than the overall length of the array. 


Example 


The following example shows how to write a string to an underlying StringWriter buffer, which is a specialization of the 
abstract Writer class. 


// writer_write_4.jsl 


import java.io.*; 


public class Program 


public static void main(String[] args) 


// Create a StringWriter object. 
StringWriter writer = new StringWriter(); 


// Write some data to the StringWriter object. 


// Start with the 7th character and write to the end. 


String s = "Hello World"; 
writer.write(s, 6, s.length() - 6); 


// Print out the contents of the StringWriter buffer. 
System.out.println("The StringWriter buffer contains: 


writer. getBuffer().toString()); 


// Close the StringWriter buffer. 
writer.close(); 


The StringWriter buffer contains: World 


{ 
i 
} 
} 
/* 
Output: 
*/ 
See Also 


Reference 


Writer Class 
Concepts 

Writer Members 
java.io Package 


Visual J# Reference 


java.lang 


Contains the essential language classes and interfaces necessary for J# programs. 


Classes 
Class 


AbstractMethodError 


Description 


The error that is thrown when the execution engine attempts to call a method that is declar 
ed abstract. 





ArithmeticException 


The exception that is thrown when an arithmetic error occurs, such as a division by zero. 





ArrayStoreException 


ArraylndexOutOfBoundsException 


The exception that is thrown when an attempt is made to read beyond the bounds of an arr 
ay. 


The Exception that is thrown when there is an error storing an object as an array, or if an at 
tempt is made to store an invalid object in an array. 





Boolean The Boolean class wraps the primitive value boolean in an object. The class also contains m 
ethods for conversion and processing Boolean objects. 

Byte Wraps the primitive type byte into an object. It also contains methods for conversion and p 
rocessing Byte objects. 

Character Wraps the char primitive type into an object. It contains method members to manipulate ch 


aracters and to change their case. 





ClassCastException 


ClassCircularityError 


The exception that is thrown when attempting to cast an object to a class that it cannot be c 
ast to. 


The error that is thrown when the execution engine encounters a circular inheritance within 
any class hierarchy. 





ClassFormatError 


ClassNotFoundException 


The error that is thrown when the execution engine attempts to load a class that is imprope 
rly formatted. 


The exception that is thrown when attempting to load a class using reflection that cannot b 
e found. 





CloneNotSupportedException 


The exception that is thrown when attempting to clone an object that does not support clon 
ing. 








ExceptionInInitializerError 





Double The Double class wraps the primitive type double into an object. The class contains method 
members to perform tests and to convert from double to other types and vice versa. 

Error Represents the base error for all errors in the J# Class Libraries. An error indicates a proble 
m in the underlying execution engine. 

Exception Represents the base exception for all exceptions in the J# Class Libraries. An exception indic 


ates that an application-level error has occurred. 


The error that is thrown when the execution engine encounters an exception during initializ 
ation of a class from the static initializer. 











Float 


IllegalAccessError 


The Float class wraps the primitive type float. It contains several methods for conversion be 
tween String and Float and processing Float objects. 


The error that is thrown when the execution engine attempts to access a member that it do 
es not have permission to access. 





IIlegalAccessException 


IIlegalArgumentException 


IllegalStateException 


IllegalThreadStateException 


IncompatibleClassChangeError 


The exception that is thrown when attempting to access a member during reflection that th 
e caller does not have permission to access. 


The exception that is thrown when an invalid argument is provided to a method call. 


The exception that is thrown when the program has entered an invalid state. 


The exception that is thrown when a thread has entered an illegal state. 


The error that is thrown when an incompatible change is made to a class. 





IndexOutOfBoundsException 


InstantiationError 


The exception that is thrown when an attempt is made to read beyond the bounds of a coll 
ection. 


The error that is thrown when the execution engine encounters a problem instantiating an 
ew object. 





InstantiationException 


The exception that is thrown when an error occurs instantiating (creating) an object. 





Integer 


Declares an Integer class type that wraps the primitive type int into an object. The class con 
tains method members to perform tests and to convert from int to other types and vice ver 
sa. 





InternalError 


An error thrown to indicate that an internal error has occurred. 





InterruptedException 


The exception that is thrown when a thread is interrupted. 





LinkageError 


The error that is thrown when there is an error linking an application. 





Long 


Math 


Wraps the primitive type long into an object. It also contains methods for conversion and p 
rocessing Long objects. 


Declares the Math class type, which contains method members to perform basic numeric o 
perations such as exponentiation, logarithms, and trigonometric functions. 








NegativeArraySizeException 


NoClassDefFoundError 


NoSuchFieldError 


NoSuchFieldException 


NoSuchMethodError 


NoSuchMethodException 


The exception that is thrown when attempting to create an array with less than zero eleme 
nts. 


An error occurs when a class fails to load because no definition of this class was found. 


An error thrown when the application tries to access a field of an object and that field does 
not exist anymore or has changed. 


An exception thrown to indicate that a class doesn't contain a specific field. 


An error that occurs when an application references a method that does not exist. 


An exception thrown when an application tries to access a method that doesn't exist in the 
class. 








NullPointerException 


Number 


NumberFormatException 


OutOfMemoryError 


RuntimeException 


An exception thrown when you try to use a null value where an object should be used. 


An abstract class extended by all classes that represent numeric primitive types such as 
Byte, Short, Integer, Long, Float, and Double. The class contains abstract methods that conv 
ert the object value to any of the other numeric types. All these methods are overridden by 
the numeric subclasses. It also contains methods to convert numeric types to strings and vi 
se versa. 


An exception thrown when an invalid number format is encountered. 


An error that occurs when your application runs out of memory. 


An exception thrown to indicate that a runtime error has occurred. 





SecurityException 


An exception thrown when a security error occurs. 





Short 


StackOverflowError 


StringBuffer 


Wraps the primitive type short into an object. The class also contains methods for conversi 
on and processing Short objects. 


An error that is issued when a stack overflow occurs. 


Implements a sequence of characters, which can be modified by using the appropriate met 
hod calls. The main difference between a StringBuffer object and String object is that the lat 
ter is immutable. Therefore, it is recommended that you use StringBuffer to manipulate an 
d update the string, and then convert it to a String object. 





StringlndexOutOfBoundsException|An exception that is thrown by a string method when an index is greater than the size of th 





e string 
System Contains useful fields such as the standard input, standard output, and standard error strea 
ms. It also contains methods to access properties, load files and libraries, and copy arrays. 
UnknownError An error that is issued when an unknown error occurs. 





UnsatisfiedLinkError 


UnsupportedOperationException 


An error that is issued when the execution engine cannot find the appropriate definition for 
a declared method. 


An exception that is thrown when an application tries to perform an unsupported operatio 
n. 





VerifyError 


VirtualMachineError 


An error issued when the execution engine cannot verify a class code because it contains is 
sues related to class format semantics. 


An error issued to indicate that there is a problem with the execution engine. 





Interfaces 
Interface 





Description 


Comparable|Provides a method to compare two objects to determine if one object is less than, equal to, or greater than anothe 


r object. 














Runnable — |An interface that abstracts an object that executes code when it is active such as a thread. A class that implements 
Runnable can run without inheriting the Thread class. 
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AbstractMethodError Class 


The error that is thrown when the execution engine attempts to call a method that is declared abstract. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.AbstractMethodError 
extends java. lang. IncompatibleClassChangeError 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Error 
java.lang.LinkageError 

java.lang.IncompatibleClassChangeError 
java.lang.AbstractMethodError 


See Also 

Concepts 

AbstractMethodError Members 
java.lang Package 
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AbstractMethodError Members 


The error that is thrown when the execution engine attempts to call a method that is declared abstract. 


The following tables list the members exposed by the AbstractMethodError type. 


Public Constructors 





Name Description 





AbstractMethodError Overloaded. Initializes a new instance of an AbstractMethodError object. 





Public Properties (see also Protected Properties 




















Name Description 

HelpLink (inherited from Exception ) 
InnerException (inherited from Exception ) 
Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 


Name Description 


HResult (inherited from Exception ) 





Public Methods 


























Name Description 

equals (inherited from Object ) 
filllnStackTrace (inherited from Throwable ) 
GetBaseException (inherited from Exception ) 
hashCode (inherited from Object ) 
getLocalizedMessage (inherited from Throwable ) 
getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 
clone (inherited from Throwable ) 


printStackTrace Overloaded. (inherited from Throwable ) 











toString 


(inherited from Throwable ) 





Protected Methods 
Name 


finalize 





See Also 

Reference 
AbstractMethodError Class 
Concepts 

java.lang Package 





(inherited from Object ) 
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AbstractMethodError Constructor 


Initializes a new instance of an AbstractMethodError object. 


Overload List 


Name Description 
AbstractMethodError () Initializes a new instance of an AbstractMethodError object. 
AbstractMethodError (String) Initializes a new instance of an AbstractMethodError object with the 


given message. 





AbstractMethodError (SerializationInfo, StreamingContext)|Initializes a new instance of an AbstractMethodError object during 
deserialization. 


AbstractMethodError (String, Exception) Initializes a new instance of an AbstractMethodError object with the 
given message and inner exception. 











See Also 

Reference 
AbstractMethodError Class 
Concepts 

AbstractMethodError Members 
java.lang Package 
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AbstractMethodError Constructor () 


Initializes a new instance of an AbstractMethodError object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.AbstractMethodError(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
AbstractMethodError Class 
Concepts 

AbstractMethodError Members 
java.lang Package 
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AbstractMethodError Constructor (String) 


Initializes a new instance of an AbstractMethodError object with the given message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.AbstractMethodError( 
java.lang.String s); 


Parameters 
Ss 


A message describing the error condition. 


See Also 

Reference 
AbstractMethodError Class 
Concepts 

AbstractMethodError Members 
java.lang Package 
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AbstractMethodError Constructor (SerializationInfo, 
StreamingContext) 


Initializes a new instance of an AbstractMethodError object during deserialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java.lang.AbstractMethodError( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
AbstractMethodError Class 
Concepts 

AbstractMethodError Members 
java.lang Package 
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AbstractMethodError Constructor (String, Exception) 


Initializes a new instance of an AbstractMethodError object with the given message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.AbstractMethodError( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the error condition. 
inner 
An inner exception that led to the AbstractMethodError. 


See Also 

Reference 
AbstractMethodError Class 
Concepts 

AbstractMethodError Members 
java.lang Package 
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AbstractMethodError Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


AbstractMethodError Class 


Concepts 
java.lang Package 
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AbstractMethodError Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
AbstractMethodError Class 
Concepts 

java.lang Package 
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ArithmeticException Class 


The exception that is thrown when an arithmetic error occurs, such as a division by zero. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.ArithmeticException 
extends java. lang.RuntimeException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.lang.RuntimeException 
java.lang.ArithmeticException 


See Also 

Concepts 

ArithmeticException Members 
java.lang Package 
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ArithmeticException Members 


The exception that is thrown when an arithmetic error occurs, such as a division by zero. 


The following tables list the members exposed by the ArithmeticException type. 


Public Constructors 





Name Description 





ArithmeticException Overloaded. Initializes a new instance of an ArithmeticException object. 





Public Properties (see also Protected Properties 


Name 


HelpLink 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 





Description 


(inherited from Exception ) 





Name 


Description 





<exceptFilter> 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 





getMessage 


GetObjectData 


getClass 


clone 





(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 





Maps various arithmetic exceptions to a java.lang.ArithmeticException. 








printStackTrace Overloaded. (inherited from Throwable ) 








toString (inherited from Throwable ) 


Protected Methods 





Name Description 





finalize (inherited from Object ) 














See Also 

Reference 
ArithmeticException Class 
Concepts 

java.lang Package 
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ArithmeticException Constructor 


Initializes a new instance of an ArithmeticException object. 


Overload List 


Name Description 
ArithmeticException () Initializes a new instance of an ArithmeticException object. 
ArithmeticException (String) Initializes a new instance of an ArithmeticException object with the g 


iven message. 





ArithmeticException (SerializationInfo, StreamingContext)|Initializes a new instance of an ArithmeticException object during de 
serialization. 


ArithmeticException (String, Exception) Initializes a new instance of an ArithmeticException object with the g 
iven message and inner exception. 








See Also 

Reference 
ArithmeticException Class 
Concepts 

ArithmeticException Members 
java.lang Package 
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ArithmeticException Constructor () 


Initializes a new instance of an ArithmeticException object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.ArithmeticException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
ArithmeticException Class 
Concepts 

ArithmeticException Members 
java.lang Package 
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ArithmeticException Constructor (String) 


Initializes a new instance of an ArithmeticException object with the given message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.ArithmeticException( 
java.lang.String s); 


Parameters 
Ss 


A message describing the exceptional condition. 


See Also 

Reference 
ArithmeticException Class 
Concepts 

ArithmeticException Members 
java.lang Package 
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ArithmeticException Constructor (SerializationInfo, 
StreamingContext) 


Initializes a new instance of an ArithmeticException object during deserialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java.lang.ArithmeticException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
ArithmeticException Class 
Concepts 

ArithmeticException Members 
java.lang Package 
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ArithmeticException Constructor (String, Exception) 


Initializes a new instance of an ArithmeticException object with the given message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.ArithmeticException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the exceptional condition. 
inner 
An inner exception that led to the ArithmeticException. 


See Also 

Reference 
ArithmeticException Class 
Concepts 

ArithmeticException Members 
java.lang Package 
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ArithmeticException Methods 


Public Methods 





Name 


Description 





<exceptFilter> 


Maps various arithmetic exceptions to a java.lang.ArithmeticException. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


ArithmeticException Class 


Concepts 
java.lang Package 
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ArithmeticException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
ArithmeticException Class 
Concepts 

java.lang Package 
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ArrayIndexOutOfBoundsException Class 


The exception that is thrown when an attempt is made to read beyond the bounds of an array. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.ArrayIndexOutOfBoundsException 
extends java. lang. IndexOutOfBoundsException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.lang.RuntimeException 
java.lang.IndexOutOfBoundsException 
java.lang.ArrayIndexOutOfBoundsException 


See Also 

Concepts 

ArrayIndexOutOfBoundsException Members 
java.lang Package 
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ArrayIndexOutOfBoundsException Members 


The exception that is thrown when an attempt is made to read beyond the bounds of an array. 


The following tables list the members exposed by the ArraylndexOutOfBoundsException type. 


Public Constructors 





Name 


Description 





ArraylndexOutOfBoundsException |Overloaded. Initializes a new instance of an ArraylndexOutOfBoundsException object. 








Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Name 


HResult 


Public Methods 


Protected Properties 


Description 


(inherited from Exception ) 








Name 


Description 





<exceptFilter> 


Maps various index out of bounds exceptions to a java.lang.ArrayIndexOutOfBoundsException. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 





getMessage 


GetObjectData 


getClass 


clone 





(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 








printStackTrace Overloaded. (inherited from Throwable ) 





toString (inherited from Throwable ) 





Protected Methods 




















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 

ArraylndexOutOfBoundsException Class 

Concepts 


java.lang Package 
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ArrayIndexOutOfBoundsException Constructor 


Initializes a new instance of an ArraylndexOutOfBoundsException object. 


Overload List 
Name Description 


ArraylndexOutOfBoundsException () Initializes a new instance of an ArrayindexOutOfBoun 
dsException object. 





ArraylndexOutOfBoundsException (int) Initializes a new instance of an ArrayIndexOutOfBoun 
dsException object with the value of the index that cau 
sed the exception. 





ArraylndexOutOfBoundsException (String) Initializes a new instance of an ArrayIndexOutOfBoun 
dsException with the given message. 





ArraylndexOutOfBoundsException (Serializationinfo, StreamingContext)|Initializes a new instance of an ArraylndexOutOfBoun 
dsException object during deserialization. 








ArraylndexOutOfBoundsException (String, Exception) Initializes a new instance of an ArraylndexOutOfBoun 
dsException object with the given message and inner 
exception. 

See Also 

Reference 

ArraylndexOutOfBoundsException Class 

Concepts 


ArraylndexOutOfBoundsException Members 
java.lang Package 
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ArraylndexOutOfBoundsException Constructor () 


Initializes a new instance of an ArraylndexOutOfBoundsException object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java. lang.ArrayIndexOutOfBoundsException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
ArrayIndexOutOfBoundsException Class 
Concepts 

ArraylndexOutOfBoundsException Members 
java.lang Package 
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ArraylndexOutOfBoundsException Constructor (Int32) 


Initializes a new instance of an ArraylndexOutOfBoundsException object with the value of the index that caused the exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java. lang.ArrayIndexOutOfBoundsException( 
int i); 
| 
Parameters 
i 
The value of the index that caused the exception. 


See Also 

Reference 
ArraylndexOutOfBoundsException Class 
Concepts 

ArraylndexOutOfBoundsException Members 
java.lang Package 
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ArraylndexOutOfBoundsException Constructor (String) 


Initializes a new instance of an ArraylndexOutOfBoundsException with the given message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java. lang.ArrayIndexOutOfBoundsException( 


java.lang.String s); 
| 


Parameters 
S 


A message describing the exceptional condition. 


See Also 

Reference 
ArraylndexOutOfBoundsException Class 
Concepts 

ArraylndexOutOfBoundsException Members 
java.lang Package 
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ArrayIndexOutOfBoundsException Constructor 
(SerializationInfo, StreamingContext) 


Initializes a new instance of an ArraylndexOutOfBoundsException object during deserialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java. lang.ArrayIndexOutOfBoundsException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
ArrayIndexOutOfBoundsException Class 
Concepts 

ArrayIndexOutOfBoundsException Members 
java.lang Package 
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ArraylndexOutOfBoundsException Constructor (String, 
Exception) 


Initializes a new instance of an ArrayindexOutOfBoundsException object with the given message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java. lang.ArrayIndexOutOfBoundsException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
S 


A message describing the exceptional condition. 
inner 
An inner exception that led to the ArraylndexOutOfBoundsException. 


See Also 

Reference 
ArrayIndexOutOfBoundsException Class 
Concepts 

ArrayIndexOutOfBoundsException Members 
java.lang Package 
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ArrayIndexOutOfBoundsException Methods 


Public Methods 





Name 


Description 





<exceptFilter> 


Maps various index out of bounds exceptions to a java.lang.ArrayindexOutOfBoundsException. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 


Protected Methods 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


ArraylndexOutOfBoundsException Class 


Concepts 
java.lang Package 
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ArraylndexOutOfBoundsException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 


ArraylndexOutOfBoundsException Class 


Concepts 
java.lang Package 
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ArrayStoreException Class 


The Exception that is thrown when there is an error storing an object as an array, or if an attempt is made to store an invalid 
object in an array. 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public class java.lang.ArrayStoreException 
extends java. lang.RuntimeException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.lang.RuntimeException 
java.lang.ArrayStoreException 


See Also 

Concepts 

ArrayStoreException Members 
java.lang Package 
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ArrayStoreException Members 


The Exception that is thrown when there is an error storing an object as an array, or if an attempt is made to store an invalid 


object in an array. 


The following tables list the members exposed by the ArrayStoreException type. 


Public Constructors 


ArrayStoreException 





Overloaded. Initializes a new instance of an ArrayStoreException object. 


Public Properties (see also Protected Properties ) 





Name 


Description 





HelpLink 


InnerException 


Message 


Source 


StackTrace 


TargetSite 





Protected Properties 


(inherited from Exception ) 


(inherited from Exception ) 


(inherited from Exception ) 


(inherited from Exception ) 


(inherited from Exception ) 


(inherited from Exception ) 





Name 


Description 





HResult 





(inherited from Exception ) 





Public Methods 
Name 


<exceptFilter> 


equals 


filllnStackTrace 


GetBaseException 


hashCode 


getLocalizedMessage 


Description 


Maps various array store exceptions to a java.lang.ArrayStoreException. 
(inherited from Object ) 

(inherited from Throwable ) 

(inherited from Exception ) 

(inherited from Object ) 


(inherited from Throwable ) 

















getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 

clone (inherited from Throwable ) 














printStackTrace Overloaded. (inherited from Throwable ) 





toString (inherited from Throwable ) 





Protected Methods 
Name 


finalize (inherited from Object ) 








See Also 

Reference 
ArrayStoreException Class 
Concepts 

java.lang Package 
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ArrayStoreException Constructor 


Initializes a new instance of an ArrayStoreException object. 


Overload List 


Name Description 

ArrayStoreException () Initializes a new instance of an ArrayStoreException object. 

ArrayStoreException (String) Initializes a new instance of an ArrayStoreException with the given 
message. 





ArrayStoreException (SerializationInfo, StreamingContext)|Initializes a new instance of an ArrayStoreException object during d 
eserialization. 


ArrayStoreException (String, Exception) Initializes a new instance of an ArrayStoreException object with the 
given message and inner exception. 





See Also 

Reference 
ArrayStoreException Class 
Concepts 

ArrayStoreException Members 
java.lang Package 
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ArrayStoreException Constructor () 


Initializes a new instance of an ArrayStoreException object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.ArrayStoreException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
ArrayStoreException Class 
Concepts 

ArrayStoreException Members 
java.lang Package 
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ArrayStoreException Constructor (String) 


Initializes a new instance of an ArrayStoreException with the given message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.ArrayStoreException( 
java.lang.String s); 


Parameters 
Ss 


A message describing the exceptional condition. 


See Also 

Reference 
ArrayStoreException Class 
Concepts 

ArrayStoreException Members 
java.lang Package 


Visual J# Reference 


ArrayStoreException Constructor (SerializationInfo, 
StreamingContext) 


Initializes a new instance of an ArrayStoreException object during deserialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java. lang.ArrayStoreException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
ArrayStoreException Class 
Concepts 

ArrayStoreException Members 
java.lang Package 
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ArrayStoreException Constructor (String, Exception) 


Initializes a new instance of an ArrayStoreException object with the given message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.ArrayStoreException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the exceptional condition. 
inner 
An inner exception that led to the ArrayStoreException. 


See Also 

Reference 
ArrayStoreException Class 
Concepts 

ArrayStoreException Members 
java.lang Package 
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ArrayStoreException Methods 


Public Methods 





Name 


Description 





<exceptFilter> 


Maps various array store exceptions to a java.lang.ArrayStoreException. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 


Protected Methods 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


ArrayStoreException Class 


Concepts 
java.lang Package 
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ArrayStoreException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
ArrayStoreException Class 
Concepts 

java.lang Package 
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Boolean Class 


The Boolean class wraps the primitive value boolean in an object. The class also contains methods for conversion and 
processing Boolean objects. 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public final class java.lang.Boolean 


extends java.lang.Object 
implements java.io.Serializable, System.IConvertible 








Inheritance Hierarchy 
java.lang.Object 
java.lang.Boolean 


See Also 
Concepts 
Boolean Members 
java.lang Package 
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Boolean Members 


The Boolean class wraps the primitive value boolean in an object. The class also contains methods for conversion and 
processing Boolean objects. 


The following tables list the members exposed by the Boolean type. 


Public Constructors 





Public Fields 








Name Description 

FALSE The Boolean object that corresponds to the primitive type false. 
TRUE The Boolean object that corresponds to the primitive type true. 
TYPE The Class object that represents the primitive type boolean. 





Public Methods 
Name Description 








booleanValue|Returns the boolean primitive value stored in a Boolean object. 





equals Overridden. Checks if a specified object is equal to the current object. 





getBoolean Returns true if and only if the value of the system property named by the argument is equal, ignoring case, to th 
e string “true”. 


hashCode _ |Overridden. Returns the hash code of a Boolean object. 
getClass (inherited from Object ) 

clone 
ToBoolean 
ToByte 
ToChar 
ToDateTime 


ToDecimal 





ToDouble 





Tolnt16 





Tolnt32 





Tolnt64 

















ToSByte 





ToSingle 





toString 


Overloaded. Overridden. 





ToType 





ToUInt16 





ToUInt32 





ToUInt64 





valueOf 





See Also 


Reference 
Boolean Class 


Concepts 


Returns the Boolean value of a string parameter. 





java.lang Package 
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Boolean Fields 


Public Fields 























Name Description 

FALSE The Boolean object that corresponds to the primitive type false. 
TRUE The Boolean object that corresponds to the primitive type true. 
TYPE The Class object that represents the primitive type boolean. 
See Also 

Reference 


Boolean Class 


Concepts 


java.lang Package 
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Boolean.FALSE Field 


The Boolean object that corresponds to the primitive type false. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final java.lang.Boolean FALSE; 


Example ——___________________c_____§_=, 


// b-FALSE.jsl 
// Boolean.FALSE example 


public class MyClass 


public static void main(String[] args) 


{ 
} 


System.out.print(Boolean. FALSE) ; 


} 


/* 
Output: 
false 


*/ 











See Also 
Reference 
Boolean Class 
Concepts 

Boolean Members 
java.lang Package 
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Boolean. TRUE Field 


The Boolean object that corresponds to the primitive type true. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final java.lang.Boolean TRUE; 


Example ——___________________c_____§_=, 


// b-TRUE.jsl 
// Boolean.TRUE example 


public class MyClass 


public static void main(String[] args) 


{ 
} 


System.out.print(Boolean. TRUE) ; 


} 


/* 
Output: 
true 


*/ 











See Also 
Reference 
Boolean Class 
Concepts 

Boolean Members 
java.lang Package 
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Boolean.TYPE Field 


The Class object that represents the primitive type boolean. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final java.lang.Class TYPE; 


Example ——___________________c_____§_=, 


// b-TYPE.jsl 
// Boolean. TYPE example 


public class MyClass 


public static void main(String[] args) 


{ 
} 


System.out.print(Boolean.TYPE) ; 


} 


/* 
Output: 
boolean 


*/ 











See Also 
Reference 
Boolean Class 
Concepts 

Boolean Members 
java.lang Package 
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Boolean Constructor 


Overload List 





Name 


Description 





Boolean (boolean) 


Constructs a Boolean object by using a Boolean primitive type. 





Boolean (String) 








Constructs a Boolean object by using a string expression. 





See Also 
Reference 
Boolean Class 
Concepts 

Boolean Members 
java.lang Package 
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Boolean Constructor (Boolean) 


Constructs a Boolean object by using a Boolean primitive type. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.Boolean( 
boolean val); 





Parameters 
val 


A primitive type expression. 








Example 
// b-ctor1.jsl 
// Boolean.#ctor example 
public class MyClass 
public static void main(String[] args) 
{ 
Boolean b = new Boolean(true); 
System.out.print(b) ; 
} 
} 
/* 
Output 
true 
oy 
See Also 
Reference 
Boolean Class 
Concepts 


Boolean Members 
java.lang Package 





Visual J# Reference 


Boolean Constructor (String) 


Constructs a Boolean object by using a string expression. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.Boolean( 
java.lang.String str); 





Parameters 
str 


A string expression. 








Example 
// b-ctor2.jsl 
// Boolean.#ctor example 
public class MyClass 
public static void main(String[] args) 
{ 
Boolean b = new Boolean("true"); 
System.out.print(b) ; 
} 
} 
/* 
Output: 
true 
wi 
Remarks 


Creates an instance of Boolean with its underlying value true if the string is "true" (case ignored); false otherwise. 


See Also 
Reference 
Boolean Class 
Concepts 

Boolean Members 
java.lang Package 
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Boolean Methods 


Public Methods 





Name 


Description 





booleanValue 


Returns the boolean primitive value stored in a Boolean object. 





equals 


Overridden. Checks if a specified object is equal to the current object. 





getBoolean 


hashCode 


getClass 


Returns true if and only if the value of the system property named by the argument is equal, ignoring case, to th 
e string “true”. 


Overridden. Returns the hash code of a Boolean object. 


(inherited from Object ) 





clone 





ToBoolean 





ToByte 





ToChar 





ToDateTime 





ToDecimal 





ToDouble 





Tolnt16 





Tolnt32 





Tolnt64 





ToSByte 





ToSingle 





toString 


Overloaded. Overridden. 





ToType 





ToUInt16 


ToUInt32 


ToUInt64 


valueOf 





See Also 





Returns the Boolean value of a string parameter. 





Reference 
Boolean Class 
Concepts 
java.lang Package 
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Boolean.booleanValue Method 


Returns the boolean primitive value stored in a Boolean object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public boolean booleanValue(); 





Return Value 


The boolean primitive value stored in the Boolean object. 


Example a 








// b-bvalue1.jsl 
// Boolean.booleanValue example 
public class MyClass 
{ 
public static void main(String[] args) 
if 
Boolean b = new Boolean("false"); 
System.out.print(b.booleanValue() ); 
} 
} 
/* 
Output: 
false 
=f 
See Also 
Reference 
Boolean Class 
Concepts 


Boolean Members 
java.lang Package 
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Boolean.clone Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





See Also 
Reference 
Boolean Class 
Concepts 

Boolean Members 
java.lang Package 
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Boolean.equals Method 


Checks if a specified object is equal to the current object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public boolean equals( 
java.lang.Object obj); 


Parameters 


obj 
The object to compare to. 
Example 


// b-equals1.jsl 
// Boolean.Equals example 


public class MyClass 


public static void main(String[] args) 


{ 


Boolean b1 = new Boolean(false); 
Boolean b2 = new Boolean("false"); 
System.out.print(b1.Equals(b2)); 


} 


/* 
Output: 
true 


*/ 


See Also 
Reference 
Boolean Class 
Concepts 

Boolean Members 
java.lang Package 
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Boolean.getBoolean Method 


Returns true if and only if the value of the system property named by the argument is equal, ignoring case, to the string "true". 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static boolean getBoolean( 
java.lang.String name); 


Parameters 
name 


The system property name. 
Return Value 


true if and only if the value of the system property named by the argument is equal, ignoring case, to the string "true"; false 
otherwise. 


See Also 
Reference 
Boolean Class 
Concepts 

Boolean Members 
java.lang Package 
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Boolean.hashCode Method 


Returns the hash code of a Boolean object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public int hashCode(); 


Return Value 
The hash code of a Boolean object. 
Example 


// b-hashCode1.jsl 
// Boolean.GetHashCode example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
Boolean b = new Boolean("true"); 
int x = b.hashCode(); 
System.out.print("The Hash code is: " + x); 
} 
} 
/* 
Output: 
The Hash code is: 1231 
ef 
Remarks 


If this Boolean object represents true, the integer 1231 is returned. 
If this Boolean object represents false, the integer 1237 is returned. 


See Also 
Reference 
Boolean Class 
Concepts 

Boolean Members 
java.lang Package 


Visual J# Reference 


Boolean. ToBoolean Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public boolean ToBoolean( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 
Boolean Class 
Concepts 

Boolean Members 
java.lang Package 


Visual J# Reference 


Boolean. ToByte Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.Byte ToByte( 


System. IFormatProvider provider) ; 





Parameters 
provider 


See Also 
Reference 
Boolean Class 
Concepts 

Boolean Members 
java.lang Package 


Visual J# Reference 


Boolean.ToChar Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public char ToChar( 


System. IFormatProvider provider) ; 





Parameters 
provider 


See Also 
Reference 
Boolean Class 
Concepts 

Boolean Members 
java.lang Package 


Visual J# Reference 


Boolean.ToDateTime Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.DateTime ToDateTime( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 
Boolean Class 
Concepts 

Boolean Members 
java.lang Package 


Visual J# Reference 


Boolean.ToDecimal Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.Decimal ToDecimal ( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 
Boolean Class 
Concepts 

Boolean Members 
java.lang Package 


Visual J# Reference 


Boolean. ToDouble Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public double ToDouble( 
System.IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 
Boolean Class 
Concepts 

Boolean Members 
java.lang Package 


Visual J# Reference 


Boolean.Tolnt16 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public short ToInt16( 


System. IFormatProvider provider) ; 





Parameters 
provider 


See Also 
Reference 
Boolean Class 
Concepts 

Boolean Members 
java.lang Package 


Visual J# Reference 


Boolean.Tolnt32 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public int ToInt32( 


System. IFormatProvider provider) ; 





Parameters 
provider 


See Also 
Reference 
Boolean Class 
Concepts 

Boolean Members 
java.lang Package 


Visual J# Reference 


Boolean.Tolnt64 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public long ToInt64( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 
Boolean Class 
Concepts 

Boolean Members 
java.lang Package 


Visual J# Reference 


Boolean. ToSByte Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public byte ToSByte( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 
Boolean Class 
Concepts 

Boolean Members 
java.lang Package 


Visual J# Reference 


Boolean.ToSingle Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public float ToSingle( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 
Boolean Class 
Concepts 

Boolean Members 
java.lang Package 


Visual J# Reference 


Boolean.toString Method 


Overload List 





Name 


Description 





Boolean.ToString () 


Boolean.ToString (IFormatProvider) 





See Also 
Reference 
Boolean Class 
Concepts 

Boolean Members 
java.lang Package 





Returns a string equal to "true" if this Boolean object represents true, and returns string eq 
ual to "false" if this Boolean object represents false. 





Visual J# Reference 


Boolean.toString Method () 


Returns a string equal to "true" if this Boolean object represents true, and returns string equal to "false" if this Boolean object 
represents false. 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toString(); 








Return Value 


A string "true" if this Boolean object represents true; a string "false" otherwise. 


Example —————— 











// b-ToString1.jsl 
// Boolean.ToString example 
public class MyClass 
{ 
public static void main(String[] args) 
{ 
Boolean b = new Boolean("true"); 
System.out.print(b.ToString()); 
} 
} 
/* 
Output 
true 
*/ 
See Also 
Reference 
Boolean Class 
Concepts 


Boolean Members 
java.lang Package 


Visual J# Reference 


Boolean.toString Method (IFormatProvider) 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String ToString( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 
Boolean Class 
Concepts 

Boolean Members 
java.lang Package 


Visual J# Reference 


Boolean.ToType Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object ToType( 
System.Type conversionType, 
System. IFormatProvider provider) ; 


Parameters 
conversionType 


provider 


See Also 
Reference 
Boolean Class 
Concepts 

Boolean Members 
java.lang Package 


Visual J# Reference 


Boolean. ToUInt16 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.UInt16 ToUInt16( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 
Boolean Class 
Concepts 

Boolean Members 
java.lang Package 


Visual J# Reference 


Boolean. ToUInt32 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.UInt32 ToUInt32( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 
Boolean Class 
Concepts 

Boolean Members 
java.lang Package 


Visual J# Reference 


Boolean. ToUInt64 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.UInt64 ToUInt64( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 
Boolean Class 
Concepts 

Boolean Members 
java.lang Package 


Visual J# Reference 


Boolean.valueOf Method 


Returns the Boolean value of a string parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.Boolean valueOf( 
java.lang.String str); 


Parameters 
str 
The string parameter. 
Return Value 
The Boolean value of the string parameter. 
Example 


// b-valueofi1.jsl 
// Boolean.valueOf example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
String s = "true"; 
System.out.print(Boolean.valueOf(s)); 
} 
} 
/* 
Output: 
true 
ef 
Remarks 


The result is true if and only if the argument is not null and is equal, ignoring case, to the string "true". 


See Also 
Reference 
Boolean Class 
Concepts 

Boolean Members 
java.lang Package 


Visual J# Reference 


Byte Class 


Wraps the primitive type byte into an object. It also contains methods for conversion and processing Byte objects. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public final class java.lang.Byte 
extends java. lang.Number 
implements System.IConvertible, java.lang.Comparable 





Remarks 
This class implements System.IConvertible. 
Inheritance Hierarchy 
java.lang.Object 
java.lang.Number 
java.lang.Byte 


See Also 
Concepts 

Byte Members 
java.lang Package 


Visual J# Reference 


Byte Members 


Wraps the primitive type byte into an object. It also contains methods for conversion and processing Byte objects. 


The following tables list the members exposed by the Byte type. 


Public Constructors 



































Name Description 

Byte Overloaded. 

Public Fields 

Name Description 

MAX_VALUE A constant that stores the maximum value a byte can have. 
MIN_VALUE A constant that stores the minimum value a byte can have. 

TYPE A readonly value that represents the Class instance of the primitive type byte. 
Public Methods 

Name Description 

byteValue Overridden. Returns the byte value stored in a Byte object. 
compareTo Overloaded. 

decode Decodes a string parameter to a Byte object. 

doubleValue Overridden. Returns the value of a Byte object converted to double. 
equals Overridden. Compares the current Byte object to another object. 
floatValue Overridden. Returns value of a Byte object converted to float. 
hashCode Overridden. Returns the hash code of a Byte object. 

getClass (inherited from Object ) 

intValue Overridden. Returns the value of a Byte object as an int. 
longValue Overridden. Returns the value of a Byte object as a long number. 
clone (inherited from Number ) 

parseByte Overloaded. 

shortValue Overridden. Returns the value of a Byte object as a short number. 
ToBoolean 

ToByte 

ToChar 














ToDateTime 





ToDecimal 





ToDouble 





Tolnt16 





Tolnt32 





Tolnt64 





ToSByte 





ToSingle 


toString 


ToType 


ToUInt16 


ToUInt32 


ToUInt64 


valueOf 





See Also 
Reference 

Byte Class 

Concepts 


java.lang Package 


Returns the string that represents a byte value. 


Overloaded. 





Visual J# Reference 


Byte Fields 


Public Fields 


























Name Description 

MAX_VALUE A constant that stores the maximum value a byte can have. 

MIN_VALUE A constant that stores the minimum value a byte can have. 

TYPE A readonly value that represents the Class instance of the primitive type byte. 
See Also 

Reference 

Byte Class 

Concepts 


java.lang Package 


Visual J# Reference 


Byte.MAX_VALUE Field 


A constant that stores the maximum value a byte can have. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final byte MAX_VALUE; 


Example 


// bt-MAX_VALUE.js1 
// Byte MAX_VALUE example 


public class MyClass 


public static void main(String[] args) 


{ 
} 


System.out.print("MAX_VALUE = " + Byte.MAX_VALUE) ; 


} 


/* 

Output: 
MAX_VALUE = 127 
*/ 














Remarks 
The value of MAX_VALUE is 127. 


See Also 
Reference 

Byte Class 
Concepts 

Byte Members 
java.lang Package 


Visual J# Reference 


Byte.MIN_VALUE Field 


A constant that stores the minimum value a byte can have. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final byte MIN_VALUE; 


Example 


// bt-MIN_VALUE.js1l 
// Byte MIN_VALUE example 


public class MyClass 


public static void main(String[] args) 


{ 
} 


System.out.print("MIN_VALUE = " + Byte.MIN_VALUE) ; 


} 


/* 

Output: 
MIN_VALUE = -128 
| 














Remarks 
The value of MIN_VALUE is -128. 


See Also 
Reference 

Byte Class 
Concepts 

Byte Members 
java.lang Package 


Visual J# Reference 


Byte.TYPE Field 


A readonly value that represents the Class instance of the primitive type byte. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final java.lang.Class TYPE; 


Example 


// bt-TYPE.jsl 
// Byte.TYPE example 


public class MyClass 


public static void main(String[] args) 


{ 
} 


System.out.print("TYPE = " + Byte.TYPE); 


} 


/* 

Output: 
TYPE = byte 
aA 














See Also 
Reference 

Byte Class 
Concepts 

Byte Members 
java.lang Package 


Visual J# Reference 


Byte Constructor 


Overload List 





Name Description 





Byte (byte) Constructs a new Byte object that represents a specified byte value. 





Byte (String) |Constructs a new Byte object that represents the byte value specified by a string parameter. 














See Also 
Reference 

Byte Class 
Concepts 

Byte Members 
java.lang Package 


Visual J# Reference 


Byte Constructor (SByte) 


Constructs a new Byte object that represents a specified byte value. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.Byte( 
byte value); 





Parameters 
value 


A byte expression. 








Example 
// bt-ctor1.jsl 
// Byte.#ctor example 
public class MyClass 
public static void main(String[] args) 
{ 
Byte b = new Byte((byte)123); // Cast to convert int to byte. 
System.out.print("The byte value is: " + b); 
} 
} 
/* 
Output: 
The byte value is: 123 
eh 
See Also 
Reference 
Byte Class 
Concepts 


Byte Members 
java.lang Package 





Visual J# Reference 


Byte Constructor (String) 


Constructs a new Byte object that represents the byte value specified by a string parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.Byte( 
java.lang.String str) throws java.lang.NumberFormatException; 





Parameters 
str 


A string expression. 








Example 
// bt-ctor2.jsl 
// Byte.#ctor example 
public class MyClass 
public static void main(String[] args) 
{ 
Byte b = new Byte("123"); 
System.out.print("The byte value is: " + b); 
} 
} 
/* 
Output: 
The byte value is: 123 
if 
Remarks 


If the string could not be parsed to a byte value, it throws the exception java.lang.NumberFormatException. 


See Also 
Reference 

Byte Class 
Concepts 

Byte Members 
java.lang Package 





Visual J# Reference 


Byte Methods 


Public Methods 



































Name Description 

byteValue Overridden. Returns the byte value stored in a Byte object. 
compareTo Overloaded. 

decode Decodes a string parameter to a Byte object. 

doubleValue Overridden. Returns the value of a Byte object converted to double. 
equals Overridden. Compares the current Byte object to another object. 
floatValue Overridden. Returns value of a Byte object converted to float. 
hashCode Overridden. Returns the hash code of a Byte object. 

getClass (inherited from Object ) 

intValue Overridden. Returns the value of a Byte object as an int. 
longValue Overridden. Returns the value of a Byte object as a long number. 
clone (inherited from Number ) 

parseByte Overloaded. 

shortValue Overridden. Returns the value of a Byte object as a short number. 
ToBoolean 

ToByte 

ToChar 

ToDateTime 

ToDecimal 

ToDouble 

Tolnt16 

Tolnt32 

Tolnt64 

ToSByte 

ToSingle 











toString Returns the string that represents a byte value. 





ToType 





ToUInt16 





ToUInt32 





ToUInt64 





valueOf Overloaded. 











See Also 
Reference 

Byte Class 
Concepts 
java.lang Package 


Visual J# Reference 


Byte.byteValue Method 


Returns the byte value stored in a Byte object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public byte byteValue(); 





Return Value 


The byte value stored in the Byte object. 


Example TE 








// bt-bvalue1.jsl 
// Byte.byteValue example 
public class MyClass 
{ 
public static void main(String[] args) 
Byte b = new Byte("123"); 
System.out.print("The byte value is: " + b.byteValue()); 
} 
} 
/* 
Output: 
The byte value is: 123 
=f 
See Also 
Reference 
Byte Class 
Concepts 


Byte Members 
java.lang Package 


Visual J# Reference 


Byte.compareTo Method 


Overload List 





Name Description 





Byte.compareTo (ubyte) Compares the current Byte object to another Byte object. 





Byte.compareTo (Object) Compares the current object to another object. 











See Also 
Reference 

Byte Class 
Concepts 

Byte Members 
java.lang Package 


Visual J# Reference 


Byte.compareTo Method (Byte) 


Compares the current Byte object to another Byte object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public int compareTo( 
java.lang.Byte aByte); 


Parameters 
aByte 

The Byte object to compare to. 
Return Value 


0 if the two objects are identical. Negative value if aByte is greater than the current object. Positive value if aByte is less than 
the current object. 


Example 


// bt-comp1.jsl 
// Byte.compareTo example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
Byte b1 = new Byte("121"); 
Byte b2 = new Byte("123"); 
System.out.print("The result is: " + b1.compareTo(b2)); 
} 
} 
/ * 
Output: 
The result is: -1 
nf 
See Also 
Reference 
Byte Class 
Concepts 


Byte Members 
java.lang Package 


Visual J# Reference 


Byte.compareTo Method (Object) 


Compares the current object to another object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public int compareTo( 
java.lang.Object obj); 


Parameters 
obj 
The object to compare to. 
Return Value 
If obj is a Byte object, it behaves exactly like compareTo, in which case it returns: 
0 if the two objects are identical. 
Negative value if obj is greater than the current object. 
Positive value if obj is less than the current object. 
If obj is of another type other than Byte, the program throws the exception java.lang.ClassCastException. 
Example 


// bt-comp2.jsl 
// Byte.compareTo example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
Byte b = new Byte("121"); 
Integer i = new Integer("123"); 
System.out.print("The result is: " + b.compareTo(i)); 
} 
} 
/* 
Output: 


java.lang.ClassCastException: Specified cast is not valid. 
at java.lang.Byte.compareTo(Object obj) 
at MyClass.main(String[] args) 

*/ 


See Also 
Reference 

Byte Class 
Concepts 

Byte Members 
java.lang Package 


Visual J# Reference 


Byte.decode Method 


Decodes a string parameter to a Byte object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.Byte decode( 
java.lang.String str) throws java.lang.NumberFormatException; 


Parameters 
str 
The string to be decoded. 
Return Value 
The Byte object that contains the byte value of str. 
Example 


// bt-decode1.jsl 
// Byte.decode example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
String s = new String("@x27"); // Hexadecimal number 
Byte b = Byte.decode(s); 
System.out.print("The decoded byte is: " + b); 
} 
} 
Phi 
Output: 
The decoded byte is: 39 
oy 
Remarks 


The string parameter str might contain decimal, hexadecimal, or octal digits. 

Hexadecimal digits are preceded by "Ox", OX", or "#". 

Octal digits are preceded by zero (0). 

If the string cannot be parsed to a byte value, the exception java.lang.NumberFormatException is thrown. 


See Also 
Reference 

Byte Class 
Concepts 

Byte Members 
java.lang Package 


Visual J# Reference 


Byte.doubleValue Method 


Returns the value of a Byte object converted to double. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public double doubleValue() ; 


Return Value 
The value of the Byte object converted to double. 
Example 


// bt-doubleValue1.js1l 
// Byte.doubleValue example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
Byte b = new Byte("123"); 
// Convert it to double and add it to another double number: 
double d = b.doubleValue() + 321.4; 
System.out.print("The new double number is: " + d); 
} 
} 
/ * 
Output: 
The new double number is: 444.4 
*/ 
See Also 
Reference 
Byte Class 
Concepts 


Byte Members 
java.lang Package 


Visual J# Reference 


Byte.equals Method 


Compares the current Byte object to another object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public boolean equals( 
java.lang.Object obj); 





Parameters 


obj 
The object to compare to. 
Return Value 


true if the two objects are identical; false otherwise. 








Example 
// bt-equalsi.jsl 
// Byte.Equals example 
public class MyClass 
{ 
public static void main(String[] args) 
Byte b1 = new Byte("123"); 
Byte b2 = new Byte("123"); 
System.out.print("The result is: " + b1.Equals(b2)); 
} 
} 
/* 
The result is: true 
*/ 
See Also 
Reference 
Byte Class 
Concepts 


Byte Members 
java.lang Package 





Visual J# Reference 


Byte.floatValue Method 


Returns value of a Byte object converted to float. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public float floatValue(); 





Return Value 


The value of the Byte object converted to float. 


Example OO 








// bt-floatValue1.jsl 
// Byte.floatValue example 
public class MyClass 
{ 
public static void main(String[] args) 
{ 
Byte b = new Byte("123"); 
// Convert it to float and add it to another float number: 
float f = b.floatValue() + 321.4F; 
System.out.print("The new float number is: " + f); 
} 
} 
/* 
Output: 
The new float number is: 444.4 
*/ 
See Also 
Reference 
Byte Class 
Concepts 


Byte Members 
java.lang Package 


Visual J# Reference 


Byte.hashCode Method 


Returns the hash code of a Byte object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public int hashCode(); 





Return Value 


The hash code of the Byte object. 


Example TE 








// bt-getHashi.jsl 
// Byte.GetHashCode example 
public class MyClass 
{ 
public static void main(String[] args) 
Byte b = new Byte("123"); 
int h = b.GetHashCode(); 
System.out.print("The hash code is: " + h); 
} 
} 
/* 
The hash code is: 123 
mf 
See Also 
Reference 
Byte Class 
Concepts 


Byte Members 
java.lang Package 


Visual J# Reference 


Byte.intValue Method 


Returns the value of a Byte object as an int. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public int intValue(); 





Return Value 


The value of the Byte object as an int. 


Example OO 








// bt-intValue1.jsl 
// Byte.intValue example 
public class MyClass 
{ 
public static void main(String[] args) 
{ 
Byte b = new Byte("123"); 
// Convert it and add it to another int: 
int i = b.intValue() + 321; 
System.out.print("The new int is: " + i); 
} 
} 
/* 
Output: 
The new int is: 444 
*/ 
See Also 
Reference 
Byte Class 
Concepts 


Byte Members 
java.lang Package 


Visual J# Reference 


Byte.longValue Method 


Returns the value of a Byte object as a long number. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public long longValue(); 





Return Value 


The value of the Byte object as a long number. 


Example OO 








// bt-longValue1.jsl 
// Byte.longValue example 
public class MyClass 
{ 
public static void main(String[] args) 
ii 
Byte b = new Byte("123"); 
// Convert it and add it to another long number: 
long 1 = b.longValue() + 321L; 
System.out.print("The new long number is: " + 1); 
} 
} 
/* 
Output: 
The new long number is: 444 
af 
See Also 
Reference 
Byte Class 
Concepts 


Byte Members 
java.lang Package 


Visual J# Reference 


Byte.parseByte Method 


Overload List 





Name Description 





Byte.parseByte (String) Returns the byte value represented by a string parameter. 





Byte.parseByte (String, int) |Returns the signed byte value represented by a string parameter in the specified radix. 











See Also 
Reference 

Byte Class 
Concepts 

Byte Members 
java.lang Package 


Visual J# Reference 


Byte.parseByte Method (String) 


Returns the byte value represented by a string parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static byte parseByte( 
java.lang.String str) throws java.lang.NumberFormatException; 


Parameters 
str 
The string to be parsed. 
Return Value 
The byte value represented by the string parameter. 
Example 


// bt-parse1.jsl 
// Byte.parseByte example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
String s = new String("123"); 
byte b = Byte.parseByte(s); 
System.out.print("The byte is: " + b); 
} 
} 
/* 
Output: 
The byte is: 123 
oy 
Remarks 


The string characters must all be decimal digits except the first character, which can be a minus sign (-). 
The returned value is a signed byte in the decimal radix. 


If the string could not be parsed to a signed decimal byte, the exception java.lang.NumberFormatException is thrown. 


See Also 
Reference 

Byte Class 
Concepts 

Byte Members 
java.lang Package 


Visual J# Reference 


Byte.parseByte Method (String, Int32) 


Returns the signed byte value represented by a string parameter in the specified radix. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static byte parseByte( 
java.lang.String str, 
int radix) throws java.lang.NumberFormatException; 


Parameters 
str 
The string to be parsed. 
radix 
The radix used in parsing str. 
Return Value 
The byte value represented by str in the specified radix. 
Example 


// bt-parse2.jsl 
// Byte.parseByte example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
String s1 = new String("127"); // Decimal 
String s2 = new String("7F"); // Hexadecimal 
byte b1 = Byte.parseByte(s1,10); 
byte b2 = Byte.parseByte(s2,16); 
System.out.print("b1 = " + b1 + "\nb2 = " + b2); 
} 
} 
/* 
Output: 
b1 = 127 
b2 = 127 
ar 
Remarks 


The string characters must all be digits in the specified radix except the first character, which can be a minus sign (-). 
The exception java.lang.NumberFormatException is generated if any of the following conditions occurred: 

The string parameter is null. 

The length of the string parameter is zero (""). 

If the value of the radix is not in the range Character.MIN_RADIX to Character. MAX_RADIX. 

The string does not represent a byte value. 


If any of the characters in the string, except the first character, which can be a minus sign, is not a valid digit in the specified 
radix. 


See Also 


Reference 

Byte Class 
Concepts 

Byte Members 
java.lang Package 


Visual J# Reference 


Byte.shortValue Method 


Returns the value of a Byte object as a short number. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public short shortValue(); 





Return Value 


The value of the Byte object as a short number. 


Example TE 











// bt-shvalue1.jsl 
// Byte.shortValue example 
public class MyClass 
{ 
public static void main(String[] args) 
Byte b = new Byte("123"); 
short s = b.shortValue(); 
System.out.print("The short value is: " +s); 
} 
} 
/* 
Output: 
The short value is: 123 
a) 
See Also 
Reference 
Byte Class 
Concepts 


Byte Members 
java.lang Package 


Visual J# Reference 


Byte.ToBoolean Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public boolean ToBoolean( 
System.IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Byte Class 
Concepts 

Byte Members 
java.lang Package 


Visual J# Reference 


Byte.ToByte Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.Byte ToByte( 


System. IFormatProvider provider) ; 





Parameters 
provider 


See Also 
Reference 

Byte Class 
Concepts 

Byte Members 
java.lang Package 


Visual J# Reference 


Byte.ToChar Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public char ToChar( 


System. IFormatProvider provider) ; 





Parameters 
provider 


See Also 
Reference 

Byte Class 
Concepts 

Byte Members 
java.lang Package 


Visual J# Reference 


Byte.ToDateTime Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.DateTime ToDateTime( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Byte Class 
Concepts 

Byte Members 
java.lang Package 


Visual J# Reference 


Byte.ToDecimal Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.Decimal ToDecimal ( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Byte Class 
Concepts 

Byte Members 
java.lang Package 


Visual J# Reference 


Byte.ToDouble Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public double ToDouble( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Byte Class 
Concepts 

Byte Members 
java.lang Package 


Visual J# Reference 


Byte.Tolnt16 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public short ToInt16( 


System. IFormatProvider provider) ; 





Parameters 
provider 


See Also 
Reference 

Byte Class 
Concepts 

Byte Members 
java.lang Package 


Visual J# Reference 


Byte.Tolnt32 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public int ToInt32( 


System. IFormatProvider provider) ; 





Parameters 
provider 


See Also 
Reference 

Byte Class 
Concepts 

Byte Members 
java.lang Package 


Visual J# Reference 


Byte.Tolnt64 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public long ToInt64( 


System. IFormatProvider provider) ; 





Parameters 
provider 


See Also 
Reference 

Byte Class 
Concepts 

Byte Members 
java.lang Package 


Visual J# Reference 


Byte.ToSByte Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public byte ToSByte( 


System. IFormatProvider provider) ; 





Parameters 
provider 


See Also 
Reference 

Byte Class 
Concepts 

Byte Members 
java.lang Package 


Visual J# Reference 


Byte.ToSingle Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public float ToSingle( 


System. IFormatProvider provider) ; 





Parameters 
provider 


See Also 
Reference 

Byte Class 
Concepts 

Byte Members 
java.lang Package 


Visual J# Reference 


Byte.toString Method 


Returns the string that represents a byte value. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static java.lang.String toString( 
byte bval); 





Parameters 


bval 
A byte expression. 
Return Value 


The string that represents the value of bval. 








Example 
// bt-toStr1.jsl 
// Byte.toString example 
public class MyClass 
{ 
public static void main(String[] args) 
byte b = 127; 
String s = Byte.toString(b); 
System.out.print("The string is: " + s); 
} 
} 
/* 
The result is: 127 
*/ 
See Also 
Reference 
Byte Class 
Concepts 


Byte Members 
java.lang Package 





Visual J# Reference 


Byte.toString Method (J#) 


Overload List 





Name Description 





Byte.ToString () Returns the string that represents the value of a Byte object. 





Byte.ToString (IFormatProvider) |Returns the string that represents the value of a Byte object using a format provider. 











See Also 
Reference 

Byte Class 
Concepts 

Byte Members 
java.lang Package 


Visual J# Reference 


Byte.toString Method (J#) () 


Returns the string that represents the value of a Byte object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toString(); 


Return Value 
The string that represents the value of a Byte object. 
Example 


// bt-toStr2.jsl 
// Byte.toString example 


public class MyClass 


{ 
public static void main(String[] args) 
ii 
Byte b = new Byte("123"); 
// Converting to a string and catenating to another string: 
String s = "The string is: " + b.toString(); 
System.out.print(s); 
} 
} 
/* 
The string is: 123 
=f 
See Also 
Reference 
Byte Class 
Concepts 


Byte Members 
java.lang Package 


Visual J# Reference 


Byte.toString Method (J#) (IFormatProvider) 


Returns the string that represents the value of a Byte object using a format provider. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String ToString( 
System. IFormatProvider provider) ; 


Parameters 
provider 
The format provider. 
Return Value 
The string that represents the value of a Byte object using a format provider. 
Example 


// bt-toStr3.jsl 
// Byte.toString example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
Byte b = new Byte("123"); 
// Converting to a string using a format provider: 
String s = b.toString(nul1) ; 
System.out.print("The string is: " + s); 
} 
i 
/* 
The string is: 123 
* ff 
See Also 
Reference 
Byte Class 
Concepts 


Byte Members 
java.lang Package 


Visual J# Reference 


Byte.ToType Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object ToType( 
System.Type conversionType, 
System. IFormatProvider provider) ; 


Parameters 
conversionType 


provider 


See Also 
Reference 

Byte Class 
Concepts 

Byte Members 
java.lang Package 


Visual J# Reference 


Byte.ToUInt16 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.UInt16 ToUInt16( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Byte Class 
Concepts 

Byte Members 
java.lang Package 


Visual J# Reference 


Byte.ToUInt32 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.UInt32 ToUInt32( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Byte Class 
Concepts 

Byte Members 
java.lang Package 


Visual J# Reference 


Byte.ToUInt64 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.UInt64 ToUInt64( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Byte Class 
Concepts 

Byte Members 
java.lang Package 


Visual J# Reference 


Byte.valueOf Method 


Overload List 





Name Description 





Byte.valueOf (String) Returns the Byte object represented by a string parameter. 





Byte.valueOf (String, int) Returns the Byte object represented by a string parameter in the specified radix. 














See Also 
Reference 

Byte Class 
Concepts 

Byte Members 
java.lang Package 


Visual J# Reference 


Byte.valueOf Method (String) 


Returns the Byte object represented by a string parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.Byte valueOf( 
java.lang.String str) throws java.lang.NumberFormatException; 


Parameters 
str 
The string to be parsed. 
Return Value 
The Byte object represented by str. 
Example 


// bt-Val0f1.jsl 
// Byte.valueOf example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
String s = new String("-128"); 
Byte b = Byte.valueOf(s); 
System.out.print("The byte is: " + b); 
} 
} 
/* 
Output: 
The byte is: -128 
oy 
Remarks 


The string characters must all be decimal digits except the first character, which can be a minus sign (-). 
If the string could not be parsed to a signed decimal byte, the exception java.lang.NumberFormatException is thrown. 


See Also 
Reference 

Byte Class 
Concepts 

Byte Members 
java.lang Package 


Visual J# Reference 


Byte.valueOf Method (String, Int32) 


Returns the Byte object represented by a string parameter in the specified radix. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.Byte valueOf( 
java.lang.String str, 
int radix) throws java.lang.NumberFormatException; 


Parameters 
str 
The string to be parsed. 
radix 
The radix used in parsing str. 
Return Value 
The Byte object represented by str in the specified radix. 
Example 


// bt-Val0f2.js1 
// Byte.valueOf example 


public class MyClass 


{ 
public static void main(String[] args) 
ii 
String s = new String("-80"); 
Byte b = Byte.valueOf(s,16); 
System.out.print("The byte is: " + b); 
} 
} 
/* 
Output: 
The byte is: -128 
wf 
Remarks 


The string characters must all be digits in the specified radix except the first character, which can be a minus sign (-). 
The exception java.lang.NumberFormatException is generated if any of the following conditions occurred: 

The string parameter is null. 

The length of the string parameter is zero (""). 

If the value of the radix is not in the range Character.MIN_RADIX to Character. MAX_RADIX. 

The string does not represent a byte value. 


If any of the characters in the string, except the first character, which can be a minus sign, is not a valid digit in the specified 
radix. 


See Also 
Reference 
Byte Class 
Concepts 

Byte Members 


java.lang Package 


Visual J# Reference 


Character Class 


Wraps the char primitive type into an object. It contains method members to manipulate characters and to change their case. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public final class java.lang.Character 
extends java.lang.Object 
implements java.io.Serializable, System.IConvertible, java.lang.Comparable 


Remarks 
This class implements the interface System.IConvertible (in the NET Framework Class Library). 
Inheritance Hierarchy 
java.lang.Object 
java.lang.Character 


See Also 

Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character Members 


Wraps the char primitive type into an object. It contains method members to manipulate characters and to change their case. 


The following tables list the members exposed by the Character type. 


Public Constructors 
Name Description 








Character Constructs a new Character object that represents a specified char parameter. 








Public Fields 
Name Description 


COMBINING_SPACING_MARK/A Unicode category constant that represents a COMBINING_SPACING_MARK Unicode characte 
r. 


CONNECTOR_PUNCTUATION |A Unicode category constant that represents a CONNECTOR_PUNCTUATION Unicode character 











CONTROL A Unicode category constant that represents a CONTROL Unicode character. 
CURRENCY_SYMBOL A Unicode category constant that represents a CURRENCY_SYMBOL Unicode character. 
DASH_PUNCTUATION A Unicode category constant that represents a DASH_PUNCTUATION Unicode character. 





DECIMAL_DIGIT_.NUMBER A constant returned by getType as the general category of a Unicode character. 


























ENCLOSING_MARK A Unicode category constant that represents a ENCLOSING_MARK Unicode character. 
END_PUNCTUATION A Unicode category constant that represents a END_PUNCTUATION Unicode character. 
FORMAT A Unicode category constant that represents a FORMAT Unicode character. 

LETTER_NUMBER A Unicode category constant that represents a LETTER_-NUMBER Unicode character. 
LINE_SEPARATOR A Unicode category constant that represents a LINELSEPARATOR Unicode character. 
LOWERCASE_LETTER A Unicode category constant that represents a LOWERCASE_LETTER Unicode character. 
MATH_SYMBOL A Unicode category constant that represents a MATH_SYMBOL Unicode character. 

MAX_RADIX The maximum radix usable in converting characters. This constant defines the maximum radix t 


hat can be used to convert a character to or from another radix. 


MAX_VALUE The maximum possible value of a character. 





MIN_RADIX The minimum radix usable in converting characters. This constant defines the minimum radix t 
hat can be used to convert a character to or from another radix. 


MIN_VALUE The minimum possible value of a character. 


MODIFIER_LETTER A Unicode category constant that represents a MODIFIER_LETTER Unicode character. 











MODIFIER_SYMBOL 


A Unicode category constant that represents a MODIFIER_SYMBOL Unicode character. 





NON_SPACING_MARK 


OTHER_LETTER 


OTHER_NUMBER 


OTHER_PUNCTUATION 


OTHER_SYMBOL 


PARAGRAPH_SEPARATOR 


PRIVATE_USE 


A Unicode category constant that represents a NON_SPACING_MARK Unicode character. 


A Unicode category constant that represents an OTHER_LETTER Unicode character. 


A Unicode category constant that represents an OTHER_NUMBER Unicode character. 


A Unicode category constant that represents an OTHER_PUNCTUATION Unicode character. 


A Unicode category constant that represents an OTHER_SYMBOL Unicode character. 


A Unicode category constant that represents a PARAGRAPH_SEPARATOR Unicode character. 


A Unicode category constant that represents a PRIVATE_USE Unicode character. 





SPACE_SEPARATOR 


A Unicode category constant that represents a SPACE_SEPARATOR Unicode character. 





START_PUNCTUATION 


A Unicode category constant that represents a START_PUNCTUATION Unicode character. 





SURROGATE 


A Unicode category constant that represents a SURROGATE Unicode character. 





TITLECASE_LETTER 


A Unicode category constant that represents a TITLECASE_LETTER Unicode character. 





TYPE 


A java.lang.Class representing the Class object for the primitive char type. 





UNASSIGNED 


A Unicode category constant that represents a UNASSIGNED Unicode character. 





UPPERCASE_LETTER 


A Unicode category constant that represents an UPPERCASE_LETTER Unicode character. 





Public Methods 
Name 


charValue 


compareTo 


digit 


equals 


forDigit 


hashCode 


getNumericValue 


Description 


Returns the char value of a Character object. 


Overloaded. 


Returns the numeric value of a specific char in a specified number system. 


Overridden. Checks if a Character object is equal to another object. 


Returns the char that represents a specified digit in a specific radix. 


Overridden. Returns the hash code of the current object. 


Returns the Unicode numeric value that represents a specified char. 











getType Returns the numeric value that represents the general category of a char. 
getClass (inherited from Object ) 
isDefined Checks if a character defined in the Unicode character set. 





isDigit 








Checks if a specified char is a digit. 











isldentifierlgnorable 


Checks if a specified character is ignored in an identifier. 





isISOControl 


Checks if a specified char is an ISO control character. 





isJavaldentifierPart 


Checks if a specified char can be part of a Java identifier other than the first. 





isJavaldentifierStart 


Checks if a specified char can be the first character in a Java identifier. 











isJavaLetter Checks if a specified char can be the first character in a Java identifier. 
isJavaLetterOrDigit Checks if a specified char is a Java letter or digit. 
isLetter Checks if a specified char is a letter. 





isLetterOrDigit 


isLowerCase 


isSpace 


isSpaceChar 


isTitleCase 


isUnicodeldentifierPart 


isUnicodeldentifierStart 


isUpperCase 


isWhitespace 


Checks if a specified char is a letter or digit. 


Checks if a specified char is a lowercase letter. 


Checks if a specified char is a space. 


Checks if a specified char is a Unicode space character. 


Checks if a specified char is a titlecase character. 


Checks if a specified char can be part of a Unicode identifier other than the first. 


Checks if a specified char can be the first character in a Unicode identifier. 


Checks if a specified char is an uppercase letter. 


Checks if a specified char is white space. 











clone Creates a copy of the object. Inherited from java.lang.Object. 
ToBoolean Returns a Boolean object representing a Character object. 
ToByte Returns a Byte object representing a Character object. 
ToChar Returns a Char object representing a Character object. 
ToDateTime Returns a DateTime object representing a Character object. 
ToDecimal Returns a Decimal object representing a Character object. 
ToDouble Returns a Double object representing a Character object. 
Tolnt16 Returns an Int16 object representing a Character object. 
Tolnt32 Returns an Int32 object representing a Character object. 
Tolnt64 Returns an Int64 object representing a Character object. 








toLowerCase 





Converts a char to the lowercase. 






































ToSByte Returns a SByte object representing a Character object. 
ToSingle Returns a Single object representing a Character object. 
toString Overridden. 

toTitleCase Converts a char to its titlecase as specified in the Unicode attribute table. 
ToType Returns a Type representing a Character object. 

ToUInt16 Returns an Ulnt16 object representing a Character object. 
ToUInt32 Returns an Ulnt32 object representing a Character object. 
ToUInt64 Returns an Ulnt64 object representing a Character object. 
toUpperCase Converts a char to the uppercase. 

See Also 

Reference 

Character Class 

Concepts 


java.lang Package 





Visual J# Reference 


Character Fields 


Public Fields 





Name 


Description 





COMBINING_SPACING_MARK/A Unicode category constant that represents a COMBINING_SPACING_MARK Unicode characte 


r. 


CONNECTOR_PUNCTUATION |A Unicode category constant that represents a CONNECTOR_PUNCTUATION Unicode character 





CONTROL 


A Unicode category constant that represents a CONTROL Unicode character. 





CURRENCY_SYMBOL 


DASH_PUNCTUATION 


DECIMAL_DIGIT_.NUMBER 


ENCLOSING_MARK 


END_PUNCTUATION 


FORMAT 


LETTER_NUMBER 


LINE_SEPARATOR 


LOWERCASE_LETTER 


MATH_SYMBOL 


A Unicode category constant that represents a CURRENCY_SYMBOL Unicode character. 


A Unicode category constant that represents a DASH_PUNCTUATION Unicode character. 


A constant returned by getType as the general category of a Unicode character. 


A Unicode category constant that represents a ENCLOSING_MARK Unicode character. 


A Unicode category constant that represents a END_PUNCTUATION Unicode character. 


A Unicode category constant that represents a FORMAT Unicode character. 


A Unicode category constant that represents a LETTER_-NUMBER Unicode character. 


A Unicode category constant that represents a LINELSEPARATOR Unicode character. 


A Unicode category constant that represents a LOWERCASE_LETTER Unicode character. 


A Unicode category constant that represents a MATH_SYMBOL Unicode character. 








MAX_RADIX The maximum radix usable in converting characters. This constant defines the maximum radix t 
hat can be used to convert a character to or from another radix. 

MAX_VALUE The maximum possible value of a character. 

MIN_RADIX The minimum radix usable in converting characters. This constant defines the minimum radix t 
hat can be used to convert a character to or from another radix. 

MIN_VALUE The minimum possible value of a character. 


MODIFIER_LETTER 


A Unicode category constant that represents a MODIFIER_LETTER Unicode character. 





MODIFIER_SYMBOL 


A Unicode category constant that represents a MODIFIER_SYMBOL Unicode character. 





NON_SPACING_MARK 


A Unicode category constant that represents a NON_SPACING_MARK Unicode character. 





OTHER_LETTER 


A Unicode category constant that represents an OTHER_LETTER Unicode character. 





OTHER_NUMBER 





A Unicode category constant that represents an OTHER_NUMBER Unicode character. 











OTHER_PUNCTUATION 


A Unicode category constant that represents an OTHER_PUNCTUATION Unicode character. 





OTHER_SYMBOL 


A Unicode category constant that represents an OTHER_SYMBOL Unicode character. 





PARAGRAPH_SEPARATOR 


A Unicode category constant that represents a PARAGRAPH_SEPARATOR Unicode character. 





PRIVATE_USE 


A Unicode category constant that represents a PRIVATE_USE Unicode character. 





SPACE_SEPARATOR 


A Unicode category constant that represents a SPACE_SEPARATOR Unicode character. 





START_PUNCTUATION 


A Unicode category constant that represents a START_PUNCTUATION Unicode character. 





SURROGATE 


A Unicode category constant that represents a SURROGATE Unicode character. 





TITLECASE_LETTER 


TYPE 


UNASSIGNED 


UPPERCASE_LETTER 





See Also 
Reference 
Character Class 
Concepts 
java.lang Package 


A Unicode category constant that represents a TITLECASE_LETTER Unicode character. 
A Unicode category constant that represents a TYPE Unicode character. 
A Unicode category constant that represents a UNASSIGNED Unicode character. 


A Unicode category constant that represents an UPPERCASE_LETTER Unicode character. 





Visual J# Reference 


Character.COMBINING SPACING MARK Field 


A Unicode category constant that represents a COMBINING_SPACING_MARK Unicode character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final byte COMBINING SPACING MARK; 





Remarks 


The following table shows the Unicode characters and their categories. Each Unicode character belong a specific category that 
can be returned by the method getType. 


The following constants are not included in the table: 
MIN_VALUE 
MAX_VALUE 
MIN_RADIX 
MAX_RADIX 


See the corresponding topic for a definition of a specific constant. 















































Constant Category |Unicode Displayed |Remarks 

value character 
SPACE_SEPARATOR 12 in Space 
LINE_SEPARATOR 13 <?> Line Separator 
PARAGRAPH_SEPARATOR 14 <?> Paragraph separator 
UPPERCASE_LETTER 1 A Latin capital letter A 
LOWERCASE_LETTER 2 a Latin small letter a 
TITLECASE_LETTER 3 Dz Latin capital letter D with small letter z 
MODIFIER_LETTER 4 h Modifier letter small h 
OTHER_LETTER 5 <?> Latin letter two with stroke 
DECIMAL_DIGIT.NUMBER 9 0 Digit zero 
LETTER_.NUMBER 10 <?> Runic Arlaug 
OTHER_NUMBER 11 2 \w0082 —_Supersci two 
NON_SPACING_MARK 6 i \w0300 Combining Grave accent 
ENCLOSING_MARK 7 <?> \w048s Combining Cyrillic hundred thousand sign 
COMBINING_SPACING_MARK 8 <?> \w0803_Devnagar sign visarga 



































DASH_PUNCTUATION 20 ? \u002D Hyphen-Minus 
START_PUNCTUATION 21 ( \wo02s Lek parenthesis 
END_PUNCTUATION 22 ) \wo029 ight parenthesis 
CONNECTOR_PUNCTUATION 23 <?> woos ow line (Spacing underscore) 
OTHER_PUNCTUATION 24 ! \w0021_xcamation mark 
MATH_SYMBOL 25 + \wo028 Ps sign 
CURRENCY_SYMBOL 26 $ \wo024 ol sign 
MODIFIER_SYMBOL 27 iN \uO05E Circumflex accent 
OTHER_SYMBOL 28 | \u00A6 Broken bar 
CONTROL 15 <control> |\u000A Line feed 
FORMAT 16 <?> \u06DD {Arabic end of ayah 
UNASSIGNED 0 <?> \u0221 

PRIVATE_USE 18 <?> \uEO00 

SURROGATE 19 <?> \uD800 

Notes: 


<?> means that there is no suitable font to display this character 


<control> means that it is a control character that has no type face. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 





Visual J# Reference 


Character.CONNECTOR_PUNCTUATION Field 


A Unicode category constant that represents a CONNECTOR_PUNCTUATION Unicode character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final byte CONNECTOR_PUNCTUATION; 


Example 
See the table in COMBINING_SPACING_MARK. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.CONTROL Field 


A Unicode category constant that represents a CONTROL Unicode character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final byte CONTROL; 





Example 
See the table in COMBINING_SPACING_MARK. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.CURRENCY SYMBOL Field 


A Unicode category constant that represents a CURRENCY_SYMBOL Unicode character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final byte CURRENCY_SYMBOL; 


Example 
See the table in COMBINING_SPACING_MARK. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.DASH_PUNCTUATION Field 


A Unicode category constant that represents a DASH_PUNCTUATION Unicode character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final byte DASH_PUNCTUATION; 


Example 
See the table in COMBINING_SPACING_MARK. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.DECIMAL_DIGIT_NUMBER Field 


A constant returned by getType as the general category of a Unicode character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final byte DECIMAL_DIGIT_NUMBER; 


Example 
See the table in COMBINING_SPACING_MARK. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character. ENCLOSING MARK Field 


A Unicode category constant that represents a ENCLOSING_MARK Unicode character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final byte ENCLOSING MARK; 


Example 
See the table in COMBINING_SPACING_MARK. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.END_PUNCTUATION Field 


A Unicode category constant that represents a END_PUNCTUATION Unicode character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final byte END PUNCTUATION; 


Example 
See the table in COMBINING_SPACING_MARK. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.FORMAT Field 


A Unicode category constant that represents a FORMAT Unicode character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final byte FORMAT; 





Example 
See the table in COMBINING_SPACING_MARK. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.LETTER_NUMBER Field 


A Unicode category constant that represents a LETTER_NUMBER Unicode character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final byte LETTER_NUMBER; 


Example 
See the table in COMBINING_SPACING_MARK. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.LINE_SEPARATOR Field 


A Unicode category constant that represents a LINE_SEPARATOR Unicode character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final byte LINE_SEPARATOR; 


Example 
See the table in COMBINING_SPACING_MARK. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.LOWERCASE LETTER Field 


A Unicode category constant that represents a LOWERCASE_LETTER Unicode character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final byte LOWERCASE LETTER; 


Example 
See the table in COMBINING_SPACING_MARK. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character. MATH SYMBOL Field 


A Unicode category constant that represents a MATH_SYMBOL Unicode character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final byte MATH_SYMBOL; 


Example 
See the table in COMBINING_SPACING_MARK. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character. MAX_RADIX Field 


The maximum radix usable in converting characters. This constant defines the maximum radix that can be used to convert a 
character to or from another radix. 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final char MAX_RADIX; 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character. MAX VALUE Field 


The maximum possible value of a character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final char MAX_VALUE; 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.MIN_RADIX Field 


The minimum radix usable in converting characters. This constant defines the minimum radix that can be used to convert a 
character to or from another radix. 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final char MIN_RADIX; 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.MIN_VALUE Field 


The minimum possible value of a character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final char MIN_VALUE; 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.MODIFIER_LETTER Field 


A Unicode category constant that represents a MODIFIER_LETTER Unicode character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final byte MODIFIER_LETTER; 


Example 
See the table in COMBINING_SPACING_MARK. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character. MODIFIER_SYMBOL Field 


A Unicode category constant that represents a MODIFIER_SYMBOL Unicode character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final byte MODIFIER_SYMBOL; 


Example 
See the table in COMBINING_SPACING_MARK. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.NON SPACING MARK Field 


A Unicode category constant that represents a NON_SPACING_MARK Unicode character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final byte NON_SPACING MARK; 


Example 
See the table in COMBINING_SPACING_MARK. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.OTHER_LETTER Field 


A Unicode category constant that represents an OTHER_LETTER Unicode character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final byte OTHER_LETTER; 


Example 
See the table in COMBINING_SPACING_MARK. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.OTHER_NUMBER Field 


A Unicode category constant that represents an OTHER_NUMBER Unicode character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final byte OTHER_NUMBER; 


Example 
See the table in COMBINING_SPACING_MARK. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.OTHER_PUNCTUATION Field 


A Unicode category constant that represents an OTHER_PUNCTUATION Unicode character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final byte OTHER_PUNCTUATION; 


Example 
See the table in COMBINING_SPACING_MARK. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.OTHER_ SYMBOL Field 


A Unicode category constant that represents an OTHER_SYMBOL Unicode character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final byte OTHER_SYMBOL; 


Example 
See the table in COMBINING_SPACING_MARK. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.PARAGRAPH_SEPARATOR Field 


A Unicode category constant that represents a PARAGRAPH_SEPARATOR Unicode character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final byte PARAGRAPH_SEPARATOR; 


Example 
See the table in COMBINING_SPACING_MARK. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.PRIVATE USE Field 


A Unicode category constant that represents a PRIVATE_USE Unicode character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final byte PRIVATE_USE; 





Example 
See the table in COMBINING_SPACING_MARK. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.SPACE SEPARATOR Field 


A Unicode category constant that represents a SPACE_SEPARATOR Unicode character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final byte SPACE _SEPARATOR; 


Example 
See the table in COMBINING_SPACING_MARK. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.START_PUNCTUATION Field 


A Unicode category constant that represents a START_PUNCTUATION Unicode character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final byte START_PUNCTUATION; 


Example 
See the table in COMBINING_SPACING_MARK. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.SURROGATE Field 


A Unicode category constant that represents a SURROGATE Unicode character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final byte SURROGATE; 





Example 
See the table in COMBINING_SPACING_MARK. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character. TITLECASE LETTER Field 


A Unicode category constant that represents a TITLECASE_LETTER Unicode character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final byte TITLECASE LETTER; 


Example 
See the table in COMBINING_SPACING_MARK. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.TYPE Field 


A java.lang.Class representing the Class object for the primitive char type. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final java.lang.Class TYPE; 





See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character. UNASSIGNED Field 


A Unicode category constant that represents a UNASSIGNED Unicode character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final byte UNASSIGNED; 


Example 
See the table in COMBINING_SPACING_MARK. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.UPPERCASE LETTER Field 


A Unicode category constant that represents an UPPERCASE_LETTER Unicode character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final byte UPPERCASE LETTER; 


Example 
See the table in COMBINING_SPACING_MARK. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character Constructor 


Constructs a new Character object that represents a specified char parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.Character( 
char ch); 





Parameters 


ch 
A char parameter. 
Example 


This example constructs a new character object using the char value ‘A’. 











// c-ctor1.jsl 
// Character ctor example 
public class MyClass 
{ 
public static void main(String[] args) 
{ 
Character c = new Character('A'); 
System.out.print(c); 
} 
} 
/* 
Output: 
A 
ay 
See Also 
Reference 
Character Class 
Concepts 


Character Members 
java.lang Package 


Visual J# Reference 


Character Methods 


Public Methods 





Name 


Description 

















getNumericValue 


getType 


getClass 


isDefined 


isDigit 


isldentifierlgnorable 


isISOControl 


isJavaldentifierPart 


isJavaldentifierStart 


isJavaLetter 


isJavaLetterOrDigit 


isLetter 


isLetterOrDigit 


charValue Returns the char value of a Character object. 

compareTo Overloaded. 

digit Returns the numeric value of a specific char in a specified number system. 
equals Overridden. Checks if a Character object is equal to another object. 
forDigit Returns the char that represents a specified digit in a specific radix. 
hashCode Overridden. Returns the hash code of the current object. 


Returns the Unicode numeric value that represents a specified char. 


Returns the numeric value that represents the general category of a char. 


(inherited from Object ) 


Checks if a character defined in the Unicode character set. 


Checks if a specified char is a digit. 


Checks if a specified character is ignored in an identifier. 


Checks if a specified char is an ISO control character. 


Checks if a specified char can be part of a Java identifier other than the first. 


Checks if a specified char can be the first character in a Java identifier. 


Checks if a specified char can be the first character in a Java identifier. 


Checks if a specified char is a Java letter or digit. 


Checks if a specified char is a letter. 


Checks if a specified char is a letter or digit. 











isLowerCase Checks if a specified char is a lowercase letter. 

isSpace Checks if a specified char is a space. 

isSpaceChar Checks if a specified char is a Unicode space character. 
isTitleCase Checks if a specified char is a titlecase character. 





isUnicodeldentifierPart 








Checks if a specified char can be part of a Unicode identifier other than the first. 









































isUnicodeldentifierStart Checks if a specified char can be the first character in a Unicode identifier. 
isUpperCase Checks if a specified char is an uppercase letter. 
isWhitespace Checks if a specified char is white space. 

clone 

ToBoolean Returns a Boolean object representing a Character object. 
ToByte Returns a Byte object representing a Character object. 
ToChar Returns a Char object representing a Character object. 
ToDateTime Returns a DateTime object representing a Character object. 
ToDecimal Returns a Decimal object representing a Character object. 
ToDouble Returns a Double object representing a Character object. 
Tolnt16 Returns an Int16 object representing a Character object. 
Tolnt32 Returns an Int32 object representing a Character object. 
Tolnt64 Returns an Int64 object representing a Character object. 
toLowerCase Converts a char to the lowercase. 

ToSByte Returns a SByte object representing a Character object. 
ToSingle Returns a Single object representing a Character object. 
toString Overloaded. Overridden. 

toTitleCase Converts a char to its titlecase as specified in the Unicode attribute table. 
ToType Returns a Type representing a Character object. 

ToUInt16 Returns an Ulnt16 object representing a Character object. 
ToUInt32 Returns an Ulnt32 object representing a Character object. 
ToUInt64 Returns an Ulnt64 object representing a Character object. 
toUpperCase Converts a char to the uppercase. 

See Also 

Reference 

Character Class 

Concepts 


java.lang Package 





Visual J# Reference 


Character.charValue Method 


Returns the char value of a Character object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public char charValue(); 





Return Value 


The char value stored in the Character object. 


Example TE 











// c-charValue1.jsl 
// Character.charValue example 
public class MyClass 
{ 
public static void main(String[] args) 
if 
Character obj = new Character('Z'); 
char c = obj.charValue(); 
System.out.print("The value of the object is " +c); 
} 
} 
/* 
Output: 
The value of the object is Z 
= / 
See Also 
Reference 
Character Class 
Concepts 


Character Members 
java.lang Package 


Visual J# Reference 


Character.clone Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.compareTo Method 


Overload List 





Name Description 





Character.compareTo (character) |Compares a specified Character object to the current Character object numerically. 








Character.compareTo (Object) Compares the current Character object to another object numerically. 











See Also 
Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.compareTo Method (Character) 


Compares a specified Character object to the current Character object numerically. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public int compareTo( 
java.lang.Character aChar); 


Parameters 
aChar 


The object to compare to. 
Return Value 


-1 if the parameter value is greater than the value of the current object. 0 if the two objects are identical. 1 if the parameter 
value is less than the value of the current object. 


Example 


// c-compareTo1.jsl 
// Character.compareTo example 


public class MyClass 
{ 


public static void main(String[] args) 

if 
Character obj1 = new Character('A'); 
Character obj2 = new Character('Z'); 
int result1 = obj1.compareTo(obj2); 
int result2 = obj1.compareTo(obj1); 
int result3 = obj2.compareTo(obj1); 
System.out.println("The comparison result is: 
System.out.println("The comparison result is: 
System.out.println("The comparison result is: 


+ result1); 
+ result2); 
+ result3); 


} 


/* 

Output: 

The comparison result is: -1 
The comparison result is: @ 

The comparison result is: 1 


*/ 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.compareTo Method (Object) 


Compares the current Character object to another object numerically. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public int compareTo( 
java.lang.Object obj); 


Parameters 


obj 
The object to compare to. 
Return Value 


If the two objects are of the type Character, the method behaves exactly like compareTo, and the returned values are: -1 if the 
parameter value is greater than the value of the current object. 0 if the two objects are identical. 1 if the parameter value is less 
than the value of the current object. 


Example 


See the example on compareTo. 


Remarks 
If the compared object is not a Character object the exception java.lang.ClassCastException is generated. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.digit Method 


Returns the numeric value of a specific char in a specified number system. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static int digit( 
char ch, 
int radix); 


Parameters 
ch 
The char whose numeric value is returned. 
radix 
The radix of the specified number system. 
Return Value 
The numeric value of ch in the number system specified by radix. 
Example 


// c-digit1.jsl 
// Character.digit example 


public class MyClass 


{ 
public static void main(String[] args) 
// The character: 
System.out.println('\uee42"); 
// The numeric value: 
System.out.println(Character.digit('\u@e42', 16)); 
} 
} 
/* 
Output 
B 
11 
a 
Remarks 


This method returns the numeric value of ch if it is considered as a digit in the specified radix. 
If the value of radix is not a valid radix, or ch is not a valid digit in the specified radix, then -1 is returned. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.equals Method 


Checks if a Character object is equal to another object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public boolean equals( 
java.lang.Object obj); 


Parameters 
obj 
The object to compare to. 
Return Value 
true if the two objects are identical; false otherwise. 
Example 


// c-equals1.jsl 
// Character.equals example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
boolean result1, result2; 
Character obj1 = new Character('A'); 
Character obj2 = new Character('Z'); 
result1 = obj1.equals(obj2); 
result2 = obj1.equals(obj1); 
System.out.println("The comparison result is: " + result1); 
System.out.println("The comparison result is: " + result2); 
} 
} 
/* 
Output: 


The comparison result is: false 
The comparison result is: true 


*/ 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.forDigit Method 


Returns the char that represents a specified digit in a specific radix. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static char forDigit( 
int digit, 
int radix); 


Parameters 
digit 
The int to be converted to char. 
radix 
The radix of the number system. 
Return Value 
The char that represents the specified digit in the specific radix. 
Example 


// c-foDigit1.jsl 
// Character.forDigit example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
for (int i=@; i <= 15; i++) 
System.out.print(Character.forDigit(i, 16)+ " "); 
} 
} 
/* 
Output: 
@123456789abcdef 
*/ 
Remarks 


If the value of radix is not a valid radix, or the value of digit is not a valid digit in the specified radix, the null character is 
returned. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.hashCode Method 


Returns the hash code of the current object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public int hashCode(); 


Return Value 
The hash code of the current object. 
Example 


// c-HashCode1.jsl 
// Character.GetHashCode example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
Character obj1 = new Character('A'); 
Character obj2 = new Character('Z'); 
int hc1 = obj1.GetHashCode(); 
int hc2 = obj2.GetHashCode(); 
System.out.println("The hash code of A is: " + hc1); 
System.out.println("The hash code of Z is: " + hc2); 
} 
} 
/* 
Output: 


The hash code of A is: 65 
The hash code of Z is: 90 
*/ 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.getNumericValue Method 


Returns the Unicode numeric value that represents a specified char. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static int getNumericValue( 
char ch); 


Parameters 
ch 
The char whose Unicode value to be returned. 
Return Value 
The Unicode numeric value that represents the specified char. 
Example 


// c-GetNumVal1.jsl 
// Character.getNumericVlaue example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
System.out.printlin("The letter A = " + 
Character.getNumericValue('\uee41")); 
System.out.printlin("The letter Z = " + 
Character.getNumericValue('\u@@5A')); 
System.out.printlin("The fraction char u@@BC returns: " + 
Character.getNumericValue('\u@@BC')); 
System.out.println( 
"The char u@F2A, which doesn't have a numeric value returns: " 
+ Character. getNumericValue('\u@F2A')); 
} 
} 
/* 
Output: 


The letter A = 10 

The letter Z = 35 

The fraction char u@@BC returns: -2 

The char u@F2A, which doesn't have a numeric value returns: -1 


*/ 


Remarks 
This method returns the Unicode numeric value of the character as a nonnegative integer. 
If the character does not have a numeric value, then -1 is returned. 


If the character has a numeric value that cannot be represented as a nonnegative integer, for example, a fractional value, then - 
2 is returned. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.getType Method 


Returns the numeric value that represents the general category of a char. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static int getType( 
char ch); 


Parameters 
ch 
The char whose general category to be returned. 
Return Value 
The numeric value that represents the general category of the char. 
Example 


// c-getTypel.jsl 
// Character.getType example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
int t1 = Character.getType('A'); 
int t2 = Character.getType('a'); 
System.out.println("The category of 'A' is: " + t1); 
System.out.printlin("The category of 'a' is: " + t2); 
} 
} 
/* 
Output: 


The category of 'A' is: 1 
The category of ‘a' is: 2 
*/ 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.isDefined Method 


Checks if a character defined in the Unicode character set. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static boolean isDefined( 
char ch); 


Parameters 


ch 
The char to be checked. 
Return Value 
true if the char is defined in the Unicode character set; false otherwise. 
Example 


// c-isDefined1.jsl 
// Character.isDefined example 


public class MyClass 
{ 


public static void main(String[] args) 


{ 
System.out.println(Character.isDefined('a')); 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.isDigit Method 


Checks if a specified char is a digit. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static boolean isDigit( 
char ch); 


Parameters 
ch 
The char to be checked. 
Return Value 
true if the char is a digit; false otherwise. 
Example 


// c-isDigit1.jsl 
// Character.isDigit example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
char cl ='A'; 
char c2 = '3'; 
boolean b1 = Character.isDigit(c1); 
boolean b2 = Character.isDigit(c2); 
if(b1 == true) 
System.out.println(c1 + " is a digit."); 
else 
System.out.println(c1 + " is not a digit."); 
if(b2 == true) 
System.out.println(c2 + " is a digit."); 
else 
System.out.println(c2 + " is not a digit."); 
} 
} 
/* 
Output: 


A is not a digit. 
3 is a digit. 
wd 


Remarks 
The character is a digit if its general category is DECIMAL_DIGIT_.NUMBER. 
The Unicode range from '\u0030' to '\u0039' contains the ISO-LATIN-1 digits from 0 to 9. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.isldentifierlgnorable Method 


Checks if a specified character is ignored in an identifier. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static boolean isIdentifierIgnorable( 
char ch); 


Parameters 
ch 
The char in to be checked. 
Return Value 
true if the char could be ignored in an identifier, false otherwise. 
Example 


// c-isIdIgni.jsl 
// isIdentifierIgnorable example 


public class MyClass 


{ 
public static void main(String[] args) 
// This char is not ignorable: 
System.out.println(Character.isIdentifierIgnorable('\ueee9d')); 
// This char is ignorable: 
System.out.println(Character.isIdentifierIgnorable('\ueee7')); 
} 
} 
/* 
Output 
false 
true 
= 
Remarks 


The ignorable Unicode characters are control characters which are not whitespace: 
from '\u0000') to '\u0008' 
from '\uQOOE’) to '\u001B' 
from '\u007F' to '\uO09F' 
The Join controls: 

from '\u200C' to '\u200F' 
Bidirectional controls: 
from '\u202A‘ to '\u202E' 
Format controls: 

from '\u206A‘ to '\u206F' 
Zero-width no-break space 


'\UFEFF' 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.is!SOControl Method 


Checks if a specified char is an ISO control character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static boolean isISOControl( 
char ch); 


Parameters 


ch 
The char to be checked. 
Return Value 
true if the char is an ISO control character; false otherwise. 
Example 


// c-ISOcotl1.jsl 
// Character.isISOControl example 


public class MyClass 
{ 


public static void main(String[] args) 


{ 
System.out.println(Character.isISOControl('\u@@8F')); 


System.out.println(Character.isISOControl('\ug@eee' )); 
System.out.println(Character.isISOControl('\u@1@F')); 


Remarks 
ISO control characters fall within the range \u0000 through \u001F or \u007F through \uO09F. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.isJavaldentifierPart Method 


Checks if a specified char can be part of a Java identifier other than the first. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static boolean isJavaIdentifierPart( 
char ch); 


Parameters 
ch 
The char in to be checked. 
Return Value 
true if the char can be used as part of a Java identifier other than the first; false otherwise. 
Example 


// c-isIdPart1.jsl 
// Character.isJavaIdentifierPart example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
System.out.printlin("It is " 
+ Character.isJavaIldentifierPart('\u@e41') + 
" that '\u@041" can be part of an identifier." ); 
System.out.printlin("It is " 
+ Character.isJavaIldentifierPart('\u@e4e') + 
" that '\u@040' can be part of an identifier." ); 
} 
} 
/* 
Output: 


It is true that 'A' can be part of an identifier. 
It is false that '@' can be part of an identifier. 


*/ 
Remarks 
The characters that are can be part of Java identifiers are: 
Alphabetic letters. 
The currency symbols, such as $. 
The connecting punctuation characters, such as ‘_'. 
Digits. 
Combining-spacing-mark, non-spacing-mark and identifier-ignorable characters. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.isJavaldentifierStart Method 


Checks if a specified char can be the first character in a Java identifier. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static boolean isJavaIdentifierStart( 
char ch); 


Parameters 
ch 
The char to be checked. 
Return Value 
true if the char can be used as the first character in a Java identifier; false otherwise. 
Example 


// c-isIdstart1.jsl 
// Character.isJavaIdentifierStart example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
System.out.printlin("It is " 
+ Character.isJavaldentifierStart('\u@e41') + 
" that '\u@041" can be an identifier start." ); 
System.out.printlin("It is " 
+ Character.isJavaldentifierStart('\u@e40') + 
" that '\u@040' can be an identifier start." ); 
} 
} 
/* 
Output: 


It is true that 'A' can be an identifier start. 
It is false that '@' can be an identifier start. 


*/ 


Remarks 
The characters that are allowed to start identifiers are: 
Letters. 


The currency symbols, such as $. 


The connecting punctuation characters, such as ‘_'. 
See Also 

Reference 

Character Class 

Concepts 

Character Members 

java.lang Package 


Visual J# Reference 


Character.isJavaLetter Method 


Checks if a specified char can be the first character in a Java identifier. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static boolean isJavaLetter( 
char ch); 


Parameters 
ch 
The char to be checked. 
Return Value 
true if the char is a Java letter; false otherwise. 
Example 


// c-isJletter1.jsl 
// Character.isJavaLetter example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
char cl ='A'; 
char c2 = '3'; 
boolean b1 = Character.isJavaLetter(c1); 
boolean b2 = Character.isJavaLetter(c2); 
if(b1 == true) 
System.out.println(c1 + " is a Java letter."); 
else 
System.out.println(c1 + " is not a Java letter."); 
if(b2 == true) 
System.out.println(c2 + " is a Java letter."); 
else 
System.out.println(c2 + " is not a Java letter."); 
} 
} 
/* 
Output: 


A is a Java letter. 
3 is not a Java letter. 
ey 
Remarks 
This method is replaced by isJavaldentifierStart. 
The characters that are allowed to start identifiers are: 
Letters. 
The currency symbols, such as $. 


The connecting punctuation characters, such as ‘_'. 


See Also 
Reference 
Character Class 
Concepts 


Character Members 
java.lang Package 


Visual J# Reference 


Character.isJavaLetterOrDigit Method 


Checks if a specified char is a Java letter or digit. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static boolean isJavaLetterOrDigit( 
char ch); 


Parameters 
ch 
The char to be checked. 
Return Value 
true if the char is a Java letter or digit; false otherwise. 
Example 


// c-isjJlet-dig1.jsl 
// Character.isJavaLetterOrDigitr example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
char cl ='A'; 
char c2 = '3'; 
boolean b1 = Character.isJavaLetterOrDigit(c1); 
boolean b2 = Character.isJavaLetterOrDigit(c2); 
if(b1 == true) 
System.out.println(c1 + " is a Java letter/digit."); 
else 
System.out.println(c1 + " is not a Java letter/digit."); 
if(b2 == true) 
System.out.println(c2 + " is a Java letter/digit."); 
else 
System.out.println(c2 + " is not a Java letter/digit."); 
} 
} 
/* 
Output: 


A is a Java letter/digit. 
3 is a Java letter/digit. 
wd 
Remarks 
The characters that are can be part of Java identifiers are: 
Alphabetic letters. 
The currency symbols, such as $. 
The connecting punctuation characters, such as ‘_'. 
Digits. 
Combining-spacing-mark, non-spacing-mark and identifier-ignorable characters. 


See Also 
Reference 


Character Class 


Concepts 
Character Members 
java.lang Package 


Visual J# Reference 


Character.isLetter Method 


Checks if a specified char is a letter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static boolean isLetter( 
char ch); 
| 


Parameters 


ch 
The char to be checked. 
Return Value 
true if the char is a letter; false otherwise. 
Example 


// c-isletter1.jsl 
// Character.isLetter example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
char cl ='A'; 
char c2 = '3'; 
boolean b1 = Character.isLetter(c1); 
boolean b2 = Character.isLetter(c2); 
if(b1 == true) 
System.out.println(c1 + " is a letter."); 
else 
System.out.println(c1 + " is not a letter."); 
if(b2 == true) 
System.out.println(c2 + " is a letter."); 
else 
System.out.println(c2 + " is not a letter."); 
} 
} 
/* 
Output: 


A is a letter. 
3 is not a letter. 
Le 
Remarks 
The character is a letter if its general category is one of the following: LOWERCASE_LETTER 
UPPERCASE_LETTER 
TITLECASE_LETTER 
MODIFIER_LETTER 
OTHER_LETTER 


See Also 
Reference 
Character Class 
Concepts 


Character Members 
java.lang Package 


Visual J# Reference 


Character.isLetterOrDigit Method 


Checks if a specified char is a letter or digit. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static boolean isLetterOrDigit( 
char ch); 


Parameters 
ch 
The char to be checked. 
Return Value 
true if the char is a letter or digit; false otherwise. 
Example 


// c-islet-dig1.jsl 
// Character.isLetterOrDigitr example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
char cl ='A'; 
char c2 = '3'; 
boolean b1 = Character.isLetterOrDigit(c1); 
boolean b2 = Character.isLetterOrDigit(c2); 
if(b1 == true) 
System.out.println(c1 + " is a letter/digit."); 
else 
System.out.println(c1 + " is not a letter/digit."); 
if(b2 == true) 
System.out.println(c2 + " is a letter/digit."); 
else 
System.out.println(c2 + " is not a letter/digit."); 
} 
} 
/* 
Output: 


A is a letter/digit. 
3 is a letter/digit. 
wd 


Remarks 
The charch is a letter or digit if one of the following methods returns true: 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.isLowerCase Method 


Checks if a specified char is a lowercase letter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static boolean isLowerCase( 
char ch); 


Parameters 
ch 
The char to be checked. 
Return Value 
true if the char is a lowercase letter; false otherwise. 
Example 


// c-islower1.jsl 
// Character.isLowerCase example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
char cl ='A'; 
char c2 = ‘'a'; 
boolean b1 = Character.isLowerCase(c1); 
boolean b2 = Character.isLowerCase(c2); 
if(b1 == true) 
System.out.println(c1 + " is lowercase."); 
else 
System.out.println(c1 + " is not lowercase."); 
if(b2 == true) 
System.out.println(c2 + " is lowercase."); 
else 
System.out.println(c2 + " is not lowercase."); 
} 
} 
/* 
Output: 


A is not lowercase. 
a is lowercase. 


*/ 


Remarks 
The character is a lowercase letter if its general category is LOWERCASE_LETTER. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.isSpace Method 


Checks if a specified char is a space. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static boolean isSpace( 
char ch); 


Parameters 
ch 
The char to be checked. 
Return Value 
true if the char is a space; false otherwise. 
Example 


// c-isSpace1.jsl 
// Character.isSpace example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
char cl ='A'; 
char c2 = ' '; 
boolean b1 = Character.isSpace(c1); 
boolean b2 = Character.isSpace(c2); 
if(b1 == true) 
System.out.printin("'" + c1 + "'" + " is a space."); 
else 
System.out.printin("'" + c1 + "'" + " is not a space."); 
if(b2 == true) 
System.out.printin("'" + c2 + "'" + " is a space."); 
else 
System.out.printin("'" + c2 + "'" + " is not a space."); 
} 
} 
/* 
Output: 


"A' is not a space. 
" "is a space. 
*/ 
Remarks 
This method is replaced by isWhitespace. 
A character is space if it is one of the following: 
Horizontal tab (‘\u0009') 
Line feed (‘\u000A’) 
Form feed (‘\u000C’) 
Carriage return (‘\u000D’) 
A space (‘\u0020') 


See Also 


Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.isSpaceChar Method 


Checks if a specified char is a Unicode space character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static boolean isSpaceChar( 
char ch); 


Parameters 
ch 
The char to be checked. 
Return Value 
true if the char is a Unicode space character; false otherwise. 
Example 


// c-isSpChar1.jsl 
// Character.isSpaceChar example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Testing an alphabetic character: 
System.out.println("It is " 
+ Character.isSpaceChar('\u@042') + 
" that '\u@0@42' is a Unicode space char."); 
// Testing the Character.DASH PUNCTUATION field: 
System.out.println("It is " 
+ Character.isSpaceChar('\u@@20') + 
" that '\u@@20' is a Unicode space char."); 
} 
} 
/* 
Output: 
It is false that 'B' is a space char. 
It is true that ' ' is a space char. 
*/ 
See Also 
Reference 
Character Class 
Concepts 


Character Members 
java.lang Package 


Visual J# Reference 


Character.isTitleCase Method 


Checks if a specified char is a titlecase character. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static boolean isTitleCase( 


char ch); 
| 


Parameters 


ch 
The char to be checked. 
Return Value 
true if the char is title case, false otherwise. 
Example 
See the example on toTitleCase. 
Remarks 
The character is considered a titlecase character if the general category type of this character is TITLECASE_LETTER. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.isUnicodeldentifierPart Method 


Checks if a specified char can be part of a Unicode identifier other than the first. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static boolean isUnicodeIdentifierPart( 
char ch); 


Parameters 
ch 
The char in to be checked. 
Return Value 
true if the char can be used as part of a Unicode identifier other than the first; false otherwise. 
Example 


// c-isIdUPart1.jsl 
// Character.isUnicodeIdentifierPart example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
System.out.printlin("It is " 
+ Character.isUnicodeIdentifierPart('\u@041') + 
" that '\u@041" can be part of an identifier." ); 
System.out.printlin("It is " 
+ Character.isUnicodeIdentifierPart('\u@e40') + 
" that '\u@040' can be part of an identifier." ); 
} 
} 
/* 
Output: 


It is true that 'A' can be part of an identifier. 
It is false that '@' can be part of an identifier. 
*/ 


Remarks 

The characters that are can be part of Unicode identifiers are: 
Alphabetic letters. 

The currency symbols, such as $. 

The connecting punctuation characters, such as ‘_'. 

Digits. 

Combining-spacing-mark, non-spacing-mark and identifier-ignorable characters. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.isUnicodeldentifierStart Method 


Checks if a specified char can be the first character in a Unicode identifier. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static boolean isUnicodeIdentifierStart( 
char ch); 


Parameters 
ch 
The char to be checked. 
Return Value 
true if the specified char can be the first character in a Unicode identifier; false otherwise. 
Example 


// c-isIdUStart1.jsl 
// Character.isUnicodeIdentifierStart example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
System.out.printlin("It is " 
+ Character.isUnicodeIdentifierStart('\u@e41') + 
" that '\u@041" can be part of an identifier." ); 
System.out.printlin("It is " 
+ Character.isUnicodeIdentifierStart('\u@e4e') + 
" that '\u@040' can be part of an identifier." ); 
} 
} 
/* 
Output: 


It is true that 'A' can be part of an identifier. 
It is false that '@' can be part of an identifier. 
*/ 


Remarks 
The characters that are allowed to start Unicode identifiers are: 
Alphabetic Letters. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.isUpperCase Method 


Checks if a specified char is an uppercase letter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static boolean isUpperCase( 
char ch); 


Parameters 
ch 
The char to be checked. 
Return Value 
true if the char is an uppercase letter; false otherwise. 
Example 


// c-isupper1.jsl 
// Character.isUpperCase example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
char cl ='A'; 
char c2 = ‘'a'; 
boolean b1 = Character.isUpperCase(c1); 
boolean b2 = Character.isUpperCase(c2); 
if(b1 == true) 
System.out.println(c1 + " is uppercase."); 
else 
System.out.println(c1 + " is not uppercase."); 
if(b2 == true) 
System.out.println(c2 + " is uppercase."); 
else 
System.out.println(c2 + " is not uppercase."); 
} 
} 
/* 
Output: 


A is uppercase. 
a is not uppercase. 


*/ 


Remarks 
The character is an uppercase letter if its general category is UPPERCASE_LETTER. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.isWhitespace Method 


Checks if a specified char is white space. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static boolean iswWhitespace( 
char ch); 


Parameters 
ch 
The char to be checked. 
Return Value 
true if the char is white space; false otherwise. 
Example 


// c-isWSpace1.jsl 
// Character.isWhitespace example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
char ci ='A'; 
char c2 = ' '; 
boolean b1 = Character.iswWhitespace(c1); 
boolean b2 = Character.iswWhitespace(c2); 
if(b1 == true) 
System.out.printin("'" + c1 + "'" + " is a white space."); 
else 
System.out.printin("'" + cl +4 "'" 4+ 
"is not a white space."); 
if(b2 == true) 
System.out.printin("'" + c2 +4 """ 4+ 
"is a white space."); 
else 
System.out.printin("'" + c2 +4 """ 4+ 
"is not a white space."); 
} 
} 
/* 
Output: 


"A' is not a white space. 
: is a white space. 
*/ 
Remarks 
A character is a whitespace if its one of the following: 


A Unicode category Zs (‘\u3000’), ZI (\u2028),or Zp (‘\u2029'), but not also a non-breaking space character such as \UOOAO or 
\u2007 


Horizontal tab ('‘\u0009') 
Line feed (‘\u000A’) 
Vertical tab (‘\u000B’') 


Form feed (‘\u000C’) 
Carriage return (‘\u000D’) 
File separator (‘\u001C’) 
Group separator (‘\u001D') 
Record separator (‘\u001E’) 
Unit separator (‘\u001F’) 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character. ToBoolean Method 


Returns a Boolean object representing a Character object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public boolean ToBoolean( 
System. IFormatProvider provider) ; 


Parameters 
provider 


Provides information needed for formatting. 
Return Value 
A Boolean object representing a Character object. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character. ToByte Method 


Returns a Byte object representing a Character object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.Byte ToByte( 
System. IFormatProvider provider) ; 


Parameters 
provider 


Provides information needed for formatting. 
Return Value 
A Byte object representing a Character object. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.ToChar Method 


Returns a Char object representing a Character object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public char ToChar( 
System. IFormatProvider provider) ; 


Parameters 
provider 


Provides information needed for formatting. 
Return Value 
A Char object representing a Character object. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.ToDateTime Method 


Returns a DateTime object representing a Character object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.DateTime ToDateTime( 
System. IFormatProvider provider) ; 


Parameters 
provider 


Provides information needed for formatting. 
Return Value 
A DateTime object representing a Character object. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character. ToDecimal Method 


Returns a Decimal object representing a Character object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.Decimal ToDecimal ( 
System. IFormatProvider provider) ; 


Parameters 
provider 


Provides information needed for formatting. 
Return Value 
A Decimal object representing a Character object. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.ToDouble Method 


Returns a Double object representing a Character object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public double ToDouble( 
System. IFormatProvider provider) ; 


Parameters 
provider 


Provides information needed for formatting. 
Return Value 
A Double object representing a Character object. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.Tolnt16 Method 


Returns an Int16 object representing a Character object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public short ToInt16( 
System. IFormatProvider provider) ; 


Parameters 
provider 


Provides information needed for formatting. 
Return Value 
An Int16 object representing a Character object. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.Tolnt32 Method 


Returns an Int32 object representing a Character object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public int ToInt32( 
System. IFormatProvider provider) ; 


Parameters 
provider 


Provides information needed for formatting. 
Return Value 
An Int32 object representing a Character object. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character. Tolnt64 Method 


Returns an Int64 object representing a Character object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public long ToInt64( 
System. IFormatProvider provider) ; 


Parameters 
provider 


Provides information needed for formatting. 
Return Value 
An Int64 object representing a Character object. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.toLowerCase Method 


Converts a char to the lowercase. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static char toLowerCase( 
char ch); 


Parameters 
ch 
The char to be converted. 
Return Value 
The lowercase char, if it was uppercase; the same char otherwise. 
Example 


// c-toLower1.jsl 
// Character.toLowerCase example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
char c1 = Character.toLowerCase('A'); 
char c2 = Character.toLowerCase('a'); 
System.out.println(c1); 
System.out.println(c2); 
} 
} 
/* 
Output: 
a 
a 
*/ 
See Also 
Reference 
Character Class 
Concepts 


Character Members 
java.lang Package 


Visual J# Reference 


Character.ToSByte Method 


Returns a SByte object representing a Character object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public byte ToSByte( 
System. IFormatProvider provider) ; 


Parameters 
provider 


Provides information needed for formatting. 
Return Value 
An SByte object representing a Character object. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.ToSingle Method 


Returns a Single object representing a Character object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public float ToSingle( 
System. IFormatProvider provider) ; 


Parameters 
provider 


Provides information needed for formatting. 
Return Value 
A Single object representing a Character object. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.toString Method 


Overload List 





Name Description 





Character.ToString () Converts a Character object to a string. 








Character.ToString (lFormatProvider) Returns a String object representing a Character object. 











See Also 
Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.toString Method () 


Converts a Character object to a string. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.String toString(); 





Return Value 


The char converted to a string. 


Example TE 








// c-toString1.jsl 
// Character.toString example 
public class MyClass 
{ 
public static void main(String[] args) 
{ 
Character c = new Character('A'); 
// Convert to a String object: 
String s = c.toString(); 
System.out.println("The first three letters are: " + s + "BC"); 
} 
} 
f® 
Output: 
The first three letters are: ABC 
mn] 
See Also 
Reference 
Character Class 
Concepts 


Character Members 
java.lang Package 


Visual J# Reference 


Character.toString Method (IFormatProvider) 


Returns a String object representing a Character object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String ToString( 
System. IFormatProvider provider) ; 


Parameters 
provider 


Provides information needed for formatting. 
Return Value 
A String object representing a Character object. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.toTitleCase Method 


Converts a char to its titlecase as specified in the Unicode attribute table. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static char toTitleCase( 
char ch); 


Parameters 
ch 
The char to be converted. 
Return Value 
The titlecase character of the parameter. 
Example 


// c-toTitlecase1.jsl 
// Character.toTitleCase example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Converts to titlecase if exists, or to uppercase otherwise: 
System.out.println(Character.toTitleCase('i')); 
// The following statement true only if the character 
// is TitleCase: 
System.out.println( 
Character.isTitleCase(Character.toTitleCase('I'))); 
} 
} 
/* 
Output: 
I 
false 
*/ 
Remarks 


If the character has a titlecase equivalent specified in the Unicode attribute table, then that titlecase equivalent character is 
returned. Otherwise, if the character is a lowercase letter, the uppercase letter is returned, else the character itself is returned. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.ToType Method 


Returns a Type representing a Character object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object ToType( 
System.Type conversionType, 
System. IFormatProvider provider) ; 


Parameters 
conversionType 


The Type to convert the Character object into. 
provider 
Provides information needed for formatting. 
Return Value 
An object of type conversionType representing a Character object. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character. ToUInt16 Method 


Returns an Ulnt16 object representing a Character object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.UInt16 ToUInt16( 
System. IFormatProvider provider) ; 


Parameters 
provider 


Provides information needed for formatting. 
Return Value 
An UInt16 object representing a Character object. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.ToUInt32 Method 


Returns an Ulnt32 object representing a Character object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.UInt32 ToUInt32( 
System. IFormatProvider provider) ; 


Parameters 
provider 


Provides information needed for formatting. 
Return Value 
An UInt32 object representing a Character object. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character. ToUInt64 Method 


Returns an Ulnt64 object representing a Character object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.UInt64 ToUInt64( 
System. IFormatProvider provider) ; 


Parameters 
provider 


Provides information needed for formatting. 
Return Value 
An UInt64 object representing a Character object. 


See Also 

Reference 
Character Class 
Concepts 

Character Members 
java.lang Package 


Visual J# Reference 


Character.toUpperCase Method 


Converts a char to the uppercase. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static char toUpperCase( 
char ch); 


Parameters 
ch 
The char to be converted. 
Return Value 
The uppercase char, if it was lowercase; the same char otherwise. 
Example 


// c-toUpper1.jsl 
// Character.toUpperCase example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
char c1 = Character.toUpperCase('A'); 
char c2 = Character.toUpperCase('a'); 
System.out.println(c1); 
System.out.println(c2); 
} 
} 
/* 
Output: 
A 
A 
=f 
See Also 
Reference 
Character Class 
Concepts 


Character Members 
java.lang Package 
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Character.Subset Class 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public class java.lang.Character.Subset 
extends java.lang.Object 





Inheritance Hierarchy 
java.lang.Object 
java.lang.Character.Subset 
java.lang.Character.UnicodeBlock 


See Also 

Concepts 

Character.Subset Members 
java.lang Package 


Visual J# Reference 


Character.Subset Members 


The following tables list the members exposed by the Character.Subset type. 


Public Constructors 
Name 


Character.Subset 





Public Methods 











Name Description 

equals Overridden. 

hashCode Overridden. 

getClass (inherited from Object ) 
clone 

toString Overridden. 





Protected Methods 





Name Description 





finalize (inherited from Object ) 














See Also 

Reference 
Character.Subset Class 
Concepts 

java.lang Package 
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Character.Subset Constructor 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java.lang.Character.Subset( 
java.lang.String name); 





Parameters 
name 


See Also 

Reference 
Character.Subset Class 
Concepts 

Character.Subset Members 
java.lang Package 
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Character.Subset Methods 


Public Methods 























Protected Methods 


Name Description 

equals Overridden. 

hashCode Overridden. 

getClass (inherited from Object ) 
clone 

toString Overridden. 








Name 


Description 





finalize 








(inherited from Object ) 





See Also 

Reference 
Character.Subset Class 
Concepts 

java.lang Package 
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Character.Subset.clone Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





See Also 

Reference 
Character.Subset Class 
Concepts 

Character.Subset Members 
java.lang Package 


Visual J# Reference 


Character.Subset.equals Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public final boolean equals( 
java.lang.Object obj); 


Parameters 


obj 


See Also 

Reference 
Character.Subset Class 
Concepts 

Character.Subset Members 
java.lang Package 
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Character.Subset.hashCode Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public final int hashCode(); 


See Also 

Reference 
Character.Subset Class 
Concepts 

Character.Subset Members 
java.lang Package 
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Character.Subset.toString Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public final java.lang.String toString(); 


See Also 

Reference 
Character.Subset Class 
Concepts 

Character.Subset Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock Class 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public final class java.lang.Character.UnicodeBlock 
extends java.lang.Character$Subset 





Inheritance Hierarchy 

java.lang.Object 
java.lang.Character.Subset 
java.lang.Character.UnicodeBlock 


See Also 

Concepts 

Character.UnicodeBlock Members 
java.lang Package 
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Character.UnicodeBlock Members 


The following tables list the members exposed by the Character.UnicodeBlock type. 


Public Fields 
Name Description 


ALPHABETIC_PRESENTATION_FORMS 
ARABIC 
ARABIC_PRESENTATION_FORMS_A 


ARABIC_PRESENTATION_FORMS_B 





ARMENIAN 





ARROWS 





BASIC_LATIN 





BENGALI 





BLOCK_ELEMENTS 





BOPOMOFO 





BOX_DRAWING 





CJK_COMPATIBILITY 





CJK_COMPATIBILITY_FORMS 





CJK_COMPATIBILITY_IDEOGRAPHS 





CJK_SYMBOLS_AND_PUNCTUATION 





CJK_UNIFIED_IDEOGRAPHS 





COMBINING_DIACRITICAL_MARKS 





COMBINING_HALF_MARKS 





COMBINING_MARKS_FOR_SYMBOLS 


CONTROL_PICTURES 


CURRENCY_SYMBOLS 


CYRILLIC 


DEVANAGARI 














DINGBATS 





ENCLOSED_ALPHANUMERICS 





ENCLOSED_CJK_LETTERS_AND_MONTHS 





GENERAL_PUNCTUATION 





GEOMETRIC_SHAPES 





GEORGIAN 





GREEK 





GREEK_EXTENDED 


GUJARATI 


GURMUKHI 


HALFWIDTH_AND_FULLWIDTH_FORMS 


HANGUL_COMPATIBILITY_ JAMO 


HANGUL_JAMO 


HANGUL_SYLLABLES 


HEBREW 


HIRAGANA 


IPA_EXTENSIONS 


KANBUN 


KANNADA 


KATAKANA 


LAO 


LATIN_1_SUPPLEMENT 


LATIN_EXTENDED_A 





LATIN_EXTENDED_ADDITIONAL 





LATIN_EXTENDED_B 





LETTERLIKE_LSYMBOLS 








MALAYALAM 














MATHEMATICAL_OPERATORS 





MISCELLANEOUS_SYMBOLS 


MISCELLANEOUS_TECHNICAL 


NUMBER_FORMS 


OPTICAL_CHARACTER_RECOGNITION 


ORIYA 


PRIVATE_USE_AREA 


SMALL_FORM_VARIANTS 





SPACING_MODIFIER_LETTERS 





SPECIALS 





SUPERSCRIPTS_AND_SUBSCRIPTS 





SURROGATES_AREA 





TAMIL 





TELUGU 





THAI 





TIBETAN 








Public Methods 








Name Description 

equals (inherited from Character.Subset ) 
hashCode (inherited from Character.Subset ) 
getClass (inherited from Object ) 

clone (inherited from Character.Subset ) 
of 

toString (inherited from Character.Subset ) 
See Also 

Reference 


Character.UnicodeBlock Class 


Concepts 
java.lang Package 





Visual J# Reference 


Character.UnicodeBlock Fields 


Public Fields 





Name Description 





ALPHABETIC_PRESENTATION_FORMS 





ARABIC 





ARABIC_PRESENTATION_FORMS_A 





ARABIC_PRESENTATION_FORMS_B 





ARMENIAN 


ARROWS 


BASIC_LATIN 


BENGALI 


BLOCK_ELEMENTS 


BOPOMOFO 


BOX_DRAWING 


CJK_COMPATIBILITY 


CJK_COMPATIBILITY_FORMS 


CJK_COMPATIBILITY_IDEOGRAPHS 


CJK_SYMBOLS_AND_PUNCTUATION 


CJK_UNIFIED_IDEOGRAPHS 


COMBINING_DIACRITICAL_MARKS 


COMBINING_HALF_MARKS 


COMBINING_MARKS_FOR_SYMBOLS 


CONTROL_PICTURES 





CURRENCY_SYMBOLS 





CYRILLIC 





DEVANAGARI 





DINGBATS 

















ENCLOSED_ALPHANUMERICS 





ENCLOSED_CJK_LETTERS_AND_MONTHS 





GENERAL_PUNCTUATION 





GEOMETRIC_SHAPES 





GEORGIAN 





GREEK 





GREEK_EXTENDED 





GUJARATI 


GURMUKHI 


HALFWIDTH_AND_FULLWIDTH_FORMS 


HANGUL_COMPATIBILITY_ JAMO 


HANGUL_JAMO 


HANGUL_SYLLABLES 


HEBREW 


HIRAGANA 


IPA_EXTENSIONS 


KANBUN 


KANNADA 


KATAKANA 


LAO 


LATIN_1_SUPPLEMENT 


LATIN_EXTENDED_A 


LATIN_EXTENDED_ADDITIONAL 





LATIN_EXTENDED_B 





LETTERLIKE_LSYMBOLS 





MALAYALAM 








MATHEMATICAL_OPERATORS 














MISCELLANEOUS_SYMBOLS 





MISCELLANEOUS_TECHNICAL 





NUMBER_FORMS 





OPTICAL_CHARACTER_RECOGNITION 





ORIYA 





PRIVATE_USE_AREA 





SMALL_FORM_VARIANTS 





SPACING_MODIFIER_LETTERS 


SPECIALS 


SUPERSCRIPTS_AND_SUBSCRIPTS 


SURROGATES_AREA 


TAMIL 


TELUGU 


THAI 


TIBETAN 





See Also 
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Character.UnicodeBlock Class 
Concepts 

java.lang Package 








Visual J# Reference 


Character.UnicodeBlock. ALPHABETIC PRESENTATION FORMS 
Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock ALPHABETIC_PRESENTATION_FORMS; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.ARABIC Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock ARABIC; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 
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Character.UnicodeBlock.ARABIC_PRESENTATION FORMS A 
Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock ARABIC_PRESENTATION_FORMS_ A; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 
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Character.UnicodeBlock.ARABIC_PRESENTATION FORMS B 
Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock ARABIC_PRESENTATION_FORMS B; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 
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Character.UnicodeBlock. ARMENIAN Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock ARMENIAN; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 
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Character.UnicodeBlock.ARROWS Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock ARROWS; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 
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Character.UnicodeBlock.BASIC_ LATIN Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock BASIC_LATIN; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 
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Character.UnicodeBlock.BENGALI Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock BENGALT; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.BLOCK_ ELEMENTS Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock BLOCK_ELEMENTS; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.BOPOMOFO Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock BOPOMOFO; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.,BOX_DRAWING Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock BOX_DRAWING; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 
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Character.UnicodeBlock.CJK_ COMPATIBILITY Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock CJK_COMPATIBILITY; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.CJK_COMPATIBILITY FORMS Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock CJK_COMPATIBILITY_FORMS; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.cJK_ COMPATIBILITY IDEOGRAPHS 
Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock CJK_COMPATIBILITY_IDEOGRAPHS ; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 
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Character.UnicodeBlock.CJK SYMBOLS AND PUNCTUATION 
Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock CJK_SYMBOLS_AND_ PUNCTUATION; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.cCJK_UNIFIED_IDEOGRAPHS Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock CJK_UNIFIED_IDEOGRAPHS ; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.COMBINING DIACRITICAL MARKS 
Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock COMBINING _DIACRITICAL_MARKS; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.COMBINING HALF_MARKS Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock COMBINING_HALF_MARKS; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.COMBINING MARKS FOR SYMBOLS 
Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock COMBINING MARKS _FOR_SYMBOLS; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 
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Character.UnicodeBlock.CONTROL PICTURES Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock CONTROL_PICTURES; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.CURRENCY SYMBOLS Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock CURRENCY_SYMBOLS; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 
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Character.UnicodeBlock.CYRILLIC Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock CYRILLIC; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.DEVANAGARI Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock DEVANAGARI; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.DINGBATS Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock DINGBATS; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.ENCLOSED ALPHANUMERICS Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock ENCLOSED ALPHANUMERICS; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.ENCLOSED CJK_LETTERS AND MONTHS 
Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock ENCLOSED _CJK_LETTERS AND MONTHS; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.GENERAL PUNCTUATION Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock GENERAL_PUNCTUATION; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.GEOMETRIC_ SHAPES Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock GEOMETRIC_SHAPES; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 
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Character.UnicodeBlock.GEORGIAN Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock GEORGIAN; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.GREEK Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock GREEK; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 
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Character.UnicodeBlock.GREEK_EXTENDED Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock GREEK_EXTENDED; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.GUJARATI Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock GUJARATI; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.GURMUKHI Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock GURMUKHI; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.HALFWIDTH AND FULLWIDTH FORMS 
Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock HALFWIDTH_AND_FULLWIDTH_FORMS; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.HANGUL_ COMPATIBILITY JAMO Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock HANGUL_COMPATIBILITY_JAMO; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.HANGUL JAMO Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock HANGUL_JAMO; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.HANGUL SYLLABLES Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock HANGUL_SYLLABLES; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.HEBREW Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock HEBREW; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.HIRAGANA Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock HIRAGANA; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 
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Character.UnicodeBlock.IPA_EXTENSIONS Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock IPA_EXTENSIONS; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 
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Character.UnicodeBlock.KANBUN Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock KANBUN; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.KANNADA Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock KANNADA; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.KATAKANA Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock KATAKANA; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.LAO Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock LAO; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.LATIN_1 SUPPLEMENT Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock LATIN_1_ SUPPLEMENT; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.LATIN EXTENDED A Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock LATIN_EXTENDED_A; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.LATIN_EXTENDED_ADDITIONAL Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock LATIN_EXTENDED_ADDITIONAL ; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.LATIN EXTENDED B Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock LATIN_EXTENDED_B; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.LETTERLIKE SYMBOLS Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock LETTERLIKE_SYMBOLS; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.MALAYALAM Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock MALAYALAM; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock. MATHEMATICAL OPERATORS Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock MATHEMATICAL_OPERATORS; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.MISCELLANEOUS SYMBOLS Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock MISCELLANEOUS SYMBOLS; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.MISCELLANEOUS TECHNICAL Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock MISCELLANEOUS_TECHNICAL ; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.NUMBER_FORMS Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock NUMBER_FORMS; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.OPTICAL CHARACTER RECOGNITION 
Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock OPTICAL_CHARACTER_RECOGNITION; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 
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Character.UnicodeBlock.ORIYA Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock ORIYA; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 
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Character.UnicodeBlock.PRIVATE_USE AREA Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock PRIVATE_USE_ AREA; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 
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Character.UnicodeBlock.SMALL FORM VARIANTS Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock SMALL_FORM_VARIANTS; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 
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Character.UnicodeBlock.SPACING MODIFIER_LETTERS Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock SPACING _MODIFIER_LETTERS; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 
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Character.UnicodeBlock.SPECIALS Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock SPECIALS; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 
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Character.UnicodeBlock.SUPERSCRIPTS AND SUBSCRIPTS 
Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock SUPERSCRIPTS AND SUBSCRIPTS; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 
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Character.UnicodeBlock.SURROGATES AREA Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock SURROGATES AREA; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 
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Character.UnicodeBlock.TAMIL Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock TAMIL; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 
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Character.UnicodeBlock. TELUGU Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock TELUGU; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 


Visual J# Reference 


Character.UnicodeBlock.THAI Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock THAI; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 
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Character.UnicodeBlock.TIBETAN Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final java.lang.Character.UnicodeBlock TIBETAN; 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 
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Character.UnicodeBlock Methods 


Public Methods 


























Name Description 

equals (inherited from Character.Subset ) 
hashCode (inherited from Character.Subset ) 
getClass (inherited from Object ) 

clone (inherited from Character.Subset ) 
of 

toString (inherited from Character.Subset ) 
See Also 

Reference 

Character.UnicodeBlock Class 

Concepts 


java.lang Package 
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Character.UnicodeBlock.of Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.Character$UnicodeBlock of ( 
char c); 


Parameters 
Cc 


See Also 

Reference 
Character.UnicodeBlock Class 
Concepts 

Character.UnicodeBlock Members 
java.lang Package 
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ClassCastException Class 


The exception that is thrown when attempting to cast an object to a class that it cannot be cast to. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.ClassCastException 
extends java. lang.RuntimeException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.lang.RuntimeException 
java.lang.ClassCastException 


See Also 

Concepts 

ClassCastException Members 
java.lang Package 
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ClassCastException Members 


The exception that is thrown when attempting to cast an object to a class that it cannot be cast to. 


The following tables list the members exposed by the ClassCastException type. 


Public Constructors 





Name Description 





ClassCastException Overloaded. Initializes a new instance of a ClassCastException object. 





Public Properties (see also Protected Properties 




















Name Description 

HelpLink (inherited from Exception ) 
InnerException (inherited from Exception ) 
Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 


Name Description 


HResult (inherited from Exception ) 





Public Methods 


























Name Description 

<exceptFilter> Maps various invalid casting exceptions to a java.lang.ClassCastException. 
equals (inherited from Object ) 

filllnStackTrace (inherited from Throwable ) 

GetBaseException (inherited from Exception ) 

hashCode (inherited from Object ) 

getLocalizedMessage (inherited from Throwable ) 

getMessage (inherited from Throwable ) 

GetObjectData (inherited from Throwable ) 

getClass (inherited from Object ) 


clone (inherited from Throwable ) 











printStackTrace Overloaded. (inherited from Throwable ) 





toString (inherited from Throwable ) 





Protected Methods 
Name Description 








finalize (inherited from Object ) 














See Also 

Reference 
ClassCastException Class 
Concepts 

java.lang Package 
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ClassCastException Constructor 


Initializes a new instance of a ClassCastException object. 


Overload List 


Name Description 

ClassCastException () Initializes a new instance of a ClassCastException object. 

ClassCastException (String) Initializes a new instance of a ClassCastException object with the give 
n message. 





ClassCastException (SerializationInfo, StreamingContext)|Initializes a new instance of a ClassCastException object during deseri 
alization. 


ClassCastException (String, Exception) Initializes a new instance of a ClassCastException object with the give 
n message and inner exception. 








See Also 

Reference 
ClassCastException Class 
Concepts 

ClassCastException Members 
java.lang Package 
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ClassCastException Constructor () 


Initializes a new instance of a ClassCastException object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.ClassCastException(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
ClassCastException Class 
Concepts 

ClassCastException Members 
java.lang Package 
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ClassCastException Constructor (String) 


Initializes a new instance of a ClassCastException object with the given message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.ClassCastException( 
java.lang.String s); 


Parameters 
Ss 


A message describing the exceptional condition. 


See Also 

Reference 
ClassCastException Class 
Concepts 

ClassCastException Members 
java.lang Package 
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ClassCastException Constructor (SerializationInfo, 
StreamingContext) 


Initializes a new instance of a ClassCastException object during deserialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java. lang.ClassCastException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
ClassCastException Class 
Concepts 

ClassCastException Members 
java.lang Package 
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ClassCastException Constructor (String, Exception) 


Initializes a new instance of a ClassCastException object with the given message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.ClassCastException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the exceptional condition. 
inner 
An inner exception that led to a ClassCastException. 


See Also 

Reference 
ClassCastException Class 
Concepts 

ClassCastException Members 
java.lang Package 
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ClassCastException Methods 


Public Methods 





Name 


Description 





<exceptFilter> 


Maps various invalid casting exceptions to a java.lang.ClassCastException. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 


Protected Methods 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


ClassCastException Class 


Concepts 
java.lang Package 
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ClassCastException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
ClassCastException Class 
Concepts 

java.lang Package 








Visual J# Reference 


ClassCircularityError Class 


The error that is thrown when the execution engine encounters a circular inheritance within any class hierarchy. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.ClassCircularityError 
extends java.lang.LinkageError 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Error 
java.lang.LinkageError 
java.lang.ClassCircularityError 


See Also 

Concepts 

ClassCircularityError Members 
java.lang Package 
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ClassCircularityError Members 


The error that is thrown when the execution engine encounters a circular inheritance within any class hierarchy. 


The following tables list the members exposed by the ClassCircularityError type. 


Public Constructors 





Name Description 





ClassCircularityError Overloaded. Initializes a new instance of a ClassCircularityError object. 





Public Properties (see also Protected Properties 




















Name Description 

HelpLink (inherited from Exception ) 
InnerException (inherited from Exception ) 
Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 


Name Description 


HResult (inherited from Exception ) 





Public Methods 


























Name Description 

equals (inherited from Object ) 
filllnStackTrace (inherited from Throwable ) 
GetBaseException (inherited from Exception ) 
hashCode (inherited from Object ) 
getLocalizedMessage (inherited from Throwable ) 
getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 
clone (inherited from Throwable ) 


printStackTrace Overloaded. (inherited from Throwable ) 











toString 


(inherited from Throwable ) 





Protected Methods 
Name 


finalize 





See Also 

Reference 
ClassCircularityError Class 
Concepts 

java.lang Package 





(inherited from Object ) 
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ClassCircularityError Constructor 


Initializes a new instance of a ClassCircularityError object. 


Overload List 


Name Description 
ClassCircularityError () Initializes a new instance of a ClassCircularityError object. 
ClassCircularityError (String) Initializes a new instance of a ClassCircularityError object with the gi 


ven message. 





ClassCircularityError (SerializationInfo, StreamingContext)|Initializes a new instance of a ClassCircularityError object during de 
serialization. 


ClassCircularityError (String, Exception) Initializes a new instance of a ClassCircularityError object with the gi 
ven message and inner exception. 











See Also 

Reference 
ClassCircularityError Class 
Concepts 

ClassCircularityError Members 
java.lang Package 
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ClassCircularityError Constructor () 


Initializes a new instance of a ClassCircularityError object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.ClassCircularityError(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
ClassCircularityError Class 
Concepts 

ClassCircularityError Members 
java.lang Package 
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ClassCircularityError Constructor (String) 


Initializes a new instance of a ClassCircularityError object with the given message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.ClassCircularityError( 
java.lang.String s); 


Parameters 
Ss 


A message describing the error condition. 


See Also 

Reference 
ClassCircularityError Class 
Concepts 

ClassCircularityError Members 
java.lang Package 
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ClassCircularityError Constructor (SerializationInfo, 
StreamingContext) 


Initializes a new instance of a ClassCircularityError object during deserialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java.lang.ClassCircularityError( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
ClassCircularityError Class 
Concepts 

ClassCircularityError Members 
java.lang Package 
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ClassCircularityError Constructor (String, Exception) 


Initializes a new instance of a ClassCircularityError object with the given message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.ClassCircularityError( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the error condition. 
inner 
An inner exception that led to the ClassCircularityError. 


See Also 

Reference 
ClassCircularityError Class 
Concepts 

ClassCircularityError Members 
java.lang Package 
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ClassCircularityError Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


ClassCircularityError Class 


Concepts 
java.lang Package 
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ClassCircularityError Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
ClassCircularityError Class 
Concepts 

java.lang Package 








Visual J# Reference 


ClassFormatError Class 


The error that is thrown when the execution engine attempts to load a class that is improperly formatted. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.ClassFormatError 
extends java.lang.LinkageError 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Error 
java.lang.LinkageError 
java.lang.ClassFormatError 


See Also 

Concepts 

ClassFormatError Members 
java.lang Package 
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ClassFormatError Members 


The error that is thrown when the execution engine attempts to load a class that is improperly formatted. 


The following tables list the members exposed by the ClassFormatError type. 


Public Constructors 





Name Description 





ClassFormatError Overloaded. Initializes a new instance of a ClassFormatError object. 








Public Properties (see also Protected Properties 




















Name Description 

HelpLink (inherited from Exception ) 
InnerException (inherited from Exception ) 
Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 


Name Description 


HResult (inherited from Exception ) 





Public Methods 


























Name Description 

equals (inherited from Object ) 
filllnStackTrace (inherited from Throwable ) 
GetBaseException (inherited from Exception ) 
hashCode (inherited from Object ) 
getLocalizedMessage (inherited from Throwable ) 
getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 
clone (inherited from Throwable ) 


printStackTrace Overloaded. (inherited from Throwable ) 











toString 


(inherited from Throwable ) 





Protected Methods 
Name 


finalize 





See Also 

Reference 
ClassFormatError Class 
Concepts 

java.lang Package 





(inherited from Object ) 
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ClassFormatError Constructor 


Initializes a new instance of a ClassFormatError object. 


Overload List 


Name Description 

ClassFormatError () Initializes a new instance of a ClassFormatError object. 

ClassFormatError (String) Initializes a new instance of a ClassFormatError object with the given 
message. 





ClassFormatError (SerializationInfo, StreamingContext)|Initializes a new instance of a ClassFormatError object during deserializ 
ation. 


ClassFormateError (String, Exception) Initializes a new instance of a ClassFormatError object with the given 
message and inner exception. 





See Also 

Reference 
ClassFormatError Class 
Concepts 

ClassFormatError Members 
java.lang Package 
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ClassFormatError Constructor () 


Initializes a new instance of a ClassFormatError object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.ClassFormatError(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
ClassFormatError Class 
Concepts 

ClassFormatError Members 
java.lang Package 
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ClassFormatError Constructor (String) 


Initializes a new instance of a ClassFormatError object with the given message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.ClassFormatError( 
java.lang.String s); 


Parameters 
Ss 


A message describing the error condition. 


See Also 

Reference 
ClassFormatError Class 
Concepts 

ClassFormatError Members 
java.lang Package 
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ClassFormatError Constructor (SerializationInfo, 
StreamingContext) 


Initializes a new instance of a ClassFormatError object during deserialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java.lang.ClassFormatError( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
ClassFormatError Class 
Concepts 

ClassFormatError Members 
java.lang Package 
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ClassFormatError Constructor (String, Exception) 


Initializes a new instance of a ClassFormatError object with the given message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.ClassFormatError( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the error condition. 
inner 
An inner exception that led to the ClassFormatError. 


See Also 

Reference 
ClassFormatError Class 
Concepts 

ClassFormatError Members 
java.lang Package 
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ClassFormatError Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


ClassFormatError Class 


Concepts 
java.lang Package 
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ClassFormatError Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
ClassFormatError Class 
Concepts 

java.lang Package 
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ClassNotFoundException Class 


The exception that is thrown when attempting to load a class using reflection that cannot be found. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.ClassNotFoundException 
extends java.lang.Exception 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.lang.ClassNotFoundException 


See Also 

Concepts 

ClassNotFoundException Members 
java.lang Package 
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ClassNotFoundException Members 


The exception that is thrown when attempting to load a class using reflection that cannot be found. 


The following tables list the members exposed by the ClassNotFoundException type. 


Public Constructors 





Name 


Description 





ClassNotFoundException 


Overloaded. Initializes a new instance of a ClassNotFoundException object. 





Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 





Description 


(inherited from Exception ) 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 








printStackTrace 





getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 

clone (inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 








toString (inherited from Throwable ) 





Protected Methods 
Name 


finalize (inherited from Object ) 








See Also 

Reference 
ClassNotFoundException Class 
Concepts 

java.lang Package 
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ClassNotFoundException Constructor 


Initializes a new instance of a ClassNotFoundException object. 


Overload List 
Name 


ClassNotFoundException () 


ClassNotFoundException (String) 


Description 


Initializes a new instance of a ClassNotFoundException object. 


Initializes a new instance of a ClassNotFoundException object w 
ith the given message. 





ClassNotFoundException (SerializationInfo, StreamingContext) 


ClassNotFoundException (String, Exception) 





See Also 

Reference 
ClassNotFoundException Class 
Concepts 

ClassNotFoundException Members 
java.lang Package 





Initializes a new instance of a ClassNotFoundException object d 
uring deserialization. 


Initializes a new instance of a ClassNotFoundException object w 
ith the given message and inner exception. 
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ClassNotFoundException Constructor () 


Initializes a new instance of a ClassNotFoundException object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.ClassNotFoundException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
ClassNotFoundException Class 
Concepts 

ClassNotFoundException Members 
java.lang Package 
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ClassNotFoundException Constructor (String) 


Initializes a new instance of a ClassNotFoundException object with the given message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.ClassNotFoundException( 
java.lang.String s); 


Parameters 
Ss 


A message describing the exceptional condition. 


See Also 

Reference 
ClassNotFoundException Class 
Concepts 

ClassNotFoundException Members 
java.lang Package 
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ClassNotFoundException Constructor (SerializationInfo, 
StreamingContext) 


Initializes a new instance of a ClassNotFoundException object during deserialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java. lang.ClassNotFoundException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
ClassNotFoundException Class 
Concepts 

ClassNotFoundException Members 
java.lang Package 
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ClassNotFoundException Constructor (String, Exception) 


Initializes a new instance of a ClassNotFoundException object with the given message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.ClassNotFoundException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the exceptional condition. 
inner 
An inner exception that led to the ClassNotFoundException. 


See Also 

Reference 
ClassNotFoundException Class 
Concepts 

ClassNotFoundException Members 
java.lang Package 
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ClassNotFoundException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


ClassNotFoundException Class 


Concepts 
java.lang Package 
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ClassNotFoundException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 


ClassNotFoundException Class 


Concepts 
java.lang Package 
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CloneNotSupportedException Class 


The exception that is thrown when attempting to clone an object that does not support cloning. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public class java.lang.CloneNotSupportedException 
extends java.lang.Exception 
| 


Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.lang.CloneNotSupportedException 


See Also 

Concepts 

CloneNotSupportedException Members 
java.lang Package 
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CloneNotSupportedException Members 


The exception that is thrown when attempting to clone an object that does not support cloning. 


The following tables list the members exposed by the CloneNotSupportedException type. 


Public Constructors 





Name 


Description 





CloneNotSupportedException 


Overloaded. Initializes a new instance of a CloneNotSupportedException object. 








Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 





Description 


(inherited from Exception ) 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 








printStackTrace 





getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 

clone (inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 








toString (inherited from Throwable ) 





Protected Methods 
Name 








finalize (inherited from Object ) 
See Also 

Reference 

CloneNotSupportedException Class 

Concepts 


java.lang Package 
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CloneNotSupportedException Constructor 


Initializes a new instance of a CloneNotSupportedException object. 


Overload List 





Name Description 

CloneNotSupportedException () Initializes a new instance of a CloneNotSupportedExceptio 
n object. 

CloneNotSupportedException (String) Initializes a new instance of a CloneNotSupportedExceptio 


n object with the given message. 


CloneNotSupportedException (SerializationInfo, StreamingContext)|Initializes a new instance of a CloneNotSupportedExceptio 
n during deserialization. 


CloneNotSupportedException (String, Exception) Initializes a new instance of a CloneNotSupportedExceptio 
n with the given message and inner exception. 








See Also 

Reference 
CloneNotSupportedException Class 
Concepts 

CloneNotSupportedException Members 
java.lang Package 
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CloneNotSupportedException Constructor () 


Initializes a new instance of a CloneNotSupportedException object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.CloneNotSupportedException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
CloneNotSupportedException Class 
Concepts 

CloneNotSupportedException Members 
java.lang Package 
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CloneNotSupportedException Constructor (String) 


Initializes a new instance of a CloneNotSupportedException object with the given message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.CloneNotSupportedException( 


java.lang.String s); 
| 


Parameters 
S 


A message describing the exceptional condition. 


See Also 

Reference 
CloneNotSupportedException Class 
Concepts 

CloneNotSupportedException Members 
java.lang Package 
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CloneNotSupportedException Constructor (SerializationInfo, 
StreamingContext) 


Initializes a new instance of a CloneNotSupportedException during deserialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java. lang.CloneNotSupportedException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
CloneNotSupportedException Class 
Concepts 

CloneNotSupportedException Members 
java.lang Package 
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CloneNotSupportedException Constructor (String, Exception) 


Initializes a new instance of a CloneNotSupportedException with the given message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.CloneNotSupportedException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the exceptional condition. 
inner 
An inner exception that led to the CloneNotSupportedException. 


See Also 

Reference 
CloneNotSupportedException Class 
Concepts 

CloneNotSupportedException Members 
java.lang Package 
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CloneNotSupportedException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


CloneNotSupportedException Class 


Concepts 
java.lang Package 
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CloneNotSupportedException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 


CloneNotSupportedException Class 


Concepts 
java.lang Package 
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Comparable Interface 


Provides a method to compare two objects to determine if one object is less than, equal to, or greater than another object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public interface java.lang.Comparable 


Example 


The following example shows how to implement and use the compareTo method of the Comparable interface. This example 
compares student's test scores. 


// comparable.jsl 


public class Program 
{ 
public static void main(String[] args) 
af 
try 
{ 
// Create two new TestScore objects. 
TestScores bob = new TestScores("John Smith", 84); 
TestScores mary = new TestScores("Katie Jordan", 91); 


// Determine how bob compares to mary. 
int comparison = bob.compareTo(mary) ; 


// Print out the results of the comparison. 
System.out.print("John's test score was "); 


if (comparison == -1) 
System.out.print("less than "); 
else if (comparison == @) 
System.out.print("equal to "); 
else 
System.out.print("greater than "); 


System.out.printin("Katie's test score."); 


catch (IllegalArgumentException ex) 
{ 


} 


System.out.println(ex.toString()); 


} 


/* 
Output: 
John's test score was less than Katie's test score. 


*/ 
// comparable_test_scores.jsl 


public class TestScores implements Comparable 
{ 
public TestScores(String nameOfStudent, 
int testScore) 
{ 
studentName = nameOfStudent; 
score = testScore; 


// Implements Comparable.compareTo 
// Compares the test scores of the two objects. 
public int compareTo(Object obj) 


{ 
if (obj instanceof TestScores) 
{ 
TestScores objTestScores = (TestScores)obj; 
if (score < objTestScores.score) 
return -1; 
else if (score > objTestScores.score) 
return 1; 
else 
return Q; 
} 
else 
{ 
throw new IllegalArgumentException("obj must be an " + 
"instance of a TestScores object."); 
} 
} 


// The name of the student. 
private String studentName; 


// The score the student received on the test. 
private int score; 











Remarks 


Use the compareTo method of the Comparable interface to compare two objects of the same type. The rules for the return 
values for compareTo are summarized as follows: 


Condition Return Value 
The object implementing compareTo is less than the parameter passed to compareTo. -1 

The object implementing compareTo is equal to the parameter passed to compareTo. 0 

The object implementing compareTo is greater than the parameter passed to compareTo. 1 





The method used to compare two objects is up to the developer of the class. Usually this is determined by comparing some or 
all of the fields of the class. 


See Also 

Concepts 

Comparable Members 
java.lang Package 
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Comparable Members 


Provides a method to compare two objects to determine if one object is less than, equal to, or greater than another object. 
The following tables list the members exposed by the Comparable type. 
Public Methods 


Name Description 








compareTo/Provides a means to compare two objects to determine if one object is less than, equal to, or greater than another 
object. 











See Also 
Reference 


Comparable Interface 
Concepts 


java.lang Package 
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Comparable Methods 


Public Methods 


Name Description 








object. 





compareTo/Provides a means to compare two objects to determine if one object is less than, equal to, or greater than another 








See Also 
Reference 


Comparable Interface 
Concepts 


java.lang Package 
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Comparable.compareTo Method 


Provides a means to compare two objects to determine if one object is less than, equal to, or greater than another object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public abstract int compareTo( 
java.lang.Object obj); 


Parameters 


obj 
The object to compare against. 
Return Value 


-1 if the object calling compareTo is less than obj, 0 if the two objects are equal, or 1 if the object calling compareTo is greater 
than obj. 


Example 


The following example shows how to implement and use the compareTo method of the Comparable interface. This example 
compares student's test scores. 


// comparable.jsl 


public class Program 
{ 
public static void main(String[] args) 
{ 
try 
{ 
// Create two new TestScore objects. 
TestScores bob = new TestScores("John Smith", 84); 
TestScores mary = new TestScores("Katie Jordan", 91); 


// Determine how bob compares to mary. 
int comparison = bob.compareTo(mary) ; 


// Print out the results of the comparison. 
System.out.print("John's test score was "); 


if (comparison == -1) 
System.out.print("less than "); 
else if (comparison == @) 
System.out.print("equal to "); 
else 
System.out.print("greater than "); 


System.out.printin("Katie's test score."); 


} 
catch (IllegalArgumentException ex) 


4 
} 


System.out.printin(ex.toString()); 


} 


/* 
Output: 
John's test score was less than Katie's test score. 


ay | 











// comparable_test_scores.jsl 
public class TestScores implements Comparable 
{ 
public TestScores(String nameOfStudent, 
int testScore) 
1 
studentName = nameOfStudent; 
score = testScore; 
} 
// Implements Comparable. compareTo 
// Compares the test scores of the two objects. 
public int compareTo(Object obj) 
{ 
if (obj instanceof TestScores) 
{ 
TestScores objTestScores = (TestScores)obj; 
if (score < objTestScores.score) 
return -1; 
else if (score > objTestScores.score) 
return 1; 
else 
return Q; 
} 
else 
{ 
throw new IllegalArgumentException("obj must be an " + 
"instance of a TestScores object."); 
} 
} 
// The name of the student. 
private String studentName; 
// The score the student received on the test. 
private int score; 
} 
Remarks 


Use the compareTo method of the Comparable interface to compare two objects of the same type. The rules for the return 
values for compareTo are summarized as follows: 


Condition Return Value 
The object implementing compareTo is less than the parameter passed to compareTo. -1 
The object implementing compareTo is equal to the parameter passed to compareTo. 0 
The object implementing compareTo is greater than the parameter passed to compareTo. 1 





The method used to compare two objects is up to the developer of the class. Usually this is determined by comparing some or 
all of the fields of the class. 


See Also 

Reference 
Comparable Interface 
Concepts 

Comparable Members 
java.lang Package 
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Double Class 


The Double class wraps the primitive type double into an object. The class contains method members to perform tests and to 
convert from double to other types and vice versa. 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public final class java.lang.Double 


extends java.lang.Number 
implements System.IConvertible, java.lang.Comparable 








Inheritance Hierarchy 

java.lang.Object 
java.lang.Number 
java.lang.Double 


See Also 
Concepts 
Double Members 
java.lang Package 
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Double Members 


The Double class wraps the primitive type double into an object. The class contains method members to perform tests and to 
convert from double to other types and vice versa. 


The following tables list the members exposed by the Double type. 


Public Constructors 





Double _—_—Overeaded Constructs a Double object. 


Public Fields 





Name Description 





MAX_VALUE 


MIN_VALUE 


NaN 


NEGATIVE_INFINITY 


POSITIVE_INFINITY 


TYPE 











Public Methods 











Name Description 
byteValue Overridden. Returns the byte value of a Double object. 
compareTo Overloaded. 





doubleToLongBits |Returns the 64-bit representation of a double number as per IEEE 754 floating point standard. 

















doubleValue Overridden. Returns the double value of a Double object. 

equals Overridden. Compares the current Double object to another object. 
floatValue Overridden. Returns the float value of a Double object. 

hashCode Overridden. Retrieves the hash code of the current Double object. 
getClass (inherited from Object ) 

intValue Overridden. Returns the int value of a Doublee object. 

isInfinite Overloaded. Checks if the value of a Double object is infinite. 

isNaN Overloaded. Checks if the value of a Double object is "Not a Number." 


longBitsToDouble |Returns double number that corresponds to the 64-bit representation of a double number. 














longValue 


Overridden. Returns the long value of a Double object. 





clone 


parseDouble 


shortValue 


ToBoolean 


ToByte 


ToChar 


ToDateTime 


(inherited from Number ) 


Converts a string to a double value. 


Overridden. Returns the short value of a Double object. 


Converts a Double object value to a Boolean value using a specific format. 


Converts a Double object value to a byte using a specific format. 


Converts a Double object value to a char using a specific format. 


Converts a Double object value to a date-time value using a specific format. 





ToDecimal 


Converts a Double object value to a decimal value using a specific format. 





ToDouble 





Tolnt16 





Tolnt32 





Tolnt64 





ToSByte 





ToSingle 





toString 





ToType 





ToUInt16 





ToUInt32 





ToUInt64 





valueOf 











See Also 
Reference 
Double Class 
Concepts 


java.lang Package 
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Double Fields 


Public Fields 





Name Description 





MAX_VALUE 





MIN_VALUE 





NaN 





NEGATIVE_INFINITY 





POSITIVE_INFINITY 


TYPE 








See Also 
Reference 

Double Class 
Concepts 
java.lang Package 
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Double.MAX_VALUE Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final double MAX_VALUE; 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.MIN_VALUE Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final double MIN_VALUE; 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.NaN Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final double NaN; 





See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.NEGATIVE_INFINITY Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final double NEGATIVE_INFINITY; 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.POSITIVE_INFINITY Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final double POSITIVE_INFINITY; 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.TYPE Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final java.lang.Class TYPE; 





See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double Constructor 


Constructs a Double object. 


Overload List 


Double (double) Constructs a Double object an initializes it with a double parameter. 





Double (String) Constructs a Double object an initializes it with a string parameter. 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double Constructor (Double) 


Constructs a Double object an initializes it with a double parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java. lang.Double( 
double d); 


Parameters 


d 
A double expression. 
Example 


The following example creates an instance of the Double class and initializes it with the value 23. 


// Double1.jsl 
// Double constructor example 


public class MyClass 
{ 


public static void main(String[] args) 


{ 
Double d = new Double(23); 


System.out.print("The double number is: "+ d); 


} 

/* 

Output: 

The double number is: 23.0 
* 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double Constructor (String) 


Constructs a Double object an initializes it with a string parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java. lang.Double( 
java.lang.String s) throws java.lang.NumberFormatException; 


Parameters 
s 
A string parameter. 
Example 
This example creates an instance of the Double class and initializes it with the string "22.0". 


// Double2.jsl 
// Double constructor example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
Double d = new Double("22.0"); 
System.out.print("The double number is: "+ d); 
} 
} 
/* 
Output: 
The double number is: 22.0 
=) 
Remarks 


The string parameter should contain a double expression. 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double Methods 


Public Methods 











Name Description 
byteValue Overridden. Returns the byte value of a Double object. 
compareTo Overloaded. 





doubleToLongBits |Returns the 64-bit representation of a double number as per IEEE 754 floating point standard. 








doubleValue Overridden. Returns the double value of a Double object. 

equals Overridden. Compares the current Double object to another object. 
floatValue Overridden. Returns the float value of a Double object. 

hashCode Overridden. Retrieves the hash code of the current Double object. 
getClass (inherited from Object ) 

intValue Overridden. Returns the int value of a Doublee object. 

isInfinite Overloaded. Checks if the value of a Double object is infinite. 

isNaN Overloaded. Checks if the value of a Double object is "Not a Number." 


longBitsToDouble |Returns double number that corresponds to the 64-bit representation of a double number. 











longValue Overridden. Returns the long value of a Double object. 

clone (inherited from Number ) 

parseDouble Converts a string to a double value. 

shortValue Overridden. Returns the short value of a Double object. 

ToBoolean Converts a Double object value to a Boolean value using a specific format. 
ToByte Converts a Double object value to a byte using a specific format. 

ToChar Converts a Double object value to a char using a specific format. 
ToDateTime Converts a Double object value to a date-time value using a specific format. 
ToDecimal Converts a Double object value to a decimal value using a specific format. 
ToDouble 

Tolnt16 





Tolnt32 

















Tolnt64 





ToSByte 





ToSingle 





toString 





ToType 





ToUInt16 





ToUInt32 





ToUInt64 


valueOf 





See Also 
Reference 

Double Class 
Concepts 
java.lang Package 








Visual J# Reference 


Double.byteValue Method 


Returns the byte value of a Double object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public byte byteValue(); 


Return Value 

The byte value of the Double object. 

Example 

This example creates an instance of the Double class and initializes it with the value -22.1, and then converts it to a byte value. 


// Double3.jsl 
// Double constructor example 


public class MyClass 


{ 
public static void main(String[] args) 
i 
Double d = new Double("-22.1"); 
byte b = d.byteValue(); 
System.out.println("The double number is: "+ d); 
System.out.println("The byte value is: "+ b); 
} 
} 
/* 
Output: 


The double number is: -22.1 
The byte value is: -22 
al 4 


Remarks 
The byte value of a Double object doesn't include the fraction part. 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.compareTo Method 


Overload List 





Name Description 





Double.compareTo (double) Compares a Double object to the current object. 








Double.compareTo (Object) Compares the current Double object to another Double object. 











See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.compareTo Method (Double) 


Compares a Double object to the current object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public int compareTo( 
java.lang.Double adouble) ; 


Parameters 
adouble 
The Double object to compare to. 
Return Value 
0 if the two objects are identical; -1 otherwise. 
Example 
In this example, two Double objects are created and compared to each other. The result of the comparison was false (-1). 


// d-compareTo1.jsl 
// compareTo Example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
Double d1 = new Double(-22.1); 
Double d2 = new Double(22.1); 
int i = d1.compareTo(d2); 
System.out.println("The result of the comparison: "+ i); 
} 
} 
/* 
Output: 
The result of the comparison: -1 
*/ 
See Also 
Reference 
Double Class 
Concepts 


Double Members 
java.lang Package 


Visual J# Reference 


Double.compareTo Method (Object) 


Compares the current Double object to another Double object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public int compareTo( 
java.lang.Object adouble) ; 


Parameters 
adouble 
The Double object to compare to. 
Return Value 
0 if the two objects are identical, 1 otherwise. 
Example 
In this example, two Double objects are created and compared to each other. The result of the comparison was false (1). 


// d-compareTo2.jsl 
// compareTo Example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
Double d1 = new Double(123); 
Double d2 = new Double(12); 
System.out.print("The comparison result = "+ d1.compareTo(d2)); 
} 
} 
/* 
The comparison result = 1 
A 
See Also 
Reference 
Double Class 
Concepts 


Double Members 
java.lang Package 
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Double.doubleToLongBits Method 


Returns the 64-bit representation of a double number as per IEEE 754 floating point standard. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static long doubleToLongBits( 
double d); 


Parameters 


d 
A double expression. 
Return Value 
The 64-bit representation of the double number. 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.doubleValue Method 


Returns the double value of a Double object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public double doubleValue() ; 





Return Value 
The double value of a Double object. 
Example 


In this example, a Double object is created, and then the double value of this object is retrieved and displayed. 





// DoubleValue.jsl 
// doubleValue example 
public class MyClass 
{ 
public static void main(String[] args) 
if 
Double d = new Double(123.45); 
System.out.print("The double value is: "+ d.doubleValue()); 
} 
} 
/* 
Output: 
The double value is: 123.45 
mf 
See Also 
Reference 
Double Class 
Concepts 


Double Members 
java.lang Package 
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Double.equals Method 


Compares the current Double object to another object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public boolean equals( 
java.lang.Object obj); 





Parameters 


obj 
The object to compare to. 
Return Value 
true if the two objects are identical; false otherwise. 
Example 


In this example, two Double objects are created and compared to each other. The result of the comparison was true. 





// d-equals.jsl 
// equals Example 
public class MyClass 
{ 
public static void main(String[] args) 
Double d1 = new Double(123); 
Double d2 = new Double(123); 
System.out.print("The equality is: "+ d1.equals(d2)); 
} 
} 
/* 
The equality is: true 
oy. 
See Also 
Reference 
Double Class 
Concepts 


Double Members 
java.lang Package 
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Double.floatValue Method 


Returns the float value of a Double object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public float floatValue(); 





Return Value 
The float value of the Double object. 
Example 


In this example, a Double object is created, and then the float value of this object is retrieved and displayed. 





// FloatValue.jsl 
// floatValue example 
public class MyClass 
{ 
public static void main(String[] args) 
if 
Double d = new Double(123.45); 
System.out.print("The float value is: "+ d.floatValue()); 
} 
} 
/* 
Output: 
The float value is: 123.45 
a 
See Also 
Reference 
Double Class 
Concepts 


Double Members 
java.lang Package 
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Double.hashCode Method 


Retrieves the hash code of the current Double object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public int hashCode(); 





Return Value 
The hash code of the Double object. 
Example 


In this example, a Double object is created, and then the hash code value for this object is retrieved and displayed. 








// HashcodeValue. jsl 
// GetHashCode example 
public class MyClass 
{ 
public static void main(String[] args) 
if 
Double d = new Double(123.45); 
System.out.print("The hash code is: "+ d.GetHashCode()); 
} 
} 
/* 
Output: 
The hash code is: -1936584703 
mf 
See Also 
Reference 
Double Class 
Concepts 


Double Members 
java.lang Package 
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Double.intValue Method 


Returns the int value of a 9e6e1c4d-6daf-46d6-8f53-8 1 9deae0 1 68ae object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public int intValue(); 





Return Value 
The int value of the Doublee object. 
Example 


In this example, a Double object is created, and then the int value of this object is retrieved and displayed. 








// intValue1.jsl 
// intValue example 
public class MyClass 
{ 
public static void main(String[] args) 
if 
Double d = new Double(123.65); 
System.out.print("The int value is: "+ d.intValue()); 
} 
} 
/* 
Output: 
The int value is: 123 
us 
Remarks 


The int value is the integer part of the floating-point number (with the fraction truncated). 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.isInfinite Method 


Checks if the value of a Double object is infinite. 


Overload List 


Double.isInfinite () Checks if the value of a Double object is infinitely large. 





Double.isInfinite (double) Checks if a double value is infinitely large. 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.isInfinite Method () 


Checks if the value of a Double object is infinitely large. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public boolean isInfinite(); 


Return Value 

true if the object is infinite; false otherwise. 

Example 

In this example, two Double objects are created tested if infinite. The result of the test was true for the object that contains a 


value divided by zero. 


// Infinite1.jsl 
// isInfinite example 


public class MyClass 


{ 
public static void main(String[] args) 
1 
Double d1 = new Double(123.45); 
Double d2 = new Double(123.45/0.@); 
System.out.println("Infinite object #1? "+ d1.isInfinite()); 
System.out.println("Infinite object #2? "+ d2.isInfinite()); 
} 
} 
/* 
Output: 


Infinite object #1? false 
Infinite object #2? true 
ei 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.isInfinite Method (Double) 


Checks if a double value is infinitely large. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static boolean isInfinite( 
double f); 


Parameters 


f 
The double expression to be tested. 

Return Value 

true if the value to tested is infinity; false otherwise. 

Example 

In this example, you test two double expressions to see if they are infinite. The result of the test was true for one of them, which 


contains a value divided by zero. 


// Infinite2.jsl 
// isInfinite example 


public class MyClass 


{ 
public static void main(String[] args) 
1 
System.out.printlin("Infinite object #1? " 
+ Double.isInfinite(1.1)); 
System.out.printlin("Infinite object #2? " 
+ Double.isInfinite(1.1/0.0)); 
} 
} 
/* 
Output: 


Infinite object #1? false 
Infinite object #2? true 
*/ 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.isNaN Method 


Checks if the value of a Double object is "Not a Number." 


Overload List 


Double.isNaN () Checks if the value of a Double object is "Not a Number." 





Double.isNaN (double) Checks if double value is "Not a Number." 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.isNaN Method () 


Checks if the value of a Double object is "Not a Number." 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public boolean isNaN(); 


Return Value 

true if the value to be tested is NaN (Not a Number); false otherwise. 

Example 

In the following example, two Double objects are created and tested to check if they contain a NaN value. The test of one 


object, which contains the square root of a negative number, returned true. 


// isNan1.jsl 
// isNaN example 


public class MyClass 


{ 
public static void main(String[] args) 
1 
Double d1 = new Double(Math.sqrt(-1.0)); 
Double d2 = new Double(Math.sqrt(16.@)); 
System.out.println("NaN object #1?: "+ d1.isNaN()); 
System.out.println("NaN object #2?: "+ d2.isNaN()); 
} 
} 
/* 
Output: 


NaN object #1?: true 
NaN object #2?: false 
*/ 


Remarks 
The NaN value is produced by some operations such as the square root of a negative number. 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 


Visual J# Reference 


Double.isNaN Method (Double) 


Checks if double value is "Not a Number." 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static boolean isNaN( 
double f); 


Parameters 


f 
The double expression to be tested. 

Return Value 

true if the value to be tested is NaN (Not a Number); false otherwise. 

Example 

In this example, you test two double expressions to see if they evaluate to a NaN value. The test of one expression, which 


contains the square root of a negative number, returned true. 


// isNan2.jsl 
// isNaN example 


public class MyClass 


{ 
public static void main(String[] args) 
1 
System.out.println("NaN object #1? "+ 
Double.isNaN(Math.sqrt(-1.0))); 
System.out.println("NaN object #2? "+ 
Double.isNaN(Math.sqrt(16.0))); 
} 
} 
/* 
Output: 


NaN object #1? true 
NaN object #2? false 
uA 


Remarks 
The NaN value is produced by some operations such as the square root of a negative number. 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.longBitsToDouble Method 


Returns double number that corresponds to the 64-bit representation of a double number. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static double longBitsToDouble( 
long bits); 


Parameters 
bits 


The 64-bit representation of a double number. 
Return Value 
The double number equivalent to the 64-bit representation of a double number. 
Example 


The following example does two conversions. First, it converts the value 1.2 to a 64-bit representation, and then converts the 
latter value to a double number. The print statement displays the original number 1.2. 


// longBits1.jsl 
// ongBitsToDouble example 


public class MyClass 
{ 


public static void main(String[] args) 


{ 


System.out.println("The double value is: + 
Double. longBitsToDouble(Double.doubleToLongBits(1.2))); 


} 


/* 

Output: 

The double value is: 1.2 
=f 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.longValue Method 


Returns the long value of a Double object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public long longValue(); 





Return Value 
The long value of the Double object. 
Example 


In this example, a Double object is created and the long value of the object is retrieved and displayed. 





// longValue1.jsl 
// longValue example 
public class MyClass 
{ 
public static void main(String[] args) 
if 
Double d = new Double(123.45); 
System.out.println("The long value is: "+ d.longValue()); 
} 
} 
/* 
Output: 
The long value is: 123 
uA 
Remarks 


The long value is the integer part of the floating-point number (with the fraction truncated). 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.parseDouble Method 


Converts a string to a double value. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static double parseDouble( 
java.lang.String str) throws java.lang.NumberFormatException; 


Parameters 
str 


The string to be converted. 
Return Value 
The double value of the string parameter. 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.shortValue Method 


Returns the short value of a Double object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public short shortValue(); 





Return Value 

The short value of the Double object. 

Example 

In this example, a Double object is created and the short value of the object is retrieved and displayed. 


// shortValuel1.jsl 
// shortValue example 


public class MyClass 
{ 


public static void main(String[] args) 


if 
Double d = new Double(123.45); 


System.out.println("The short value is: "+ d.shortValue()); 


/* 

Output: 

The short value is: 123 
* 





Remarks 
The short value is the integer part of the floating-point number (with the fraction truncated). 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.ToBoolean Method 


Converts a Double object value to a Boolean value using a specific format. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public boolean ToBoolean( 
System. IFormatProvider provider) ; 


Parameters 
provider 


The format provider. 
Return Value 
The Boolean value of the Double object. 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.ToByte Method 


Converts a Double object value to a byte using a specific format. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.Byte ToByte( 
System. IFormatProvider provider) ; 


Parameters 
provider 


The format provider. 
Return Value 
The byte value of the Double object. 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.ToChar Method 


Converts a Double object value to a char using a specific format. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public char ToChar( 
System. IFormatProvider provider) ; 


Parameters 
provider 


The format provider. 
Return Value 
The char value of the Double object. 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.ToDateTime Method 


Converts a Double object value to a date-time value using a specific format. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.DateTime ToDateTime( 
System. IFormatProvider provider) ; 


Parameters 
provider 


The format provider. 
Return Value 
The date-time value of the Double object. 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double. ToDecimal Method 


Converts a Double object value to a decimal value using a specific format. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.Decimal ToDecimal ( 
System. IFormatProvider provider) ; 


Parameters 
provider 


The format provider. 
Return Value 
The decimal value of the Double object. 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.ToDouble Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public double ToDouble( 
System.IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.Tolnt16 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public short ToInt16( 
System. IFormatProvider provider) ; 





Parameters 
provider 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.Tolnt32 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public int ToInt32( 
System. IFormatProvider provider) ; 





Parameters 
provider 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.Tolnt64 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public long ToInt64( 
System. IFormatProvider provider) ; 





Parameters 
provider 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.ToSByte Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public byte ToSByte( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.ToSingle Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public float ToSingle( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.toString Method 


Overload List 





Name 


Description 





Double.ToString () 





Double.ToString (lFormatProvider) 











See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 





Visual J# Reference 


Double.toString Method () 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toString(); 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 


Visual J# Reference 


Double.toString Method (IFormatProvider) 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String ToString( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.ToType Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object ToType( 
System.Type conversionType, 
System. IFormatProvider provider) ; 


Parameters 
conversionType 


provider 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.ToUInt16 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.UInt16 ToUInt16( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.ToUInt32 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.UInt32 ToUInt32( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.ToUInt64 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.UInt64 ToUInt64( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Double.valueOf Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.Double valueOf( 
java.lang.String s) throws java.lang.NumberFormatException; 


Parameters 
S 


See Also 
Reference 

Double Class 
Concepts 

Double Members 
java.lang Package 
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Error Class 


Represents the base error for all errors in the J# Class Libraries. An error indicates a problem in the underlying execution 
engine. 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public class java.lang.Error 
extends java.lang.Throwable 





Remarks 


An error is an indication of a problem in the underlying execution engine. An example might be if there was no more memory 
available to the application. Applications do not typically handle errors, because there usually isn't anything that can be done to 
resolve the problem. Compare this to exceptions, which should be handled by the application. 


For more information about the differences between errors and exceptions, see Exception. 
Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Error 
java.awtAWTError 
java.lang.LinkageError 
java.lang.VirtualMachineError 


See Also 
Concepts 

Error Members 
java.lang Package 
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Error Members 


Represents the base error for all errors in the J# Class Libraries. An error indicates a problem in the underlying execution 


engine. 


The following tables list the members exposed by the Error type. 


Public Constructors 


Name Description, 





for Overloaded Initializes a new instance of an Error object. 


Public Properties (see also Protected Properties ) 





Name 


Description 





HelpLink 


InnerException 


Message 


Source 


StackTrace 


TargetSite 





Protected Properties 


(inherited from Exception ) 


(inherited from Exception ) 


(inherited from Exception ) 


(inherited from Exception ) 


(inherited from Exception ) 


(inherited from Exception ) 





Name 


Description 





HResult 





(inherited from Exception ) 





Public Methods 
Name 


<exceptFilter> 


equals 


filllnStackTrace 


GetBaseException 


hashCode 


getLocalizedMessage 


Description 


Maps various errors to a java.lang.Error. 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Exception ) 


(inherited from Object ) 


(inherited from Throwable ) 

















getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 

clone (inherited from Throwable ) 














printStackTrace Overloaded. (inherited from Throwable ) 





toString (inherited from Throwable ) 





Protected Methods 
Name 


finalize (inherited from Object ) 








See Also 
Reference 

Error Class 
Concepts 
java.lang Package 
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Error Constructor 


Initializes a new instance of an Error object. 


Overload List 


Name Description 
Error () Initializes a new instance of an Error object. 
Error (String) Initializes a new instance of an Error object with the given message. 


Error (SerializationInfo, StreamingContext)|Initializes a new instance of an Error object during deserialization. 








Error (String, Exception) Initializes a new instance of an Error object with the given message and inner excep 
tion. 

See Also 

Reference 

Error Class 

Concepts 


Error Members 
java.lang Package 
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Error Constructor () 


Initializes a new instance of an Error object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.Error(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 
Reference 

Error Class 
Concepts 

Error Members 
java.lang Package 
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Error Constructor (String) 


Initializes a new instance of an Error object with the given message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Error( 
java.lang.String s); 


Parameters 
Ss 


A message describing the error condition. 


See Also 
Reference 

Error Class 
Concepts 

Error Members 
java.lang Package 
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Error Constructor (SerializationInfo, StreamingContext) 


Initializes a new instance of an Error object during deserialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java.lang.Error( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 
Reference 

Error Class 
Concepts 

Error Members 
java.lang Package 
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Error Constructor (String, Exception) 


Initializes a new instance of an Error object with the given message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Error( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the error condition. 
inner 
An inner exception that led to the Error. 


See Also 
Reference 

Error Class 
Concepts 

Error Members 
java.lang Package 
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Error Methods 


Public Methods 





Name 


Description 





<exceptFilter> 


Maps various errors to a java.lang.Error. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 


Protected Methods 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 





Name 


Description 





finalize 








(inherited from Object ) 





See Also 
Reference 

Error Class 
Concepts 
java.lang Package 
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Error Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 

Error Class 
Concepts 
java.lang Package 
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Exception Class (J#) 


Represents the base exception for all exceptions in the J# Class Libraries. An exception indicates that an application-level error 
has occurred. 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public class java.lang.Exception 
extends java.lang. Throwable 


Remarks 


An exception is an indication that an error has occurred at the application level. There are two types of exception, runtime 
exceptions and checked exceptions. All runtime exceptions are derived from RuntimeException. A runtime exception can be 
thrown in a method without having to declare that exception in the throws clause of the method. All other exceptions must be 
declared in the throws clause of the method. Since the compiler checks this condition for all non-runtime exceptions, they are 
sometimes referred to as checked exceptions. 


Exceptions differ from errors in that exceptions are typically indications of an error in an application, while an error is an 
indication of a problem in the underlying execution engine. See Error for more information about errors. Normally an 
application will not handle errors, but they should handle exceptions. 


Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
Derived Classes 


See Also 

Concepts 

Exception Members 
java.lang Package 
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Exception Members 


Represents the base exception for all exceptions in the J# Class Libraries. An exception indicates that an application-level error 
has occurred. 


The following tables list the members exposed by the Exception type. 


Public Constructors 





Exception Overloaded. Initializes a new instance of an Exception object. 


Public Properties (see also Protected Properties ) 








Name Description 

HelpLink (inherited from Exception ) 
InnerException (inherited from Exception ) 
Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Protected Properties 
Name Description 








HResult (inherited from Exception ) 








Public Methods 














Name Description 

<exceptFilter> Maps various exceptions to a java.lang.Exception. 
equals (inherited from Object ) 
filllnStackTrace (inherited from Throwable ) 
GetBaseException (inherited from Exception ) 
hashCode (inherited from Object ) 
getLocalizedMessage (inherited from Throwable ) 
getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 
clone (inherited from Throwable ) 

















printStackTrace Overloaded. (inherited from Throwable ) 





toString (inherited from Throwable ) 








Protected Methods 
Name 


finalize (inherited from Object ) 








See Also 
Reference 
Exception Class 
Concepts 
java.lang Package 
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Exception Constructor 


Initializes a new instance of an Exception object. 


Overload List 


Name Description 
Exception () Initializes a new instance of an Exception object. 
Exception (String) Initializes a new instance of an Exception object with the given message. 


Exception (SerializationInfo, StreamingContext)|Initializes a new instance of an Exception object during deserialization. 


Exception (String, Exception) Initializes a new instance of an Exception object with the given message and in 
ner exception. 





See Also 
Reference 
Exception Class 
Concepts 

Exception Members 
java.lang Package 
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Exception Constructor () 


Initializes a new instance of an Exception object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.Exception(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
Exception Class 
Concepts 

Exception Members 
java.lang Package 
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Exception Constructor (String) 


Initializes a new instance of an Exception object with the given message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Exception( 
java.lang.String s); 


Parameters 
Ss 


A message describing the exceptional condition. 


See Also 

Reference 
Exception Class 
Concepts 

Exception Members 
java.lang Package 
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Exception Constructor (SerializationInfo, StreamingContext) 


Initializes a new instance of an Exception object during deserialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java.lang.Exception( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
Exception Class 
Concepts 

Exception Members 
java.lang Package 
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Exception Constructor (String, Exception) 


Initializes a new instance of an Exception object with the given message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Exception( 
java.lang.String msg, 
System.Exception innerEx) ; 


Parameters 
msg 


A message describing the exceptional condition. 
innerEx 
An inner exception that led to the Exception. 


See Also 

Reference 
Exception Class 
Concepts 

Exception Members 
java.lang Package 
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Exception Methods 


Public Methods 









































Name Description 

<exceptFilter> Maps various exceptions to a java.lang.Exception. 
equals (inherited from Object ) 

filllnStackTrace (inherited from Throwable ) 
GetBaseException (inherited from Exception ) 

hashCode (inherited from Object ) 
getLocalizedMessage (inherited from Throwable ) 

getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 

getClass (inherited from Object ) 

clone (inherited from Throwable ) 
printStackTrace Overloaded. (inherited from Throwable ) 
toString (inherited from Throwable ) 
Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 

Exception Class 

Concepts 


java.lang Package 
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Exception Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 
Exception Class 
Concepts 
java.lang Package 
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ExceptionInInitializerError Class 


The error that is thrown when the execution engine encounters an exception during initialization of a class from the static 
initializer. 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public class java.lang.ExceptionInInitializerError 
extends java.lang.LinkageError 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Error 
java.lang.LinkageError 
java.lang.ExceptionInInitializerError 


See Also 

Concepts 

ExceptionInInitializerError Members 
java.lang Package 
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ExceptionInInitializerError Members 


The error that is thrown when the execution engine encounters an exception during initialization of a class from the static 


initializer. 


The following tables list the members exposed by the ExceptionInInitializerError type. 


Public Constructors 


ExceptionInInitializerError 





Overloaded. Initializes a new instance of an Exception!nInitializerError object. 


Public Properties (see also Protected Properties ) 





Name 


Description 





HelpLink 


InnerException 


Message 


Source 


StackTrace 


TargetSite 





Protected Properties 


(inherited from Exception ) 

(inherited from Exception ) 
(inherited from Exception ) 
(inherited from Exception ) 
(inherited from Exception ) 


(inherited from Exception ) 





Name 


Description 





HResult 





(inherited from Exception ) 





Public Methods 
Name 


<exceptFilter> 


checkAndThrowException 


equals 


filllnStackTrace 


GetBaseException 


getException 


Description 


Maps various initialization errors to a java.lang.ExceptionInInitializerError. 


Checks the exception that was thrown during initialization. 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Exception ) 


Gets the exception that was thrown during initialization. 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 





getMessage 


(inherited from Throwable ) 





GetObjectData 





Overridden. Retrieves the data to be serialized. 

















getClass (inherited from Object ) 











clone (inherited from Throwable ) 
printStackTrace Overloaded. (inherited from Throwable ) 
toString (inherited from Throwable ) 








Protected Methods 
Name 


finalize (inherited from Object ) 








See Also 

Reference 
ExceptionI|nInitializerError Class 
Concepts 

java.lang Package 
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ExceptionInInitializerError Constructor 


Initializes a new instance of an ExceptionInInitializerError object. 


Overload List 





Name Description 

ExceptionInInitializerError () Initializes a new instance of an ExceptionInInitializerError objec 
t. 

ExceptionInInitializerError (String) Initializes a new instance of an ExceptionIninitializerError objec 


t with the given message. 


ExceptionInInitializerError (Throwable) Initializes a new instance of an ExceptionInInitializerError objec 
t with the exception that was thrown during initialization. 


ExceptionInInitializerError (SerializationInfo, StreamingContext)|Initializes a new instance of an ExceptionInInitializerError objec 
t during deserialization. 





ExceptionI|nInitializerError (String, Exception) Initializes a new instance of an ExceptionIninitializerError objec 
t with the given message and inner exception. 





See Also 

Reference 
ExceptionI|nInitializerError Class 
Concepts 

ExceptionInInitializerError Members 
java.lang Package 
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ExceptionInInitializerError Constructor () 


Initializes a new instance of an ExceptionIninitializerError object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.ExceptionInInitializerError(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
ExceptionInInitializerError Class 
Concepts 

ExceptionInInitializerError Members 
java.lang Package 
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ExceptionInInitializerError Constructor (String) 


Initializes a new instance of an ExceptionInInitializerError object with the given message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.ExceptionInInitializerError( 
java.lang.String s); 


Parameters 
Ss 


A message describing the error condition. 


See Also 

Reference 
ExceptionInInitializerError Class 
Concepts 

ExceptionI|nInitializerError Members 
java.lang Package 
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ExceptionInInitializerError Constructor (Throwable) 


Initializes a new instance of an Exception|ninitializerError object with the exception that was thrown during initialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.ExceptionInInitializerError( 
java.lang.Throwable thrown) ; 


Parameters 
thrown 


The exception that was thrown during initialization. 


See Also 

Reference 
ExceptionI|nInitializerError Class 
Concepts 

ExceptionI|nInitializerError Members 
java.lang Package 
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ExceptionInInitializerError Constructor (SerializationInfo, 
StreamingContext) 


Initializes a new instance of an Exception|ninitializerError object during deserialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java.lang.ExceptionInInitializerError( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
ExceptionInInitializerError Class 
Concepts 

ExceptionInInitializerError Members 
java.lang Package 
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ExceptionInInitializerError Constructor (String, Exception) 


Initializes a new instance of an ExceptionInInitializerError object with the given message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.ExceptionInInitializerError( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the error condition. 
inner 
An inner exception that led to the ExceptioninInitializerError. 


See Also 

Reference 
ExceptionI|nInitializerError Class 
Concepts 

ExceptionInInitializerError Members 
java.lang Package 
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ExceptionInInitializerError Methods 


Public Methods 





Name 


Description 





<exceptFilter> 


Maps various initialization errors to a java.lang.ExceptionInInitializerError. 





checkAndThrowException 


Checks the exception that was thrown during initialization. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


getException 


hashCode 


getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 


Protected Methods 


(inherited from Exception ) 


Gets the exception that was thrown during initialization. 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


Overridden. Retrieves the data to be serialized. 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 








Name 


Description 





finalize 








(inherited from Object ) 





See Also 
Reference 


ExceptionI|nInitializerError Class 


Concepts 
java.lang Package 





Visual J# Reference 


ExceptionInInitializerError.checkAndThrowException Method 


Checks the exception that was thrown during initialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static void checkAndThrowException( 
java.lang.Throwable thrown) throws java.lang. Throwable; 


Parameters 
thrown 


The exception that was thrown during initialization. 


See Also 

Reference 
ExceptionI|nInitializerError Class 
Concepts 

ExceptionInInitializerError Members 
java.lang Package 
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ExceptionInInitializerError.getException Method 


Gets the exception that was thrown during initialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Throwable getException(); 


Return Value 
The exception that was throws during initialization. 


See Also 

Reference 
ExceptionInInitializerError Class 
Concepts 

ExceptionInInitializerError Members 
java.lang Package 
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ExceptionInInitializerError.GetObjectData Method 


Retrieves the data to be serialized. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public void GetObjectData( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization process. 


See Also 

Reference 
ExceptionI|nInitializerError Class 
Concepts 

ExceptionInInitializerError Members 
java.lang Package 
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ExceptionInInitializerError Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 


ExceptionI|nInitializerError Class 


Concepts 
java.lang Package 
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Float Class 


The Float class wraps the primitive type float. It contains several methods for conversion between String and Float and 
processing Float objects. 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public final class java.lang.Float 


extends java.lang.Number 
implements System.IConvertible, java.lang.Comparable 








Inheritance Hierarchy 

java.lang.Object 
java.lang.Number 
java.lang.Float 


See Also 
Concepts 

Float Members 
java.lang Package 
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Float Members 


The Float class wraps the primitive type float. It contains several methods for conversion between String and Float and 
processing Float objects. 


The following tables list the members exposed by the Float type. 


Public Constructors 





Public Fields 








TYPE 





Name Description 

MAX_VALUE A constant field that stores the maximum finite value of the float type. 
MIN_VALUE A constant field that stores the minimum positive value of the float type. 
NaN A constant that stores the Not-a-Nmber value of the float type. 


NEGATIVE_INFINITY 


POSITIVE_INFINITY 


Public Methods 


A constant that stores the negative infinity value for the float type. 
A constant that stores the positive infinity value for the float type. 


The constant that stores the Class instance of the primitive type float. 




















Name Description 

byteValue Overridden. Returns the value of the current Float object converted to a byte. 
compareTo Overloaded. 

doubleValue Overridden. Returns the double value of the current Float object. 

equals Overridden. Checks if the current Float object is equal to another specified object. 





floatTolntBits 


Returns the int representation of the floating-point parameter. 











intBitsToFloat 


intValue 


isInfinite 


isNaN 





floatValue Overridden. Returns the float value of the current Float object. 
hashCode Overridden. Returns the hash code of the current Float object. 
getClass (inherited from Object) 


Returns the floating-point value that corresponds to a specific bit pattern. 
Overridden. Returns the value of the current Float object converted to int. 
Overloaded. 


Overloaded. 








longValue Overridden. Returns the value of the current Float object converted to long. 





clone (inherited from Number) 


parseFloat Returns a float value specified by the string parameter. 


shortValue Overridden. Returns the value of the current Float object converted to short. 


ToBoolean 


ToByte 


ToChar 


ToDateTime 





ToDecimal 





ToDouble 





Tolnt16 





Tolnt32 





Tolnt64 





ToSByte 





ToSingle 





toString Returns a string that represents the float parameter. 





toString Overloaded. Overridden. 





ToType 





ToUInt16 





ToUInt32 





ToUInt64 





valueOf Returns the Float object whose float value is represented by a specified string parameter. 











See Also 
Reference 

Float Class 
Concepts 
java.lang Package 
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Float Fields 


Public Fields 


























Name Description 

MAX_VALUE A constant field that stores the maximum finite value of the float type. 
MIN_VALUE A constant field that stores the minimum positive value of the float type. 
NaN A constant that stores the Not-a-Nmber value of the float type. 
NEGATIVE_INFINITY A constant that stores the negative infinity value for the float type. 
POSITIVE_INFINITY A constant that stores the positive infinity value for the float type. 
TYPE The constant that stores the Class instance of the primitive type float. 
See Also 

Reference 

Float Class 

Concepts 


java.lang Package 
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Float.MAX_VALUE Field 


A constant field that stores the maximum finite value of the float type. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final float MAX_VALUE; 


Example OOOO 


// #-MAX.js1 
// Float.MAX_VALUE example 


public class MyClass 


public static void main(String[] args) 


{ 


System.out.print("The maximum finite value is: + 
Float .MAX_VALUE) ; 


} 


/* 

Output: 

The maximum value is: 3.40282347E38 
ay & 








See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float.MIN_VALUE Field 


A constant field that stores the minimum positive value of the float type. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final float MIN_VALUE; 


Example OOOO 


// #-MIN.jsl 
// Float.MAX_VALUE example 


public class MyClass 


public static void main(String[] args) 


{ 
} 


System.out.print("The minimum positive value is: " + Float.MIN_VALUE) ; 


} 


/* 
Output: 
The minimum positive value is: 1.401298E-45 


*/ 











See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float.NaN Field 


A constant that stores the Not-a-Nmber value of the float type. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final float NaN; 


Example ——___________________c_____§_=, 


// #-MIN.jsl 
// Float.MAX_VALUE example 


public class MyClass 


public static void main(String[] args) 


{ 
} 


System.out.print("The Not-a-Number value is: " + Float.NaN); 


} 


/* 
Output: 
The Not-a-Number value is: NaN 


*/ 











See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float.NEGATIVE_INFINITY Field 


A constant that stores the negative infinity value for the float type. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final float NEGATIVE_INFINITY; 


Example 


// *-NEGIN.jsl 
// Float.NEGATIVE_INFINITY example 


public class MyClass 


public static void main(String[] args) 


{ 


System.out.print("The negative infinity value is: 


Float.NEGATIVE_INFINITY) ; 


} 


/* 
Output: 
The negative infinity value is: -Infinity 


*/ 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float.POSITIVE_INFINITY Field 


A constant that stores the positive infinity value for the float type. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final float POSITIVE_INFINITY; 


Example 


// *-POSIN.js1 
// Float.POSITIVE_INFINITY example 


public class MyClass 


public static void main(String[] args) 


{ 


System.out.print("The positive infinity value is: 


Float.POSITIVE_INFINITY) ; 


} 


/* 
Output: 
The positive infinity value is: Infinity 


*/ 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float. TYPE Field 


The constant that stores the Class instance of the primitive type float. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final java.lang.Class TYPE; 


Example ——___________________c_____§_=, 


// £-TYPE.jsl 
// Float.TYPE example 


public class MyClass 


public static void main(String[] args) 


{ 
} 


System.out.print("The TYPE value is: " + Float.TYPE); 


} 


/* 

Output: 

The TYPE value is: float 
at | 











See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float Constructor 


Overload List 





Name 


Description 





Float (double) 


Constructs a new Float object using a double parameter. 





Float (float) 


Constructs a new Float object using a float parameter. 





Float (String) 








Constructs a new Float object using a string parameter. 





See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float Constructor (Double) 


Constructs a new Float object using a double parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.Float( 
double d); 





Parameters 


d 


A double expression. 








Example 
// #-ctor1.jsl 
// Float.#ctor example 
public class MyClass 
public static void main(String[] args) 
{ 
Float f = new Float(123); 
System.out.print("The float value is: " + f); 
} 
} 
/* 
Output: 
The float value is: 123.0 
ef 
See Also 
Reference 
Float Class 
Concepts 


Float Members 
java.lang Package 
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Float Constructor (Single) 


Constructs a new Float object using a float parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.Float( 
float f); 





Parameters 


f 
A float expression. 


Example 





// #-ctor2.jsl 
// Float.#ctor example 


public class MyClass 


public static void main(String[] args) 


{ 
Float f = new Float(123F); 


System.out.print("The float value is: " + f); 


} 


/* 

Output: 

The float value is: 123.0 
a | 





See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float Constructor (String) 


Constructs a new Float object using a string parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.Float( 
java.lang.String s) throws java.lang.NumberFormatException; 





Parameters 
Ss 


A string expression. 








Example 
// #-ctor3.jsl 
// Float.#ctor example 
public class MyClass 
public static void main(String[] args) 
{ 
Float f = new Float("123.25"); 
System.out.print("The float value is: " + f); 
} 
} 
/* 
Output: 
The float value is: 123.25 
ef 
See Also 
Reference 
Float Class 
Concepts 


Float Members 
java.lang Package 
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Float Methods 


Public Methods 

















Name Description 

byteValue Overridden. Returns the value of the current Float object converted to a byte. 
compareTo Overloaded. 

doubleValue Overridden. Returns the double value of the current Float object. 

equals Overridden. Checks if the current Float object is equal to another specified object. 





floatTolntBits 


floatValue 


hashCode 


getClass 


intBitsToFloat 


Returns the int representation of the floating-point parameter. 


Overridden. Returns the float value of the current Float object. 


Overridden. Returns the hash code of the current Float object. 


(inherited from Object ) 


Returns the floating-point value that corresponds to a specific bit pattern. 











intValue Overridden. Returns the value of the current Float object converted to int. 
isInfinite Overloaded. 

isNaN Overloaded. 

longValue Overridden. Returns the value of the current Float object converted to long. 
clone (inherited from Number ) 

parseFloat Returns a float value specified by the string parameter. 

shortValue Overridden. Returns the value of the current Float object converted to short. 
ToBoolean 

ToByte 

ToChar 

ToDateTime 

ToDecimal 

ToDouble 

Tolnt16 





Tolnt32 














Tolnt64 





ToSByte 





ToSingle 





toString Returns a string that represents the float parameter. 





toString Overloaded. Overridden. 





ToType 





ToUInt16 





ToUInt32 
ToUInt64 


valueOf Returns the Float object whose float value is represented by a specified string parameter. 








See Also 
Reference 


Float Class 
Concepts 
java.lang Package 





Visual J# Reference 


Float.byteValue Method 


Returns the value of the current Float object converted to a byte. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public byte byteValue(); 


Return Value 
The value of the current Float object converted to a byte. 
Example 


// f-bVal1.jsl 
// Float.byteValue example 


public class MyClass 


{ 
public static void main(String[] args) 
Float f = new Float(2.25); 
System.out.printlin("The byte value is: " + #.byteValue()); 
System.out.println("The cast value is: " + (byte)2.25); 
} 
} 
/* 
Output: 


The byte value is: 2 
The cast value is: 2 


*/ 


Remarks 
The fraction part is truncated from the returned value. The result is the same as when you cast a float value to a byte. 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float.compareTo Method 


Overload List 





Name Description 





Float.compareTo (Float) Numerically compares the current Float object to another Float object. 





Float.compareTo (Object) Numerically compares the current Float object to another object. 











See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float.compareTo Method (Float) 


Numerically compares the current Float object to another Float object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public int compareTo( 
java.lang.Float aFloat); 


Parameters 
aFloat 


Non null Float object to compare to. 
Return Value 


0 if the two objects are numerically identical. 1 if the current object is numerically greater than aFloat. -1 if the current object is 
numerically less than aFloat. 


Example 


// *-comp1.jsl 
// Float.compareTo example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
Float f1 = new Float(2.25); 
Float f2 = new Float(1.44); 
System.out.println("The result of the comparison is: " + 
#1.compareTo(f1) ); 
System.out.println("The result of the comparison is: " + 
#1.compareTo(f2) ); 
System.out.println("The result of the comparison is: " + 
#2.compareTo(f1) ); 
} 
} 
/* 
Output: 


The result of the comparison is: @ 
The result of the comparison is: 1 
The result of the comparison is: -1 


*/ 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float.compareTo Method (Object) 


Numerically compares the current Float object to another object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public int compareTo( 
java.lang.Object obj); 





Parameters 


obj 
The object to compare to. 
Return Value 
Provided that the other object is Float, the returned value is: 
0 if the two objects are numerically identical. 
1 if the current object is numerically greater than aFloat. 


-1 if the current object is numerically less than aFloat. 


Example 


See the example on compareTo. 





Remarks 


If the other object is a Float object, the method behaves exactly like compareTo; otherwise it throws the exception 
java.lang.ClassCastException. 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 


Visual J# Reference 


Float.doubleValue Method 


Returns the double value of the current Float object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public double doubleValue() ; 


Return Value 
The double value of the current Float object. 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float.equals Method 


Checks if the current Float object is equal to another specified object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public boolean equals( 
java.lang.Object obj); 





Parameters 


obj 
The object to compare against. 
Return Value 


true if the two objects are identical; false otherwise. 








Example 
// #-equal1.jsl 
// Float.Equals example 
public class MyClass 
{ 
public static void main(String[] args) 
{ 
Float f1 = new Float(2.5); 
Float f2 = new Float(2.5); 
boolean b = f1.Equals(f2); 
System.out.print("The result is: " + b); 
} 
} 
/* 
Output: 
The result is: true 
*/ 
See Also 
Reference 
Float Class 
Concepts 


Float Members 
java.lang Package 
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Float.floatTolntBits Method 


Returns the int representation of the floating-point parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static int floatToIntBits( 
float f); 


Parameters 


f 
A float value. 

Return Value 

The int representation of f. 

Example 


// ¥-floToIntBits.jsl 
// floatToIntBits example 


public class MyClass 
{ 
public static void main(String[] args) 
if 
float f = 2.34f; 
System.out.println("The original float value is: " + f); 
// The integer bit representation: 
int i = Float.floatToIntBits(Ff); 
System.out.println("The int representation is: 
// Convert it back to a float value: 
float fb = Float.intBitsToFloat(i); 
System.out.println("The converted-back float is: " + fb); 


+ i); 


} 


/* 

Output: 

The original float value is: 2.34 

The int representation is: 1075167887 
The converted-back float is: 2.34 

*/ 


Remarks 


When you convert back the resulting integer representation using the method intBitsToFloat, it gives the same float value that 
was used as a parameter. 


The following are special cases: 

If the parameter value is NaN, the result is Ox7FCOO000. 

If the parameter value is POSITIVE_INFINITY, the result is Ox7F800000. 
If the parameter value is NEGATIVE_INFINITY, the result is OxFF800000. 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float.floatValue Method 


Returns the float value of the current Float object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public float floatValue(); 





Return Value 


The float value of the current Float object. 


Example TE 











// #-fval1.jsl 
// Float.floatValue example 
public class MyClass 
{ 
public static void main(String[] args) 
Float f = new Float("2.25"); 
System.out.println("The float value is: " + #.floatValue()); 
} 
} 
/* 
Output: 
The float value is: 2.25 
ei) 
See Also 
Reference 
Float Class 
Concepts 


Float Members 
java.lang Package 
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Float.hashCode Method 


Returns the hash code of the current Float object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public int hashCode(); 





Return Value 


The hash code of the current Float object. 


Example 











// #-ghashc1.jsl 
// Float.GetHashCode example 
public class MyClass 
{ 
public static void main(String[] args) 
Float f = new Float("2.25"); 
System.out.println("The hash code is: " + £.GetHashCode()); 
} 
} 
/* 
Output: 
The hash code is: 1074790400 
=f 
Remarks 


The hash code returned from this method is the integer representation of the value of the Float object. 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float.intBitsToFloat Method 


Returns the floating-point value that corresponds to a specific bit pattern. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static float intBitsToFloat( 
int bits); 


Parameters 
bits 
An int value. 
Return Value 
The floating-point value that corresponds to the specific bit pattern. 
Example 


// f-intBitsToFloatjs| 


// Float.intBitsToFloat example 


public class MyClass 


{ 
public static void main(String[] args) 
1 
// Given a specific bit pattern (= 2.34): 
int bits = 1075167887; 
int sign = ((bits & @x8eee0e000) == 0) ? 1: -1; 
int exponent = ((bits & @x7f800000) >> 23); 
int mantissa = (bits & Ox@e7fFFFF); 
mantissa |= @x@e8e0ee0e; 
// Calculate the result: 
float f = (float)(sign * mantissa * Math.pow(2, exponent-15@)); 
System.out.println("The floating-point result is: " + f); 
} 
} 
/* 
The floating-point result is: 2.34 
*/ 


See also the example on floatTolntBits. 

Remarks 

If the parameter value is Ox7f800000, the result is POSITIVE_INFINITY. 
If the parameter value is Oxff80000, the result is NEGATIVE_INFINITY. 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 


Visual J# Reference 


Float.intValue Method 


Returns the value of the current c705743f-2a78-4a9f-a207-88dd8d160060 object converted to int. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public int intValue(); 





Return Value 


The value of the current Float object converted to int. 


Example TE 











// ¥-intVal1.jsl 
// Float.intValue example 
public class MyClass 
{ 
public static void main(String[] args) 
Float f = new Float("9.5"); 
System.out.println("The int value is: " + f.intValue()); 
} 
} 
/* 
Output: 
The int value is: 9 
ei) 
See Also 
Reference 
Float Class 
Concepts 


Float Members 
java.lang Package 


Visual J# Reference 


Float.isInfinite Method 


Overload List 





Name Description 





Float.isInfinite () Checks if the value of the current Float object is infinity. 





Float.isInfinite (float) Checks if the value of the float parameter is infinity. 














See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float.isinfinite Method () 


Checks if the value of the current Float object is infinity. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public boolean isInfinite(); 





Return Value 


true if the value of f is infinity (positive or negative); false otherwise. 


Example a 











// #-isInf1.jsl 
// Float.isInfinite example 
public class MyClass 
{ 
public static void main(String[] args) 
Float f = new Float(Float.POSITIVE_INFINITY); 
System.out.printin(#.isInfinite()); 
} 
} 
/* 
Output: 
true 
Hf 
See Also 
Reference 
Float Class 
Concepts 


Float Members 
java.lang Package 
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Float.isInfinite Method (Single) 


Checks if the value of the float parameter is infinity. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static boolean isInfinite( 
float f); 


Parameters 


f 
The float value to be tested. 

Return Value 

true if the value of f is infinity (positive or negative); false otherwise. 

Example 


// f-isInf2.js1 
// Float.isInfinite example 


public class MyClass 
{ 


public static void main(String[] args) 


{ 
System.out.println(Float.isInfinite(3.14f)); 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float.isNaN Method 


Overload List 





Name 


Description 





Float.isNaN () 


Checks if the value of the current Float object is Not-a-Number (NaN). 





Float.isNaN (float) 








Checks if the value of the float parameter is Not-a-Number (NaN). 





See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float.isNaN Method () 


Checks if the value of the current Float object is Not-a-Number (NaN). 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public boolean isNaN(); 





Return Value 


true if the value is NaN; false otherwise. 


Example TE 











// #-isNaN1.jsl 
// Float.isNaN example 
public class MyClass 
{ 
public static void main(String[] args) 
Float f = new Float(Math.sqrt(-4)); 
System.out.printin(f.isNaN()); 
} 
} 
/* 
Output: 
true 
Hf 
See Also 
Reference 
Float Class 
Concepts 


Float Members 
java.lang Package 
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Float.isNaN Method (Single) 


Checks if the value of the float parameter is Not-a-Number (NaN). 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static boolean isNaN( 
float f); 


Parameters 


f 
The float value to be tested. 

Return Value 

true if the value is NaN; false otherwise. 

Example 


// f-isNaN2.jsl 
// Float.isNaN example 


public class MyClass 
{ 


public static void main(String[] args) 


{ 
System.out.println(Float.isNaN(33.4f)); 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float.longValue Method 


Returns the value of the current Float object converted to long. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public long longValue(); 





Return Value 
The value of the current Float object converted to long. 


Example 


// f-longV1.jsl 
// Float.longValue example 


public class MyClass 


{ 
public static void main(String[] args) 
Float f = new Float(3456.7); 
System.out.println("The long value is: " + #.longValue()); 
System.out.println("The cast value is: " + (long)3456.7); 
} 
} 
/* 
Output: 


The long value is: 3456 
The cast value is: 3456 
*/ 








Remarks 
The returned value is the same as when you cast a float to long. 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float.parseFloat Method 


Returns a float value specified by the string parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static float parseFloat( 
java.lang.String s) throws java.lang.NumberFormatException; 





Parameters 
Ss 


A string expression. 
Return Value 


The float value specified by s. 








Example 
// *-parseF1.jsl 
// Float.parseFloat example 
public class MyClass 
{ 
public static void main(String[] args) 
float f = Float.parseFloat("-2.45F"); 
System.out.print("The float is: " + f); 
} 
} 
/* 
Output: 
The float is: -2.45 
af 
Remarks 


The exception java.lang.NumberFormatException is thrown if the string cannot be parsed to a float value. 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float.shortValue Method 


Returns the value of the current Float object converted to short. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public short shortValue(); 


Return Value 
The value of the current Float object converted to short. 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float. ToBoolean Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public boolean ToBoolean( 
System.IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 


Visual J# Reference 


Float. ToByte Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.Byte ToByte( 


System. IFormatProvider provider) ; 





Parameters 
provider 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 


Visual J# Reference 


Float. ToChar Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public char ToChar( 


System. IFormatProvider provider) ; 





Parameters 
provider 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float. ToDateTime Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.DateTime ToDateTime( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 


Visual J# Reference 


Float. ToDecimal Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.Decimal ToDecimal ( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 


Visual J# Reference 


Float. ToDouble Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public double ToDouble( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float.TolInt16 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public short ToInt16( 


System. IFormatProvider provider) ; 





Parameters 
provider 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float.Tolnt32 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public int ToInt32( 


System. IFormatProvider provider) ; 





Parameters 
provider 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 


Visual J# Reference 


Float.TolInt64 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public long ToInt64( 


System. IFormatProvider provider) ; 





Parameters 
provider 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float.ToSByte Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public byte ToSByte( 


System. IFormatProvider provider) ; 





Parameters 
provider 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 


Visual J# Reference 


Float.ToSingle Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public float ToSingle( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float.toString Method (J#) 


Returns a string that represents the float parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.String toString( 
float f); 


Parameters 


f 


A float expression. 
Return Value 
The string that represents f. 
Example 


// ¥-toStr1i.jsl 
// Float.toString example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Convert the float to a string: 
String s = Float.toString(-3.25f); 
// Then catenate it with another string: 
s = "The string is: " + s; 
System.out.print(s); 
} 
} 
/* 
Output: 
The string is: -3.25 
m/f 
Remarks 


If fis NaN the result is NaN. 

If fis POSITIVE_INFINITY, the result is Infinity. 
If fis NEGATIVE_INFINITY, the result is -Infinity. 
If f is O.0f, the result is 0.0. 

If f is -O.0f, the result is -0.0. 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float.toString Method 


Overload List 





Name 


Description 





Float.ToString () 


Returns a string that represents the value of the current Float object. 





Float.ToString (IFormatProvider) 











See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float.toString Method () 


Returns a string that represents the value of the current Float object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.String toString(); 





Return Value 


The string that represents the value of the current Float object. 


Example 











// #-toStr2.jsl 
// Float.toString example 
public class MyClass 
{ 
public static void main(String[] args) 
{ 
Float f = new Float(2.33f); 
String s = f.toString(); 
// Catenate it with another string: 
s = "The string is: " + s; 
System.out.print(s); 
} 
} 
/* 
Output: 
The string is: 2.33 
= 
Remarks 


If fis NaN the result is NaN. 

If fis POSITIVE_INFINITY, the result is Infinity. 
If fis NEGATIVE_INFINITY, the result is -Infinity. 
If f is 0.0f, the result is 0.0. 

If f is -0.0f, the result is -0.0. 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float.toString Method (IFormatProvider) 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String ToString( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float.ToType Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object ToType( 
System.Type conversionType, 
System. IFormatProvider provider) ; 


Parameters 
conversionType 


provider 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float.ToUInt16 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.UInt16 ToUInt16( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float.ToUInt32 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.UInt32 ToUInt32( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float. ToUInt64 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.UInt64 ToUInt64( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 
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Float.valueOf Method 


Returns the Float object whose float value is represented by a specified string parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static java.lang.Float valueOf( 
java.lang.String s) throws java.lang.NumberFormatException; 





Parameters 
Ss 


The string that represents the float value. 
Return Value 


The Float object whose float value is represented by s. 








Example 
// #-val0f1.jsl 
// Float.valueOf example 
public class MyClass 
{ 
public static void main(String[] args) 
Float f = Float.valueOf("2.25"); 
System.out.print("The value is: " + f); 
} 
} 
/* 
Output: 
The value is: 2.25 
ay 
Remarks 


The exception java.lang.NumberFormatException is thrown if the string cannot be parsed as a float value. 
The exception java.lang.NullPointerException is thrown if the string is null. 


See Also 
Reference 

Float Class 
Concepts 

Float Members 
java.lang Package 





Visual J# Reference 


IllegalAccessError Class 


The error that is thrown when the execution engine attempts to access a member that it does not have permission to access. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.IllegalAccessError 
extends java.lang.IncompatibleClassChangeError 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Error 
java.lang.LinkageError 

java.lang.IncompatibleClassChangeError 
java.lang.lllegalAccessError 


See Also 

Concepts 

IllegalAccessError Members 
java.lang Package 
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IllegalAccessError Members 


The error that is thrown when the execution engine attempts to access a member that it does not have permission to access. 


The following tables list the members exposed by the IIl|egalAccessError type. 


Public Constructors 





Name Description 





IIlegalAccessError Overloaded. Initializes a new instance of an IIlegalAccessError object. 








Public Properties (see also Protected Properties 




















Name Description 

HelpLink (inherited from Exception ) 
InnerException (inherited from Exception ) 
Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 


Name Description 


HResult (inherited from Exception ) 





Public Methods 


























Name Description 

<exceptFilter> Maps various illegal access errors to a java.lang.IllegalAccessError. 
equals (inherited from Object ) 
filllnStackTrace (inherited from Throwable ) 
GetBaseException (inherited from Exception ) 
hashCode (inherited from Object ) 
getLocalizedMessage (inherited from Throwable ) 
getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 
clone (inherited from Throwable ) 














printStackTrace 


Overloaded. (inherited from Throwable ) 





toString 


Protected Methods 


(inherited from Throwable ) 





Name 


Description 





finalize 





(inherited from Object ) 








See Also 

Reference 
IIlegalAccessError Class 
Concepts 

java.lang Package 





Visual J# Reference 


IllegalAccessError Constructor 


Initializes a new instance of an IllegalAccessError object. 


Overload List 


Name Description 

IIlegalAccessError () Initializes a new instance of an IllegalAccessError object. 

IIlegalAccessError (String) Initializes a new instance of an IllegalAccessError object with the given 
message. 





\IlegalAccessError (Serialization|Info, StreamingContext)|Initializes a new instance of an IllegalAccessError object during deserial 
ization. 


IllegalAccessError (String, Exception) Initializes a new instance of an IllegalAccessError object with the given 
message and inner exception. 








See Also 

Reference 
IIlegalAccessError Class 
Concepts 

IllegalAccessError Members 
java.lang Package 
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IllegalAccessError Constructor () 


Initializes a new instance of an IllegalAccessError object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.IllegalAccessError(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
IIlegalAccessError Class 
Concepts 

IIlegalAccessError Members 
java.lang Package 


Visual J# Reference 


IllegalAccessError Constructor (String) 


Initializes a new instance of an IllegalAccessError object with the given message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.IllegalAccessError ( 
java.lang.String s); 


Parameters 
Ss 


A message describing the error condition. 


See Also 

Reference 
IllegalAccessError Class 
Concepts 

IllegalAccessError Members 
java.lang Package 
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IllegalAccessError Constructor (SerializationInfo, 
StreamingContext) 


Initializes a new instance of an IllegalAccessError object during deserialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java.lang.IllegalAccessError( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
IllegalAccessError Class 
Concepts 

IIlegalAccessError Members 
java.lang Package 
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IllegalAccessError Constructor (String, Exception) 


Initializes a new instance of an IllegalAccessError object with the given message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.IllegalAccessError ( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the error condition. 
inner 
An inner exception that led to the IllegalAccessError. 


See Also 

Reference 
IllegalAccessError Class 
Concepts 

IllegalAccessError Members 
java.lang Package 
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IllegalAccessError Methods 


Public Methods 





Name 


Description 





<exceptFilter> 


Maps various illegal access errors to a java.lang.|llegalAccessError. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 


Protected Methods 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


IllegalAccessError Class 


Concepts 
java.lang Package 
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IllegalAccessError Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
IIlegalAccessError Class 
Concepts 

java.lang Package 
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IllegalAccessException Class 


The exception that is thrown when attempting to access a member during reflection that the caller does not have permission to 
access. 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public class java.lang.IllegalAccessException 
extends java.lang.Exception 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.lang.lllegalAccessException 


See Also 

Concepts 

IIlegalAccessException Members 
java.lang Package 
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IllegalAccessException Members 


The exception that is thrown when attempting to access a member during reflection that the caller does not have permission to 
access. 


The following tables list the members exposed by the IIl|egalAccessException type. 


Public Constructors 


IIlegalAccessException Overloaded. Initializes a new instance of an IIlegalAccessException object. 


Public Properties (see also Protected Properties ) 











Name Description 

HelpLink (inherited from Exception ) 
InnerException (inherited from Exception ) 
Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Protected Properties 
Name Description 








HResult (inherited from Exception ) 








Public Methods 











Name Description 

equals (inherited from Object ) 
filllnStackTrace (inherited from Throwable ) 
GetBaseException (inherited from Exception ) 
hashCode (inherited from Object ) 
getLocalizedMessage (inherited from Throwable ) 
getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 
clone (inherited from Throwable ) 





printStackTrace Overloaded. (inherited from Throwable ) 














toString 


(inherited from Throwable ) 





Protected Methods 
Name 


finalize 





See Also 

Reference 
IIlegalAccessException Class 
Concepts 

java.lang Package 





(inherited from Object ) 
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IllegalAccessException Constructor 


Initializes a new instance of an IllegalAccessException object. 


Overload List 


Name Description 
IIlegalAccessException () Initializes a new instance of an IllegalAccessException object. 
IIlegalAccessException (String) Initializes a new instance of an IllegalAccessException object with t 


he given message. 





\IlegalAccessException (SerializationInfo, StreamingContext)|Initializes a new instance of an IllegalAccessException object durin 
g deserialization. 


IIlegalAccessException (String, Exception) Initializes a new instance of an IllegalAccessException object with t 
he message and inner exception. 





See Also 

Reference 
IIlegalAccessException Class 
Concepts 

IIlegalAccessException Members 
java.lang Package 
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IllegalAccessException Constructor () 


Initializes a new instance of an IllegalAccessException object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.IllegalAccessException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
IIlegalAccessException Class 
Concepts 

IIlegalAccessException Members 
java.lang Package 
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IllegalAccessException Constructor (String) 


Initializes a new instance of an IllegalAccessException object with the given message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.IllegalAccessException( 
java.lang.String s); 


Parameters 
Ss 


A message describing the exceptional condition. 


See Also 

Reference 
IllegalAccessException Class 
Concepts 

IIlegalAccessException Members 
java.lang Package 
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IllegalAccessException Constructor (SerializationInfo, 
StreamingContext) 


Initializes a new instance of an IllegalAccessException object during deserialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java.lang.IllegalAccessException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
\IlegalAccessException Class 
Concepts 

IIlegalAccessException Members 
java.lang Package 
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IllegalAccessException Constructor (String, Exception) 


Initializes a new instance of an IllegalAccessException object with the message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.IllegalAccessException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the exceptional condition. 
inner 
An inner exception that led to the IIlegalAccessException. 


See Also 

Reference 
IIlegalAccessException Class 
Concepts 

IIlegalAccessException Members 
java.lang Package 
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IllegalAccessException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


IllegalAccessException Class 


Concepts 
java.lang Package 
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IllegalAccessException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
IllegalAccessException Class 
Concepts 

java.lang Package 
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IllegalArgumentException Class 


The exception that is thrown when an invalid argument is provided to a method call. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.IllegalArgumentException 
extends java. lang.RuntimeException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.lang.RuntimeException 
java.lang.lllegalArgumentException 
java.lang.lllegalThreadStateException 
java.lang.NumberFormatException 
java.security.InvalidParameterException 


See Also 

Concepts 

IllegalArgumentException Members 
java.lang Package 
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IllegalArgumentException Members 


The exception that is thrown when an invalid argument is provided to a method call. 


The following tables list the members exposed by the II|egalArgumentException type. 


Public Constructors 





Name 


Description 





IllegalArgumentException 


Overloaded. Initializes a new instance of an IllegalArgumentException object. 





Name 


HelpLink 


Public Properties (see also Protected Properties 
Description 





(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 


Description 








Name 


Description 





<exceptFilter> 


Maps various illegal argument exceptions to a java.lang.|llegalArgumentException. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 





getMessage 


GetObjectData 


getClass 


clone 








(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Exception ) 








printStackTrace Overloaded. (inherited from Throwable ) 








toString (inherited from Throwable ) 


Protected Methods 





Name Description 





finalize (inherited from Object ) 














See Also 

Reference 
IllegalArgumentException Class 
Concepts 

java.lang Package 
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IllegalArgumentException Constructor 


Initializes a new instance of an IllegalArgumentException object. 


Overload List 





Name Description 

IIlegalArgumentException () Initializes a new instance of an IllegalArgumentException objec 
t. 

IllegalArgumentException (String) Initializes a new instance of an IllegalArgumentException objec 


t with the given message. 


IIlegalArgumentException (SerializationInfo, StreamingContext)|Initializes a new instance of an IllegalArgumentException durin 
g deserialization. 


IIlegalArgumentException (String, Exception) Initializes a new instance of an IIlegalArgumentException with t 
he given message and inner exception. 











See Also 

Reference 
IllegalArgumentException Class 
Concepts 

IllegalArgumentException Members 
java.lang Package 
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IllegalArgumentException Constructor () 


Initializes a new instance of an IllegalArgumentException object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.IllegalArgumentException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
IllegalArgumentException Class 
Concepts 

IllegalArgumentException Members 
java.lang Package 
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IllegalArgumentException Constructor (String) 


Initializes a new instance of an IllegalArgumentException object with the given message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.IllegalArgumentException( 
java.lang.String s); 


Parameters 
Ss 


A message describing the exceptional condition. 


See Also 

Reference 
IllegalArgumentException Class 
Concepts 

IllegalArgumentException Members 
java.lang Package 


Visual J# Reference 


IllegalArgumentException Constructor (Serialization|Info, 
StreamingContext) 


Initializes a new instance of an IllegalArgumentException during deserialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java. lang. IllegalArgumentException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
IIlegalArgumentException Class 
Concepts 

IIlegalArgumentException Members 
java.lang Package 
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IllegalArgumentException Constructor (String, Exception) 


Initializes a new instance of an IllegalArgumentException with the given message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.IllegalArgumentException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the exceptional condition. 
inner 
An inner exception that led to the IIlegalArgumentException. 


See Also 

Reference 
IllegalArgumentException Class 
Concepts 

IllegalArgumentException Members 
java.lang Package 
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IllegalArgumentException Methods 


Public Methods 





Name 


Description 





<exceptFilter> 


Maps various illegal argument exceptions to a java.lang.lllegalArgumentException. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


IllegalArgumentException Class 


Concepts 
java.lang Package 
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IllegalArgumentException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 


IllegalArgumentException Class 


Concepts 
java.lang Package 
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IllegalMonitorStateException Class 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public class java.lang.IllegalMonitorStateException 
extends java.lang.RuntimeException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.lang.RuntimeException 
java.lang.lllegalMonitorStateException 


See Also 

Concepts 

IllegalMonitorStateException Members 
java.lang Package 
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IllegalMonitorStateException Members 


The following tables list the members exposed by the II|egalMonitorStateException type. 


Public Constructors 
Name 


IIlegalMonitorStateException 


Public Properties (see also Protected Properties ) 














Name Description 

HelpLink (inherited from Exception ) 
InnerException (inherited from Exception ) 
Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 


Protected Properties 





Name Description 





HResult (inherited from Exception ) 








Public Methods 
Name Description 


<exceptFilter> 











equals (inherited from Object ) 
filllnStackTrace (inherited from Throwable ) 
GetBaseException (inherited from Exception ) 
hashCode (inherited from Object ) 
getLocalizedMessage (inherited from Throwable ) 
getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 
clone (inherited from Throwable ) 





printStackTrace Overloaded. (inherited from Throwable ) 














toString (inherited from Throwable ) 





Protected Methods 
Name 








finalize (inherited from Object ) 
See Also 

Reference 

IIlegalMonitorStateException Class 

Concepts 


java.lang Package 
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IllegalMonitorStateException Constructor 


Overload List 





Name 


Description 





IIlegalMonitorStateException () 





IIlegalMonitorStateException (String) 





IllegalMonitorStateException (SerializationInfo, StreamingContext) 





IIlegalMonitorStateException (String, Exception) 








See Also 

Reference 
IIlegalMonitorStateException Class 
Concepts 

IIlegalMonitorStateException Members 
java.lang Package 
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IllegalMonitorStateException Constructor () 


Initializes a new instance of the IIlegalMonitorStateException Class . 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.IllegalMonitorStateException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
IIlegalMonitorStateException Class 
Concepts 

IIlegalMonitorStateException Members 
java.lang Package 
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IllegalMonitorStateException Constructor (String) 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.IllegalMonitorStateException( 
java.lang.String s); 


Parameters 
S 


See Also 

Reference 
\IlegalMonitorStateException Class 
Concepts 

IIlegalMonitorStateException Members 
java.lang Package 
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IllegalMonitorStateException Constructor (SerializationInfo, 
StreamingContext) 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java.lang.IllegalMonitorStateException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


context 


See Also 

Reference 
IIlegalMonitorStateException Class 
Concepts 

IIlegalMonitorStateException Members 
java.lang Package 
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IllegalMonitorStateException Constructor (String, Exception) 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.IllegalMonitorStateException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
S 


inner 


See Also 

Reference 
IllegalMonitorStateException Class 
Concepts 

IIlegalMonitorStateException Members 
java.lang Package 
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IllegalMonitorStateException Methods 


Public Methods 





Name 


Description 





<exceptFilter> 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 


Protected Methods 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


IllegalMonitorStateException Class 


Concepts 
java.lang Package 
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IllegalMonitorStateException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 


IllegalMonitorStateException Class 


Concepts 
java.lang Package 
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IllegalStateException Class 


The exception that is thrown when the program has entered an invalid state. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.IllegalStateException 
extends java. lang.RuntimeException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.lang.RuntimeException 
java.lang.lllegalStateException 
java.awtlllegalComponentStateException 


See Also 

Concepts 

lllegalStateException Members 
java.lang Package 


Visual J# Reference 


IllegalStateException Members 


The exception that is thrown when the program has entered an invalid state. 


The following tables list the members exposed by the IllegalStateException type. 


Public Constructors 





Name 


Description 





IIlegalStateException 


Overloaded. Initializes a new instance of an IllegalStateException object. 








Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 


Description 


(inherited from Exception ) 








Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 








printStackTrace 





getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 

clone (inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 








toString 


(inherited from Throwable ) 





Protected Methods 
Name 


finalize 





See Also 

Reference 
IllegalStateException Class 
Concepts 

java.lang Package 





(inherited from Object ) 
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IllegalStateException Constructor 


Initializes a new instance of an IllegalStateException object. 


Overload List 


Name Description 
IllegalStateException () Initializes a new instance of an IllegalStateException object. 
IllegalStateException (String) Initializes a new instance of an IllegalStateException object with the 


given message. 





\llegalStateException (SerializationInfo, StreamingContext)|Initializes a new instance of an IllegalStateException during deseriali 
zation. 


IllegalStateException (String, Exception) Initializes a new instance of an IllegalStateException object with the 
given message and inner exception. 








See Also 

Reference 
IllegalStateException Class 
Concepts 

IllegalStateException Members 
java.lang Package 
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IllegalStateException Constructor () 


Initializes a new instance of an IllegalStateException object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.IllegalStateException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
IllegalStateException Class 
Concepts 

IllegalStateException Members 
java.lang Package 
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IllegalStateException Constructor (String) 


Initializes a new instance of an IllegalStateException object with the given message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.IllegalStateException( 
java.lang.String s); 


Parameters 
Ss 


A message describing the exceptional condition. 


See Also 

Reference 
IllegalStateException Class 
Concepts 

IIlegalStateException Members 
java.lang Package 
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IllegalStateException Constructor (SerializationInfo, 
StreamingContext) 


Initializes a new instance of an IllegalStateException during deserialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java.lang.IllegalStateException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
lIlegalStateException Class 
Concepts 

IllegalStateException Members 
java.lang Package 
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IllegalStateException Constructor (String, Exception) 


Initializes a new instance of an IllegalStateException object with the given message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.IllegalStateException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the exceptional condition. 
inner 
An inner exception that led to the IllegalStateException. 


See Also 

Reference 
IllegalStateException Class 
Concepts 

IllegalStateException Members 
java.lang Package 
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IllegalStateException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


IllegalStateException Class 


Concepts 
java.lang Package 
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IllegalStateException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
IllegalStateException Class 
Concepts 

java.lang Package 
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IllegalThreadStateException Class 


The exception that is thrown when a thread has entered an illegal state. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.IllegalThreadStateException 
extends java.lang.IllegalArgumentException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.lang.RuntimeException 
java.lang.lllegalArgumentException 
java.lang.lllegalThreadStateException 


See Also 

Concepts 

IllegalThreadStateException Members 
java.lang Package 
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IllegalThreadStateException Members 


The exception that is thrown when a thread has entered an illegal state. 


The following tables list the members exposed by the IIlegalThreadStateException type. 


Public Constructors 





Name 


Description 





IllegalThreadStateException 


Overloaded. Initializes a new instance of an IIlegalThreadStateException object. 





Public Properties 
Name 


HelpLink 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 





Description 


(inherited from Exception ) 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 








printStackTrace 





getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 

clone (inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 








toString (inherited from Throwable ) 





Protected Methods 
Name 








finalize (inherited from Object ) 
See Also 

Reference 

IllegalThreadStateException Class 

Concepts 


java.lang Package 
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IllegalThreadStateException Constructor 


Initializes a new instance of an IllegalThreadStateException object. 


Overload List 





Name Description 

IIlegalThreadStateException () Initializes a new instance of an IllegalThreadStateException o 
bject. 

IllegalThreadStateException (String) Initializes a new instance of an IllegalThreadStateException o 


bject with the given message. 


\llegalThreadStateException (SerializationInfo, StreamingContext)|Initializes a new instance of an IllegalThreadStateException o 
bject during deserialization. 


IllegalThreadStateException (String, Exception) Initializes a new instance of an IllegalThreadStateException o 
bject with the given message and inner exception. 














See Also 

Reference 
IllegalThreadStateException Class 
Concepts 

IllegalThreadStateException Members 
java.lang Package 
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IllegalThreadStateException Constructor () 


Initializes a new instance of an IllegalThreadStateException object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.IllegalThreadStateException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
lIlegalThreadStateException Class 
Concepts 

IllegalThreadStateException Members 
java.lang Package 
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IllegalThreadStateException Constructor (String) 


Initializes a new instance of an IllegalThreadStateException object with the given message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.IllegalThreadStateException( 
java.lang.String s); 


Parameters 
Ss 


A message describing the exceptional condition. 


See Also 

Reference 
IllegalThreadStateException Class 
Concepts 

IllegalThreadStateException Members 
java.lang Package 
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IllegalThreadStateException Constructor (SerializationInfo, 
StreamingContext) 


Initializes a new instance of an IllegalThreadStateException object during deserialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java.lang.IllegalThreadStateException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
IIlegalThreadStateException Class 
Concepts 

\IlegalThreadStateException Members 
java.lang Package 


Visual J# Reference 


IllegalThreadStateException Constructor (String, Exception) 


Initializes a new instance of an IllegalThreadStateException object with the given message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.IllegalThreadStateException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the exceptional condition. 
inner 
An inner exception that led to the IllegalThreadStateException being thrown. 


See Also 

Reference 
IllegalThreadStateException Class 
Concepts 

\llegalThreadStateException Members 
java.lang Package 
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IllegalThreadStateException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


IllegalThreadStateException Class 


Concepts 
java.lang Package 
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IllegalThreadStateException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 


IllegalThreadStateException Class 


Concepts 
java.lang Package 
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IncompatibleClassChangeError Class 


The error that is thrown when an incompatible change is made to a class. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.IncompatibleClassChangeError 
extends java.lang.LinkageError 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Error 
java.lang.LinkageError 
java.lang.IncompatibleClassChangeError 
java.lang.AbstractMethodError 
java.lang.lllegalAccessError 
java.lang.InstantiationError 
java.lang.NoSuchFieldError 
java.lang.NoSuchMethodError 


See Also 

Concepts 

IncompatibleClassChangeError Members 
java.lang Package 
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IncompatibleClassChangeError Members 


The error that is thrown when an incompatible change is made to a class. 


The following tables list the members exposed by the IncompatibleClassChangeError type. 


Public Constructors 





Name 


Description 





IncompatibleClassChangeError = |Overloaded. Initializes a new instance of an IncompatibleClassChangeError object. 








Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 





Description 


(inherited from Exception ) 





Name 


Description 





<exceptFilter> 


Do not document. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 





getMessage 


GetObjectData 


getClass 


clone 





(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 








printStackTrace Overloaded. (inherited from Throwable ) 





toString (inherited from Throwable ) 





Protected Methods 




















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 

IncompatibleClassChangeError Class 

Concepts 


java.lang Package 
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IncompatibleClassChangeError Constructor 


Initializes a new instance of an IncompatibleClassChangeError object. 


Overload List 
Name Description 


IncompatibleClassChangeError () Initializes a new instance of an IncompatibleClassChange 
Error object. 





IncompatibleClassChangeError (String) Initializes a new instance of an IncompatibleClassChange 
Error object with the given message. 


IncompatibleClassChangeError (SerializationInfo, StreamingContext)|Initializes a new instance of an IncompatibleClassChange 
Error object during deserialization. 


IncompatibleClassChangeError (String, Exception) Initializes a new instance of an IncompatibleClassChange 
Error object with the given message and inner exception. 














See Also 

Reference 
IncompatibleClassChangeError Class 
Concepts 

IncompatibleClassChangeError Members 
java.lang Package 
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IncompatibleClassChangeError Constructor () 


Initializes a new instance of an IncompatibleClassChangeError object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.IncompatibleClassChangeError(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
IncompatibleClassChangeError Class 
Concepts 

IncompatibleClassChangeError Members 
java.lang Package 
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IncompatibleClassChangeError Constructor (String) 


Initializes a new instance of an IncompatibleClassChangeError object with the given message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.IncompatibleClassChangeError( 


java.lang.String s); 
| 


Parameters 
S 


A message describing the exceptional condition. 


See Also 

Reference 
IncompatibleClassChangeError Class 
Concepts 

IncompatibleClassChangeError Members 
java.lang Package 
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IncompatibleClassChangeError Constructor (Serialization|nfo, 
StreamingContext) 


Initializes a new instance of an IncompatibleClassChangeError object during deserialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java. lang. IncompatibleClassChangeError( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
IncompatibleClassChangeError Class 
Concepts 

IncompatibleClassChangeError Members 
java.lang Package 
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IncompatibleClassChangeError Constructor (String, Exception) 


Initializes a new instance of an IncompatibleClassChangeError object with the given message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.IncompatibleClassChangeError( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the error condition. 
inner 
An inner exception that led to the IncompatibleClassChangeError being thrown. 


See Also 

Reference 
IncompatibleClassChangeError Class 
Concepts 

IncompatibleClassChangeError Members 
java.lang Package 
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IncompatibleClassChangeError Methods 


Public Methods 





Name 


Description 





<exceptFilter> 


Do not document. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 


Protected Methods 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


IncompatibleClassChangeError Class 


Concepts 
java.lang Package 
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IncompatibleClassChangeError Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 


IncompatibleClassChangeError Class 


Concepts 
java.lang Package 
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IndexOutOfBoundsException Class 


The exception that is thrown when an attempt is made to read beyond the bounds of a collection. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.IndexOutOfBoundsException 
extends java. lang.RuntimeException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.lang.RuntimeException 
java.lang.IndexOutOfBoundsException 
java.lang.ArraylndexOutOfBoundsException 
java.lang.StringlndexOutOfBoundsException 


See Also 

Concepts 

IndexOutOfBoundsException Members 
java.lang Package 


Visual J# Reference 


IndexOutOfBoundsException Members 


The exception that is thrown when an attempt is made to read beyond the bounds of a collection. 


The following tables list the members exposed by the IndexOutOfBoundsException type. 


Public Constructors 





Name 


Description 





IndexOutOfBoundsException 





Name 


HelpLink 


Public Properties (see also Protected Properties 
Description 





( 





InnerException 


( 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 


Description 








Name 


Description 





<exceptFilter> 


Maps various out of bounds exceptions to a java.lang.IndexOutOfBoundsException. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 





getMessage 


GetObjectData 


getClass 


clone 





(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. Initializes a new instance of an IndexOutOfBoundsException object. 


inherited from Exception ) 


inherited from Exception ) 


(inherited from Exception ) 








printStackTrace Overloaded. (inherited from Throwable ) 





toString (inherited from Throwable ) 





Protected Methods 




















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 

IndexOutOfBoundsException Class 

Concepts 


java.lang Package 
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IndexOutOfBoundsException Constructor 


Initializes a new instance of an IndexOutOfBoundsException object. 


Overload List 





Name Description 

IndexOutOfBoundsException () Initializes a new instance of an IndexOutOfBoundsException 
object. 

IndexOutOfBoundsException (String) Initializes a new instance of an IndexOutOfBoundsException 


object with the given message. 


IndexOutOfBoundsException (SerializationInfo, StreamingContext)|Initializes a new instance of an IndexOutOfBoundsException 
object during deserialization. 


IndexOutOfBoundsException (String, Exception) Initializes a new instance of an IndexOutOfBoundsException 
object with the given message and inner exception. 














See Also 

Reference 
IndexOutOfBoundsException Class 
Concepts 

IndexOutOfBoundsException Members 
java.lang Package 


Visual J# Reference 


IndexOutOfBoundsException Constructor () 


Initializes a new instance of an IndexOutOfBoundsException object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.IndexOutOfBoundsException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
IndexOutOfBoundsException Class 
Concepts 

IndexOutOfBoundsException Members 
java.lang Package 


Visual J# Reference 


IndexOutOfBoundsException Constructor (String) 


Initializes a new instance of an IndexOutOfBoundsException object with the given message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.IndexOutOfBoundsException( 


java.lang.String s); 
| 


Parameters 
S 


A message describing the exceptional condition. 


See Also 

Reference 
IndexOutOfBoundsException Class 
Concepts 

IndexOutOfBoundsException Members 
java.lang Package 
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IndexOutOfBoundsException Constructor (SerializationInfo, 
StreamingContext) 


Initializes a new instance of an IndexOutOfBoundsException object during deserialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java. lang. IndexOutOfBoundsException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
IndexOutOfBoundsException Class 
Concepts 

IndexOutOfBoundsException Members 
java.lang Package 
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IndexOutOfBoundsException Constructor (String, Exception) 


Initializes a new instance of an IndexOutOfBoundsException object with the given message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.IndexOutOfBoundsException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the exceptional condition. 
inner 
An inner exception that led to the IndexOutOfBoundsException. 


See Also 

Reference 
IndexOutOfBoundsException Class 
Concepts 

IndexOutOfBoundsException Members 
java.lang Package 


Visual J# Reference 


IndexOutOfBoundsException Methods 


Public Methods 





Name 


Description 





<exceptFilter> 


Maps various out of bounds exceptions to a java.lang.IndexOutOfBoundsException. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 


Protected Methods 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


IndexOutOfBoundsException Class 


Concepts 
java.lang Package 
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IndexOutOfBoundsException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 


IndexOutOfBoundsException Class 


Concepts 
java.lang Package 
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InstantiationError Class 


The error that is thrown when the execution engine encounters a problem instantiating a new object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.InstantiationError 
extends java.lang.IncompatibleClassChangeError 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Error 
java.lang.LinkageError 

java.lang.IncompatibleClassChangeError 
java.lang.InstantiationError 


See Also 

Concepts 

InstantiationError Members 
java.lang Package 
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InstantiationError Members 


The error that is thrown when the execution engine encounters a problem instantiating a new object. 


The following tables list the members exposed by the InstantiationError type. 


Public Constructors 





Name Description 





InstantiationError Overloaded. Initializes a new instance of an InstantiationError object. 





Public Properties (see also Protected Properties 




















Name Description 

HelpLink (inherited from Exception ) 
InnerException (inherited from Exception ) 
Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 


Name Description 


HResult (inherited from Exception ) 





Public Methods 


























Name Description 

equals (inherited from Object ) 
filllnStackTrace (inherited from Throwable ) 
GetBaseException (inherited from Exception ) 
hashCode (inherited from Object ) 
getLocalizedMessage (inherited from Throwable ) 
getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 
clone (inherited from Throwable ) 


printStackTrace Overloaded. (inherited from Throwable ) 











toString 


(inherited from Throwable ) 





Protected Methods 
Name 


finalize 





See Also 

Reference 
InstantiationError Class 
Concepts 

java.lang Package 





(inherited from Object ) 
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InstantiationError Constructor 


Initializes a new instance of an InstantiationError object. 


Overload List 


Name Description 

InstantiationError () Initializes a new instance of an InstantiationError object. 

InstantiationError (String) Initializes a new instance of an InstantiationError object with the given 
message. 





InstantiationError (SerializationInfo, StreamingContext)|Initializes a new instance of an InstantiationError object during deserial 
ization. 


InstantiationError (String, Exception) Initializes a new instance of an InstantiationError object with the given 
message and inner exception. 





See Also 

Reference 
InstantiationError Class 
Concepts 

InstantiationError Members 
java.lang Package 
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InstantiationError Constructor () 


Initializes a new instance of an InstantiationError object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.InstantiationError(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
InstantiationError Class 
Concepts 

InstantiationError Members 
java.lang Package 
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InstantiationError Constructor (String) 


Initializes a new instance of an InstantiationError object with the given message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.InstantiationError ( 
java.lang.String s); 


Parameters 
Ss 


A message describing the error condition. 


See Also 

Reference 
InstantiationError Class 
Concepts 

InstantiationError Members 
java.lang Package 
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InstantiationError Constructor (SerializationInfo, 
StreamingContext) 


Initializes a new instance of an InstantiationError object during deserialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java.lang.InstantiationError( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
InstantiationError Class 
Concepts 

InstantiationError Members 
java.lang Package 
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InstantiationError Constructor (String, Exception) 


Initializes a new instance of an InstantiationError object with the given message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.InstantiationError ( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the error condition. 
inner 
An inner exception that led to the InstantiationError. 


See Also 

Reference 
InstantiationError Class 
Concepts 

InstantiationError Members 
java.lang Package 
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InstantiationError Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


InstantiationError Class 


Concepts 
java.lang Package 
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InstantiationError Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
InstantiationError Class 
Concepts 

java.lang Package 
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InstantiationException Class 


The exception that is thrown when an error occurs instantiating (creating) an object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.InstantiationException 
extends java.lang.Exception 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.lang.InstantiationException 


See Also 

Concepts 

InstantiationException Members 
java.lang Package 
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InstantiationException Members 


The exception that is thrown when an error occurs instantiating (creating) an object. 


The following tables list the members exposed by the InstantiationException type. 


Public Constructors 





Name 


Description 





InstantiationException 


Overloaded. Initializes a new instance of an InstantiationException object. 





Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 





Description 


(inherited from Exception ) 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 








printStackTrace 





getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 

clone (inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 








toString 


(inherited from Throwable ) 





Protected Methods 
Name 


finalize 





See Also 

Reference 
InstantiationException Class 
Concepts 

java.lang Package 





(inherited from Object ) 
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InstantiationException Constructor 


Initializes a new instance of an InstantiationException object. 


Overload List 


Name Description 
InstantiationException () Initializes a new instance of an InstantiationException object. 
InstantiationException (String) Initializes a new instance of an InstantiationException object with t 


he given message. 





InstantiationException (SerializationInfo, StreamingContext)|Initializes a new instance of an InstantiationException object durin 
g deserialization. 


InstantiationException (String, Exception) Initializes a new instance of an InstantiationException object with t 
he given message and inner exception. 








See Also 

Reference 
InstantiationException Class 
Concepts 

InstantiationException Members 
java.lang Package 
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InstantiationException Constructor () 


Initializes a new instance of an InstantiationException object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.InstantiationException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
InstantiationException Class 
Concepts 

InstantiationException Members 
java.lang Package 
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InstantiationException Constructor (String) 


Initializes a new instance of an InstantiationException object with the given message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.InstantiationException( 
java.lang.String s); 


Parameters 
Ss 


A message describing the exceptional condition. 


See Also 

Reference 
InstantiationException Class 
Concepts 

InstantiationException Members 
java.lang Package 
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InstantiationException Constructor (SerializationInfo, 
StreamingContext) 


Initializes a new instance of an InstantiationException object during deserialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java. lang. InstantiationException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
InstantiationException Class 
Concepts 

InstantiationException Members 
java.lang Package 
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InstantiationException Constructor (String, Exception) 


Initializes a new instance of an InstantiationException object with the given message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.InstantiationException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the exceptional condition. 
inner 
An inner exception that led to the InstantiationException. 


See Also 

Reference 
InstantiationException Class 
Concepts 

InstantiationException Members 
java.lang Package 
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InstantiationException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


InstantiationException Class 


Concepts 
java.lang Package 
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InstantiationException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
InstantiationException Class 
Concepts 

java.lang Package 
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Integer Class 


Declares an Integer class type that wraps the primitive type int into an object. The class contains method members to perform 
tests and to convert from int to other types and vice versa. 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public final class java.lang.Integer 


extends java.lang.Number 
implements System.IConvertible, java.lang.Comparable 








Inheritance Hierarchy 

java.lang.Object 
java.lang.Number 
java.lang.Integer 


See Also 
Concepts 
Integer Members 
java.lang Package 
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Integer Members 


Declares an Integer class type that wraps the primitive type int into an object. The class contains method members to perform 
tests and to convert from int to other types and vice versa. 


The following tables list the members exposed by the Integer type. 


Public Constructors 





ineger Overloaded Constructs a new Integer object. 


Public Fields 















































Name Description 

MAX_VALUE — |The maximum value an Integer object can store. 

MIN_VALUE The minimum value an Integer object can store. 

TYPE The instance of the Class type that represents the primitive type of the Integer object. 
Public Methods 

Name Description 

byteValue Overridden. Returns the byte value of an Integer object. 

compareTo Overloaded. Compares two Integer objects. 

decode Decodes a string and returns the corresponding integer. 

doubleValue Overridden. Returns the double value of an Integer object. 

equals Overridden. Compares the current object to another object and returns a Boolean value. 
floatValue Overridden. Returns the float value of an Integer object. 

hashCode Overridden. Retrieves the hash code of an Integer object. 

getInteger Overloaded. Returns the integer value of a property. 

getClass (inherited from Object) 

intValue Overridden. Returns the int value of the current Integer object. 

longValue Overridden. Returns the long value of the current Integer object. 

clone (inherited from Number) 

parselnt Overloaded. Parses the string parameter and converts it to an integer value. 
shortValue Overridden. Returns the short value of an Integer object. 

toBinaryString |Converts the value of an integer to a binary string. 

















toHexString 


ToBoolean Converts the value of an integer to Boolean using a specific format. 

ToByte Converts an Integer value to a byte using a specific format. 

ToChar Converts an Integer value to a char using a specific format. 

ToDateTime Converts an Integer object value to a date-time value using a specific format. 
ToDecimal Converts an Integer object value to a decimal value using a specific format. 
ToDouble Converts an Integer object value to a double value using a specific format. 


Returns the hexadecimal string representation of an int. 








Tolnt16 Converts an Integer object value to a 2-byte integer using a specific format. 
Tolnt32 Converts an Integer object value to a 4-byte integer using a specific format. 
Tolnt64 Converts an Integer object value to an 8-byte integer using a specific format. 





toOctalString 


Returns the octal number string representation of an int. 






































ToSByte Converts an Integer object value to an sbyte value using a specific format. 
ToSingle Converts an Integer object value to a float value using a specific format. 

toString Overloaded. 

toString Overloaded. Overridden. Returns the string representation of the value of an Integer object. 
ToType Converts an Integer object to a specific type using a specified format. 

ToUInt16 Converts an Integer object to an unsigned short integer using a specified format. 
ToUInt32 Converts an Integer object to an unsigned integer using a specified format. 
ToUInt64 Converts an Integer object to an unsigned long integer using a specified format. 
valueOf Overloaded. 

See Also 

Reference 

Integer Class 

Concepts 


java.lang Package 
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Integer Fields 


Public Fields 























Name Description 

MAX_VALUE — |The maximum value an Integer object can store. 

MIN_VALUE The minimum value an Integer object can store. 

TYPE The instance of the Class type that represents the primitive type of the Integer object. 
See Also 

Reference 

Integer Class 

Concepts 


java.lang Package 
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Integer. MAX_VALUE Field 


The maximum value an Integer object can store. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final int MAX_VALUE; 


Example OC 


// i-MaxMin.jsl 
// Max and Min example 


public class MyClass 


public static void main(String[] args) 








{ 
Integer max = new Integer(Integer.MAX_VALUE) ; 
Integer min = new Integer(Integer.MIN_VALUE) ; 
System.out.println("Max value = " + max); 
System.out.println("Min value = " + min); 
} 
} 
/* 
Output: 
Max value = 2147483647 
Min value = -2147483648 
*/ 
Remarks 


The value of MAX_VALUE is 2147483647. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 
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Integer.MIN_VALUE Field 


The minimum value an Integer object can store. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final int MIN_VALUE; 





Example 

See the example under MAX_VALUE. 
Remarks 

The value of MIN_VALUE is -2147483648. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 
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Integer. TYPE Field 


The instance of the Class type that represents the primitive type of the Integer object. 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final java.lang.Class TYPE; 





Example 


This example prints the value of Integer.TYPE. 








// i-TYPE1.jsl 
// Class TYPE example 
public class MyClass 
x 
public static void main(String[] args) 
{ 
System.out.println("The primitive type is: 
} 
z 
/* 
Output: 
The primitive type is: int 
oy 
See Also 
Reference 
Integer Class 
Concepts 


Integer Members 
java.lang Package 


" + Integer.TYPE) ; 
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Integer Constructor 


Constructs a new Integer object. 


Overload List 


Name Description 


Integer (int) Constructs an Integer object that represents the integer passed as a parameter. 





Integer (String) Constructs an Integer object that represents the string passed as a parameter. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 
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Integer Constructor (Int32) 


Constructs an Integer object that represents the integer passed as a parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.Integer( 
int value); 





Parameters 
value 


Expression of the type int. 
Example 


This example creates an instance of the Integer class and initializes it with the value 123. 





// Integer1.jsl 
// Integer constructor example 
public class MyClass 
{ 
public static void main(String[] args) 
{ 
Integer i = new Integer(123); 
System.out.print("The integer number is: "+ i); 
} 
} 
/* 
Output: 
The integer number is: 123 
= 
See Also 
Reference 
Integer Class 
Concepts 


Integer Members 
java.lang Package 
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Integer Constructor (String) 


Constructs an Integer object that represents the string passed as a parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Integer( 
java.lang.String str) throws java.lang.NumberFormatException; 


Parameters 
str 
A string parameter. 
Example 
This example creates an instance of the Integer class and initializes it with the string "123". 


// Integer2.jsl 
// Integer constructor example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
Integer i = new Integer("123"); 
System.out.print("The integer number is: "+ i); 
} 
} 
/* 
Output: 
The integer number is: 123 
= 
Remarks 


The string parameter should contain an int expression. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 
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Integer Methods 


Public Methods 




















toBinaryString 


Name Description 

byteValue Overridden. Returns the byte value of an Integer object. 

compareTo Overloaded. Compares two Integer objects. 

decode Decodes a string and returns the corresponding integer. 

doubleValue Overridden. Returns the double value of an Integer object. 

equals Overridden. Compares the current object to another object and returns a Boolean value. 
floatValue Overridden. Returns the float value of an Integer object. 

hashCode Overridden. Retrieves the hash code of an Integer object. 

getinteger Overloaded. Returns the integer value of a property. 

getClass (inherited from Object) 

intValue Overridden. Returns the int value of the current Integer object. 

longValue Overridden. Returns the long value of the current Integer object. 

clone (inherited from Number) 

parselnt Overloaded. Parses the string parameter and converts it to an integer value. 
shortValue Overridden. Returns the short value of an Integer object. 


Converts the value of an integer to a binary string. 





ToBoolean Converts the value of an integer to Boolean using a specific format. 

ToByte Converts an Integer value to a byte using a specific format. 

ToChar Converts an Integer value to a char using a specific format. 

ToDateTime Converts an Integer object value to a date-time value using a specific format. 
ToDecimal Converts an Integer object value to a decimal value using a specific format. 
ToDouble Converts an Integer object value to a double value using a specific format. 





toHexString 


Returns the hexadecimal string representation of an int. 





Tolnt16 


Converts an Integer object value to a 2-byte integer using a specific format. 





Tolnt32 








Converts an Integer object value to a 4-byte integer using a specific format. 






































Tolnt64 Converts an Integer object value to an 8-byte integer using a specific format. 
toOctalString Returns the octal number string representation of an int. 

ToSByte Converts an Integer object value to an sbyte value using a specific format. 
ToSingle Converts an Integer object value to a float value using a specific format. 

toString Overloaded. 

toString Overloaded. Overridden. Returns the string representation of the value of an Integer object. 
ToType Converts an Integer object to a specific type using a specified format. 

ToUInt16 Converts an Integer object to an unsigned short integer using a specified format. 
ToUInt32 Converts an Integer object to an unsigned integer using a specified format. 
ToUInt64 Converts an Integer object to an unsigned long integer using a specified format. 
valueOf Overloaded. 

See Also 

Reference 

Integer Class 

Concepts 


java.lang Package 





Visual J# Reference 


Integer.byteValue Method 


Returns the byte value of an Integer object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public byte byteValue(); 





Return Value 


The byte value of the Integer object. 


Example TE 








// i-byteVal1.jsl 
// compareTo Example 
public class MyClass 
{ 
public static void main(String[] args) 
if 
Integer i = new Integer(123); 
System.out.println("The byte value is: " + i.byteValue()); 
} 
} 
/* 
Output: 
The byte value is: 123 
=f 
See Also 
Reference 
Integer Class 
Concepts 


Integer Members 
java.lang Package 


Visual J# Reference 


Integer.compareTo Method 


Compares two Integer objects. 


Overload List 
Name Description 


Integer.compareTo (Integer)|Compares two Integer objects and returns an int value that represents the result of the compariso 
n. 





Integer.compareTo (Object) |Compares the Integer current object to another object, which may or may not be an Integer. In the 
later case it throws an exception. 








See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 





Visual J# Reference 


Integer.compareTo Method (Integer) 


Compares two Integer objects and returns an int value that represents the result of the comparison. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public int compareTo( 
java.lang.Integer anInt); 


Parameters 
anint 
The Integer object to compare to. 
Return Value 
0 if the two objects are identical. -1 if the parameter is greater than the object. 1 if the parameter is less than the object. 
Example 
In this example, two Integer objects are created and compared. Depending on the value of the parameter compared to the 


value of the object the returned value take one of three values -1, 0, and 1. 


// i-compareTo1.jsl 
// compareTo Example 


public class MyClass 


{ 
public static void main(String[] args) 
1 
Integer i1 = new Integer(125); 
Integer i2 = new Integer(123); 
System.out.println("The comparison result = "+ 
i1.compareTo(i2)); // 1 
System.out.println("The comparison result = "+ 
i2.compareTo(il)); // -1 
System.out.println("The comparison result = "+ 
i1.compareTo(il1)); // @ 
} 
} 
/* 
Output: 


The comparison result = 1 
The comparison result -1 
The comparison result = @ 


af 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


Integer.compareTo Method (Object) 


Compares the Integer current object to another object, which may or may not be an Integer. In the later case it throws an 
exception. 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public int compareTo( 
java.lang.Object anInt); 


Parameters 
anint 


The object to compare to. 
Return Value 
0 if the two objects are identical. -1 if the parameter is greater than the object. 1 if the parameter is less than the object. 
Example 


In this example, two Integer objects are created and compared. Depending on the value of the parameter compared to the 
value of the object the returned value take one of three values -1, 0, and 1. 


A fourth comparison is made between an Integer and a Double object, but the statement is commented. If you uncomment the 
statement it will throw an exception. 


// i-compareTo2.jsl 
// compareTo Example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
Integer i1 = new Integer(125); 
Integer i2 = new Integer(123); 
Double i3 = new Double(12.3); 
System.out.println("The comparison result = "+ 
i1.compareTo(i2)); // 1 
System.out.println("The comparison result = "+ 
i2.compareTo(il1)); // -1 
System.out.println("The comparison result = "+ 
i1.compareTo(il1)); // @ 
// The following line throws an exception: 
// System.out.println("The comparison result = "+ 
// i1.compareTo(i3)); 
} 
} 
/* 
Output: 
The comparison result = 1 
The comparison result = -1 
The comparison result = @ 
e 
Remarks 


If the parameter objects are an Integer, the program will throw a java.lang.ClassCastException exception. 


See Also 
Reference 


Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


Integer.decode Method 


Decodes a string and returns the corresponding integer. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.Integer decode( 
java.lang.String str) throws java.lang.NumberFormatException; 


Parameters 
str 


The string to be decoded. 
Return Value 
The Integer object that corresponds to the string parameter. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


Integer.doubleValue Method 


Returns the double value of an Integer object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public double doubleValue() ; 





Return Value 
The double value of the Integer object. 
Example 


The following example uses the method doubleValue to get the equivalent double number of an Integer object. 











// i-doubleVal1.jsl 
// compareTo Example 
public class MyClass 
{ 
public static void main(String[] args) 
if 
Integer i = new Integer(123); 
System.out.println("The double value is: " + i.doubleValue()); 
} 
} 
/* 
Output: 
The double value is: 123.0 
*/ 
See Also 
Reference 
Integer Class 
Concepts 


Integer Members 
java.lang Package 


Visual J# Reference 


Integer.equals Method 


Compares the current object to another object and returns a Boolean value. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public boolean equals( 
java.lang.Object obj); 


Parameters 
obj 
The object to compare to. 
Return Value 
true if the int values of the two objects are identical, false otherwise. 
Example 


// i-equals.jsl 
// equals Example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
Integer i1 = new Integer(123); 
Integer i2 = new Integer (123); 
System.out.print("The equality is: "+ il.equals(i2)); 
} 
} 
/* 
Output: 
The equality is: true 
*/ 
See Also 
Reference 
Integer Class 
Concepts 


Integer Members 
java.lang Package 


Visual J# Reference 


Integer.floatValue Method 


Returns the float value of an Integer object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public float floatValue(); 


Return Value 
The float value of the Integer object. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


Integer.hashCode Method 


Retrieves the hash code of an Integer object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public int hashCode(); 





Return Value 


T the hash code of an Integer object, which is the value of the primitive int stored in the object. 


Example EEE —————=_=_==EaE——————————— 








// i-GHashCode1.jsl 
// compareTo Example 
public class MyClass 
{ 
public static void main(String[] args) 
if 
Integer i = new Integer(423); 
System.out.println("The hash code is: " + i.GetHashCode()); 
} 
} 
/* 
Output: 
The hash code is: 423 
=f 
See Also 
Reference 
Integer Class 
Concepts 


Integer Members 
java.lang Package 


Visual J# Reference 


Integer.getInteger Method 


Returns the integer value of a property. 


Overload List 
Name 


Integer.getinteger (String) 


Integer.getInteger (String, int) 


Integer.getinteger (String, Integer) 





See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Description 


Returns the integer value of a property with a specific name. 


Returns the integer value of a property with a specific name and a default value. 


Returns the integer value of a property with a specific name and a default value. 





Visual J# Reference 


Integer.getinteger Method (String) 


Returns the integer value of a property with a specific name. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.Integer getInteger( 
java.lang.String prop); 


Parameters 
prop 

The property name. 
Return Value 


The integer value of the property. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


Integer.getInteger Method (String, Int32) 


Returns the integer value of a property with a specific name and a default value. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.Integer getInteger( 
java.lang.String prop, 
int defval); 


Parameters 
prop 
The property name. 
defval 
The property default value. 
Return Value 
The integer value of the property. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


Integer.getinteger Method (String, Integer) 


Returns the integer value of a property with a specific name and a default value. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.Integer getInteger( 
java.lang.String prop, 
java.lang.Integer defobj); 


Parameters 
prop 
The property name. 
defobj 
The property default value. 
Return Value 
The integer value of the property. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


Integer.intValue Method 


Returns the int value of the current Integer object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public int intValue(); 





Return Value 


The primitive value stored in the Integer object. 


Example TE 











// IntegerValue.jsl 
// intValue example 
public class MyClass 
{ 
public static void main(String[] args) 
if 
Integer i = new Integer(123); 
System.out.print("The integer value is: "+ i.intValue()); 
} 
} 
/* 
Output: 
The integer value is: 123 
=f 
See Also 
Reference 
Integer Class 
Concepts 


Integer Members 
java.lang Package 


Visual J# Reference 


Integer.longValue Method 


Returns the long value of the current Integer object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public long longValue(); 


Return Value 
The long value of the Integer object. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


Integer.parselnt Method 


Parses the string parameter and converts it to an integer value. 


Overload List 


Name Description 


Integer.parselnt (String) Parses the string parameter and converts it to an integer value. 





Integer.parselnt (String, int) _|Parses the string parameter and converts it to an integer value using a specified radix. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


Integer.parselnt Method (String) 


Parses the string parameter and converts it to an integer value. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static int parseInt( 
java.lang.String str) throws java.lang.NumberFormatException; 


Parameters 
str 


The string parameter. 
Return Value 
The integer value of the parsed string. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


Integer.parselnt Method (String, Int32) 


Parses the string parameter and converts it to an integer value using a specified radix. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static int parseInt( 
java.lang.String str, 
int radix) throws java.lang.NumberFormatException; 


Parameters 
str 


The string parameter. 
radix 
The specified radix. 
Return Value 
The integer value of the parsed string in the specified radix. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


Integer.shortValue Method 


Returns the short value of an Integer object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public short shortValue(); 





Return Value 


The short value of the Integer object. 


Example TE 











// i-shortValue1.jsl 
// shortValue example 
public class MyClass 
{ 
public static void main(String[] args) 
if 
Integer d = new Integer(123); 
System.out.println("The short value is: "+ d.shortValue()); 
} 
} 
/* 
Output: 
The short value is: 123 
= 
See Also 
Reference 
Integer Class 
Concepts 


Integer Members 
java.lang Package 


Visual J# Reference 


Integer.toBinaryString Method 


Converts the value of an integer to a binary string. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.String toBinaryString( 
int inum); 


Parameters 
inum 


An int expression. 
Return Value 
The binary string representation of the integer parameter. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


Integer.ToBoolean Method 


Converts the value of an integer to Boolean using a specific format. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public boolean ToBoolean( 
System. IFormatProvider provider) ; 


Parameters 
provider 


The format provider. 
Return Value 
true if successful; false otherwise. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


Integer.ToByte Method 


Converts an Integer value to a byte using a specific format. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.Byte ToByte( 
System. IFormatProvider provider) ; 


Parameters 
provider 


The format provider. 
Return Value 
The byte value of the object. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


Integer.ToChar Method 


Converts an Integer value to a char using a specific format. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public char ToChar( 
System. IFormatProvider provider) ; 


Parameters 
provider 


The format provider. 
Return Value 
The char value of the Integer object. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


Integer.ToDateTime Method 


Converts an Integer object value to a date-time value using a specific format. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.DateTime ToDateTime( 
System. IFormatProvider provider) ; 


Parameters 
provider 


The format provider. 
Return Value 
The date-time value of the object using the specific format. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


Integer.ToDecimal Method 


Converts an Integer object value to a decimal value using a specific format. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.Decimal ToDecimal ( 
System. IFormatProvider provider) ; 


Parameters 
provider 


The format provider. 
Return Value 
The decimal value of the object. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


Integer. ToDouble Method 


Converts an Integer object value to a double value using a specific format. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public double ToDouble( 
System. IFormatProvider provider) ; 


Parameters 
provider 


The format provider. 
Return Value 
The double value of the object. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


Integer.toHexString Method 


Returns the hexadecimal string representation of an int. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.String toHexString( 
int inum); 


Parameters 
inum 


The int value to be represented as hexadecimal. 
Return Value 
The string representation of the parameter. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


Integer.Tolnt16 Method 


Converts an Integer object value to a 2-byte integer using a specific format. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public short ToInt16( 
System. IFormatProvider provider) ; 


Parameters 
provider 


The format provider. 
Return Value 
The 2-byte integer value of the object. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


Integer.Tolnt32 Method 


Converts an Integer object value to a 4-byte integer using a specific format. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public int ToInt32( 
System. IFormatProvider provider) ; 


Parameters 
provider 


The format provider. 
Return Value 
The 4-byte integer value of the object. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


Integer.TolInt64 Method 


Converts an Integer object value to an 8-byte integer using a specific format. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public long ToInt64( 
System. IFormatProvider provider) ; 


Parameters 
provider 


The format provider. 
Return Value 
The 8-byte integer value of the object. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


Integer.toOctalString Method 


Returns the octal number string representation of an int. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.String toOctalString( 
int inum); 


Parameters 
inum 


The int parameter whose octal representation is required. 
Return Value 
The octal number representation of the parameter. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


Integer.ToSByte Method 


Converts an Integer object value to an sbyte value using a specific format. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public byte ToSByte( 
System. IFormatProvider provider) ; 


Parameters 
provider 


The format provider. 
Return Value 
The sbyte value of the object. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


Integer.ToSingle Method 


Converts an Integer object value to a float value using a specific format. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public float ToSingle( 
System. IFormatProvider provider) ; 


Parameters 
provider 


The format provider. 
Return Value 
The float value of the parameter. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


Integer.ToString Method 


Returns the string representation of the value of an Integer object. 


Overload List 
Name Description 


Integer.ToString () Returns the string representation of the value of an Integer object. 
Integer.ToString (IFormatProvider)|Returns the string representation of the value of an Integer object using a specified format. 
Integer.toString (Int32) Converts an int to its string representation. 


Integer.toString (Int32, Int32) Returns the string representation of the specified int parameter using the number system o 
f the specified radix. 





See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 





Visual J# Reference 


Integer.ToString Method () 


Returns the string representation of the value of an Integer object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.String toString(); 





Return Value 
The string representation of the value of the Integer object. 
Example 


The following example converts the value of the constant Integer.MAX_VALUE to a string and displays the result. 


// i-toString.jsl 
// Integer toString example 


public class MyClass 
{ 


public static void main(String[] args) 


{ 
Integer i = new Integer(Integer.MAX_VALUE) ; 


System.out.println("The string is: 


// or: 
// System.out.println("The string is: 


+ i.toString()); 


+ i); 
} 


/* 

Output: 

The string is: 2147483647 
"/ 








Remarks 
The method is implicitly included in the print and printiIn methods. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


Integer.ToString Method (IFormatProvider) 


Returns the string representation of the value of an Integer object using a specified format. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String ToString( 
System. IFormatProvider provider) ; 


Parameters 
provider 


The format provider. 
Return Value 
The string representation of the value of the object using the specified format. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


Integer.toString Method (Int32) 


Converts an int to its string representation. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.String toString( 
int inum); 


Parameters 
inum 


Expression of the type int. 
Return Value 
The string representation of the specified int parameter. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


Integer.toString Method (Int32, Int32) 


Returns the string representation of the specified int parameter using the number system of the specified radix. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.String toString( 
int inum, 
int radix); 


Parameters 
inum 
The int to be converted. 
radix 
The radix of the number system. 
Return Value 
The string representation of the specified int parameter using the number system of the specified radix. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


Integer. ToType Method 


Converts an Integer object to a specific type using a specified format. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object ToType( 
System.Type conversionType, 
System. IFormatProvider provider) ; 


Parameters 
conversionType 


The type to convert to. 
provider 
The format provider. 
Return Value 
The object converted to the specified type in the specified format. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 
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Integer.ToUInt16 Method 


Converts an Integer object to an unsigned short integer using a specified format. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.UInt16 ToUInt16( 
System. IFormatProvider provider) ; 


Parameters 
provider 


The format provider. 
Return Value 
The unsigned short integer. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 
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Integer.ToUInt32 Method 


Converts an Integer object to an unsigned integer using a specified format. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.UInt32 ToUInt32( 
System. IFormatProvider provider) ; 


Parameters 
provider 


The format provider. 
Return Value 
The unsigned integer in the specified format. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


Integer.ToUInt64 Method 


Converts an Integer object to an unsigned long integer using a specified format. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.UInt64 ToUInt64( 
System. IFormatProvider provider) ; 


Parameters 
provider 


The format provider. 
Return Value 
The unsigned long integer in the specified format. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


Integer.valueOf Method 


Overload List 





Name Description 





Integer.valueOf (String) __|Returns the value of an Integer object represented by a specified string parameter. 





Integer.valueOf (String, int)/Returns the integer value represented by a specified string parameter in the radix specified by an i 
nteger parameter. 








See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 





Visual J# Reference 


Integer.valueOf Method (String) 


Returns the value of an Integer object represented by a specified string parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.Integer valueOf( 
java.lang.String str) throws java.lang.NumberFormatException; 


Parameters 
str 


The string parameter. 
Return Value 
The integer value represented by the string parameter. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 
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Integer.valueOf Method (String, Int32) 


Returns the integer value represented by a specified string parameter in the radix specified by an integer parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.Integer valueOf( 
java.lang.String str, 
int radix) throws java.lang.NumberFormatException; 


Parameters 
str 


The string representing the number. 
radix 
The integer representing the radix. 
Return Value 
The integer value represented by the string in the specified radix. 


See Also 
Reference 

Integer Class 
Concepts 

Integer Members 
java.lang Package 


Visual J# Reference 


InternalError Class 


An error thrown to indicate that an internal error has occurred. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.InternalError 
extends java.lang.VirtualMachineError 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Error 
java.lang.VirtualMachineError 
java.lang.InternalError 


See Also 

Concepts 

InternalError Members 
java.lang Package 


Visual J# Reference 


InternalError Members 


An error thrown to indicate that an internal error has occurred. 


The following tables list the members exposed by the InternalError type. 


Public Constructors 





Name 


Description 





InternalError 


Overloaded. Constructs an InternalError object. 








Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 


Description 


(inherited from Exception ) 








Name 


Description 





<exceptFilter> 


Maps an error object to an InternalError object. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 





getMessage 


GetObjectData 


getClass 


clone 





(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 











printStackTrace 


Overloaded. (inherited from Throwable ) 





toString 


Protected Methods 





(inherited from Throwable ) 





Name 


Description 





finalize 








(inherited from Object ) 





See Also 
Reference 
InternalError Class 
Concepts 
java.lang Package 
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InternalError Constructor 


Constructs an InternalError object. 


Overload List 


Name Description 
InternalError () Constructs an InternalError object with no specific details. 
InternalError (String) Constructs an InternalError object with specific text message. 


InternalError (SerializationInfo, StreamingContext) |Constructs an InternalError object during serialization. 


InternalError (String, Exception) Constructs an InternalError object with a text message and inner exception. 














See Also 

Reference 
InternalError Class 
Concepts 

InternalError Members 
java.lang Package 


Visual J# Reference 


InternalError Constructor () 


Constructs an InternalError object with no specific details. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.InternalError(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
InternalError Class 
Concepts 

InternalError Members 
java.lang Package 
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InternalError Constructor (String) 


Constructs an InternalError object with specific text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.InternalError( 
java.lang.String s); 


Parameters 
Ss 


The string that contains the error message text. 


See Also 

Reference 
InternalError Class 
Concepts 

InternalError Members 
java.lang Package 
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InternalError Constructor (SerializationInfo, 


Constructs an InternalError object during serialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java. lang. InternalError( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information required for serializing an object. 
context 
The source or destination for the serialization. 


See Also 

Reference 
InternalError Class 
Concepts 

InternalError Members 
java.lang Package 


StreamingContext) 
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InternalError Constructor (String, Exception) 


Constructs an InternalError object with a text message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.InternalError( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


The string that contains the message text. 
inner 
The inner exception that led to InternalError. 


See Also 

Reference 
InternalError Class 
Concepts 

InternalError Members 
java.lang Package 
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InternalError Methods 


Public Methods 





Name 


Description 





<exceptFilter> 


Maps an error object to an InternalError object. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 


Protected Methods 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 




















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


InternalError Class 
Concepts 
java.lang Package 
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InternalError Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 
InternalError Class 
Concepts 
java.lang Package 
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InterruptedException Class 


The exception that is thrown when a thread is interrupted. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.InterruptedException 
extends java.lang.Exception 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.lang.InterruptedException 


See Also 

Concepts 

InterruptedException Members 
java.lang Package 
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InterruptedException Members 


The exception that is thrown when a thread is interrupted. 


The following tables list the members exposed by the InterruptedException type. 


Public Constructors 





Name 


Description 





InterruptedException 


Overloaded. Initializes a new instance of an InterruptedException object. 





Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 


Description 


(inherited from Exception ) 








Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 








printStackTrace 





getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 

clone (inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 








toString 


(inherited from Throwable ) 





Protected Methods 
Name 


finalize 





See Also 

Reference 
InterruptedException Class 
Concepts 

java.lang Package 





(inherited from Object ) 





Visual J# Reference 


InterruptedException Constructor 


Initializes a new instance of an InterruptedException object. 


Overload List 


Name Description 
InterruptedException () Initializes a new instance of an InterruptedException object. 
InterruptedException (String) Initializes a new instance of an InterruptedException object with the 


given message. 





InterruptedException (SerializationInfo, StreamingContext)|Initializes a new instance of an InterruptedException object during d 
eserialization. 


InterruptedException (String, Exception) Initializes a new instance of an InterruptedException object with the 
given message and inner exception. 








See Also 

Reference 
InterruptedException Class 
Concepts 

InterruptedException Members 
java.lang Package 
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InterruptedException Constructor () 


Initializes a new instance of an InterruptedException object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.InterruptedException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
InterruptedException Class 
Concepts 

InterruptedException Members 
java.lang Package 
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InterruptedException Constructor (String) 


Initializes a new instance of an InterruptedException object with the given message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.InterruptedException( 
java.lang.String s); 


Parameters 
Ss 


A message describing the exceptional condition. 


See Also 

Reference 
InterruptedException Class 
Concepts 

InterruptedException Members 
java.lang Package 


Visual J# Reference 


InterruptedException Constructor (SerializationInfo, 
StreamingContext) 


Initializes a new instance of an InterruptedException object during deserialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java. lang. InterruptedException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
InterruptedException Class 
Concepts 

InterruptedException Members 
java.lang Package 
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InterruptedException Constructor (String, Exception) 


Initializes a new instance of an InterruptedException object with the given message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.InterruptedException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the exceptional condition. 
inner 
An inner exception that led to the InterruptedException being thrown. 


See Also 

Reference 
InterruptedException Class 
Concepts 

InterruptedException Members 
java.lang Package 
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InterruptedException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


InterruptedException Class 


Concepts 
java.lang Package 
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InterruptedException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
InterruptedException Class 
Concepts 

java.lang Package 
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LinkageError Class 


The error that is thrown when there is an error linking an application. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.LinkageError 
extends java.lang.Error 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Error 
java.lang.LinkageError 
Derived Classes 


See Also 

Concepts 

LinkageError Members 
java.lang Package 
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LinkageError Members 


The error that is thrown when there is an error linking an application. 


The following tables list the members exposed by the LinkageError type. 


Public Constructors 





Name Description 





LinkageError Overloaded. Initializes a new instance of a LinkageError object. 





Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 





Description 


(inherited from Exception ) 





Name 


Description 





<exceptFilter> 


Do not document. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 





getMessage 


GetObjectData 


getClass 


clone 





(inherited from Throwable ) 
(inherited from Throwable ) 
(inherited from Object ) 


(inherited from Throwable ) 








printStackTrace Overloaded. (inherited from Throwable ) 





toString (inherited from Throwable ) 





Protected Methods 
Name Description 








finalize (inherited from Object ) 














See Also 
Reference 
LinkageError Class 
Concepts 
java.lang Package 
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LinkageError Constructor 


Initializes a new instance of a LinkageError object. 


Overload List 


Name Description 
LinkageError () Initializes a new instance of a LinkageError object. 
LinkageError (String) Initializes a new instance of a LinkageError object with the given message. 


LinkageError (Serialization|Info, StreamingContext)|Initializes a new instance of a LinkageError object during deserialization. 


LinkageError (String, Exception) Initializes a new instance of a LinkageError object with the given message a 
nd inner exception. 





See Also 

Reference 
LinkageError Class 
Concepts 

LinkageError Members 
java.lang Package 
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LinkageError Constructor () 


Initializes a new instance of a LinkageError object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.LinkageError(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
LinkageError Class 
Concepts 

LinkageError Members 
java.lang Package 
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LinkageError Constructor (String) 


Initializes a new instance of a LinkageError object with the given message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.LinkageError( 
java.lang.String s); 


Parameters 
Ss 


A message describing the error condition. 


See Also 

Reference 
LinkageError Class 
Concepts 

LinkageError Members 
java.lang Package 
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LinkageError Constructor (SerializationInfo, StreamingContext) 


Initializes a new instance of a LinkageError object during deserialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java.lang.LinkageError( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
LinkageError Class 
Concepts 

LinkageError Members 
java.lang Package 
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LinkageError Constructor (String, Exception) 


Initializes a new instance of a LinkageError object with the given message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.LinkageError( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the error condition. 
inner 
An inner exception that led to the LinkageError being thrown. 


See Also 

Reference 
LinkageError Class 
Concepts 

LinkageError Members 
java.lang Package 
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LinkageError Methods 


Public Methods 





Name 


Description 





<exceptFilter> 


Do not document. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 


Protected Methods 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


LinkageError Class 
Concepts 
java.lang Package 
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LinkageError Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 
LinkageError Class 
Concepts 
java.lang Package 
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Long Class 


Wraps the primitive type long into an object. It also contains methods for conversion and processing Long objects. 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public final class java.lang.Long 
extends java.lang.Number 
implements System.IConvertible, java.lang.Comparable 





Remarks 


This class implements |Convertible. 
Inheritance Hierarchy 
java.lang.Object 

java.lang.Number 

java.lang.Long 


See Also 
Concepts 

Long Members 
java.lang Package 
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Long Members 


Wraps the primitive type long into an object. It also contains methods for conversion and processing Long objects. 


The following tables list the members exposed by the Long type. 


Public Constructors 



































Name Description 

Long Overloaded. 

Public Fields 

Name Description 

MAX_VALUE A constant that stores the maximum value a long number can have. 
MIN_VALUE A constant that stores the minimum value a long number can have. 
TYPE A readonly value that represents the Class instance of the primitive type long. 
Public Methods 

Name Description 

byteValue Overridden. Returns the byte value stored in a Long object. 
compareTo Overloaded. 

decode Decodes a string parameter to a Long object. 

doubleValue Overridden. Returns the value of a Long object converted to double. 
equals Overridden. Compares the current Long object to another object. 
floatValue Overridden. Returns value of a Long object converted to float. 
hashCode Overridden. Returns the hash code of a Long object. 

getLong Overloaded. 

getClass (inherited from Object ) 

intValue Overridden. Returns the value of a Long object as an int. 
longValue Overridden. Returns the value of a Long object as a long number. 
clone (inherited from Number ) 

parseLong Overloaded. 

shortValue Overridden. Returns the value of a Long object as a short number. 
toBinaryString Returns the binary string that represents a long value. 

ToBoolean 














ToByte 





ToChar 





ToDateTime 





ToDecimal 





ToDouble 





toHexString 


Returns the hexadecimal string that represents a long value. 





Tolnt16 





Tolnt32 


Tolnt64 


toOctalString 


ToSByte 


ToSingle 


toString 


toString 


ToType 


ToUInt16 


ToUInt32 


ToUInt64 


valueOf 





See Also 
Reference 
Long Class 
Concepts 


java.lang Package 


Returns the octal string that represents the value of a long value. 


Overloaded. 


Overloaded. Overridden. 


Overloaded. 
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Long Fields 


Public Fields 























Name Description 

MAX_VALUE A constant that stores the maximum value a long number can have. 
MIN_VALUE A constant that stores the minimum value a long number can have. 

TYPE A readonly value that represents the Class instance of the primitive type long. 
See Also 

Reference 

Long Class 

Concepts 


java.lang Package 
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Long.MAX_VALUE Field 


A constant that stores the maximum value a long number can have. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final long MAX_VALUE; 


Example OOOO 


// 1-MAX_VALUE.js1 
// Long MAX_VALUE example 


public class MyClass 


public static void main(String[] args) 


{ 
} 


System.out.print("MAX_VALUE = " + Long.MAX_VALUE); 


} 


/* 

Output: 

MAX_VALUE = 9223372036854775807 
*/ 











Remarks 
The value of MAX_VALUE is 9223372036854775807. 


See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 
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Long.MIN_VALUE Field 


A constant that stores the minimum value a long number can have. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final long MIN_VALUE; 


Example OOOO 


// 1-MIN_VALUE.js1 
// Long MIN_VALUE example 


public class MyClass 


public static void main(String[] args) 


{ 
} 


System.out.print("MIN_VALUE = " + Long.MIN_VALUE) ; 


} 


/* 

Output: 

MIN_VALUE = -9223372036854775808 
| 











Remarks 
The value of MIN_VALUE is -9223372036854775808. 


See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 
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Long.TYPE Field 


A readonly value that represents the Class instance of the primitive type long. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final java.lang.Class TYPE; 


Example ——__________________cc____§t_§___, 


// 1-TYPE.jsl 
// Long TYPE example 


public class MyClass 


public static void main(String[] args) 


{ 
} 


System.out.print("TYPE = " + Long.TYPE); 


} 


/* 

Output: 
TYPE = Long 
a 











Remarks 
The value of TYPE is long. 


See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 
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Long Constructor 


Overload List 





Name Description 





Long (long) Constructs a new Long object that represents a specified long value. 





Long (String) |Constructs a new Long object that represents the long value specified by a string parameter. 














See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 
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Long Constructor (Int64) 


Constructs a new Long object that represents a specified long value. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.Long( 
long value); 





Parameters 
value 


A long expression. 








Example 
// 1-ctor1.jsl 
// Long.#ctor example 
public class MyClass 
public static void main(String[] args) 
{ 
Long 1 = new Long(123L); 
System.out.print("The long value is: " + 1); 
} 
} 
/* 
Output: 
The long value is: 123 
ei 
See Also 
Reference 
Long Class 
Concepts 


Long Members 
java.lang Package 
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Long Constructor (String) 


Constructs a new Long object that represents the long value specified by a string parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Long( 
java.lang.String str) throws java.lang.NumberFormatException; 


Parameters 
str 


A string expression. 
Example 


// 1-ctor2.jsl 
// Long.#ctor example 


public class MyClass 


public static void main(String[] args) 


{ 
Long 1 = new Long("123"); 
System.out.print("The long value is: " + 1); 


/* 

Output: 

The long value is: 123 
a 


See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 
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Long Methods 


Public Methods 




















toBinaryString 


ToBoolean 


ToByte 


ToChar 


ToDateTime 


ToDecimal 


Name Description 

byteValue Overridden. Returns the byte value stored in a Long object. 
compareTo Overloaded. 

decode Decodes a string parameter to a Long object. 

doubleValue Overridden. Returns the value of a Long object converted to double. 
equals Overridden. Compares the current Long object to another object. 
floatValue Overridden. Returns value of a Long object converted to float. 
hashCode Overridden. Returns the hash code of a Long object. 

getLong Overloaded. 

getClass (inherited from Object ) 

intValue Overridden. Returns the value of a Long object as an int. 
longValue Overridden. Returns the value of a Long object as a long number. 
clone (inherited from Number ) 

parseLong Overloaded. 

shortValue Overridden. Returns the value of a Long object as a short number. 


Returns the binary string that represents a long value. 





ToDouble 





toHexString 


Returns the hexadecimal string that represents a long value. 





Tolnt16 





Tolnt32 














Tolnt64 





toOctalString Returns the octal string that represents the value of a long value. 





ToSByte 





ToSingle 





toString Overloaded. 





toString Overloaded. Overridden. 





ToType 





ToUInt16 


ToUInt32 


ToUInt64 


valueOf Overloaded. 





See Also 
Reference 

Long Class 
Concepts 
java.lang Package 
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Long.byteValue Method 


Returns the byte value stored in a Long object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public byte byteValue(); 





Return Value 


The byte value stored in a Long object. 


Example TE 








// 1-byteval1.jsl 
// Long.byteValue example 
public class MyClass 
{ 
public static void main(String[] args) 
if 
Long 1 = new Long("123"); 
System.out.print("The byte value is: " + 1.byteValue()); 
} 
} 
/* 
Output: 
The byte value is: 123 
=f 
See Also 
Reference 
Long Class 
Concepts 


Long Members 
java.lang Package 
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Long.compareTo Method 


Overload List 





Name 


Description 





Long.compareTo (Long) 


Compares the current Long object to another Long object. 





Long.compareTo (Object) 








Compares the current object to another object. 





See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 
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Long.compareTo Method (Long) 


Compares the current Long object to another Long object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public int compareTo( 
java.lang.Long aLong); 


Parameters 
aLong 

The Long object to compare to. 
Return Value 


0 if the two objects are identical. Negative value if aLong is greater than the current object. Positive value if aLong is less than 
the current object. 


Example 


// 1-comp1.jsl 
// Long.compareTo example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
Long 11 = new Long("121"); 
Long 12 = new Long("123"); 
System.out.print("The result is: " + 11.compareTo(12)); 
} 
} 
/* 
Output: 
The result is: -1 
nf 
See Also 
Reference 
Long Class 
Concepts 


Long Members 
java.lang Package 
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Long.compareTo Method (Object) 


Compares the current object to another object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public int compareTo( 
java.lang.Object obj); 


Parameters 
obj 
The object to compare to. 
Return Value 
If obj is a Long object, it behaves exactly like compareTo, in which case it returns: 
0 if the two objects are identical. 
Negative value if obj is greater than the current object. 
Positive value if obj is less than the current object. 
If obj is of another type other than Long, the program throws the exception java.lang.ClassCastException. 
Example 


// Long.compareTo example 
// Throws an exception. 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
Long 1 = new Long("121"); 
Integer i = new Integer("123"); 
System.out.print("The result is: " + 1.compareTo(i)); 
} 
} 
/* 
Output: 


java.lang.ClassCastException: Specified cast is not valid. 
at java.lang.Long.compareTo(Object obj) 
at MyClass.main(String[] args) 

*/ 


See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 
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Long.decode Method 


Decodes a string parameter to a Long object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.Long decode( 
java.lang.String str) throws java.lang.NumberFormatException; 


Parameters 
str 
The string to be decoded. 
Return Value 
The Long object that contains the long value of str. 
Example 


// 1-decode1.jsl 
// Long.decode example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
String s = new String("@x27"); // Hexadecimal number 
Long 1 = Long.decode(s); 
System.out.print("The decoded Long is: " + 1); 
} 
} 
Phi 
Output: 
The decoded long is: 39 
oy 
Remarks 


The string parameter str might contain decimal, hexadecimal, or octal digits. 

Hexadecimal digits are preceded by "Ox", OX", or "#". 

Octal digits are preceded by zero (0). 

If the string cannot be parsed to a long value, the exception java.lang.NumberFormatException is thrown. 


See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 


Visual J# Reference 


Long.doubleValue Method 


Returns the value of a Long object converted to double. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public double doubleValue() ; 


Return Value 
The value of a Long object converted to double. 
Example 


// 1-doubleValue1.jsl 
// Long.doubleValue example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
Long 1 = new Long("123"); 
// Convert it to double and add it to another double number: 
double d = 1.floatValue() + 321.4; 
System.out.print("The new double number is: " + d); 
} 
} 
/* 
Output: 
The new double number is: 444.4 
*/ 
See Also 
Reference 
Long Class 
Concepts 


Long Members 
java.lang Package 


Visual J# Reference 


Long.equals Method 


Compares the current Long object to another object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public boolean equals( 
java.lang.Object obj); 





Parameters 


obj 
The object to compare to. 
Return Value 


true if the two objects are identical; false otherwise. 








Example 
// 1-equals1.jsl 
// Long.Equals example 
public class MyClass 
{ 
public static void main(String[] args) 
if 
Long 11 = new Long("123"); 
Long 12 = new Long("123"); 
System.out.print("The result is: " + 11.Equals(12)); 
} 
} 
/* 
The result is: true 
*/ 
See Also 
Reference 
Long Class 
Concepts 


Long Members 
java.lang Package 





Visual J# Reference 


Long.floatValue Method 


Returns value of a Long object converted to float. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public float floatValue(); 





Return Value 


The value of the Long object converted to float. 


Example OO 








// 1-floatValue1.jsl 
// Long.floatValue example 
public class MyClass 
{ 
public static void main(String[] args) 
{ 
Long 1 = new Long("123"); 
// Convert it to float and add it to another float number: 
float f = 1.floatValue() + 321.4F; 
System.out.print("The new float number is: " + f); 
} 
} 
/* 
Output: 
The new float numler is: 444.4 
*/ 
See Also 
Reference 
Long Class 
Concepts 


Long Members 
java.lang Package 


Visual J# Reference 


Long.hashCode Method 


Returns the hash code of a Long object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public int hashCode(); 





Return Value 


The hash code of the Long object. 


Example TE 








// 1-getHash1.jsl 
// Long.GetHashCode example 
public class MyClass 
{ 
public static void main(String[] args) 
if 
Long b = new Long("123"); 
int h = b.GetHashCode(); 
System.out.print("The hash code is: " + h); 
} 
} 
/* 
The hash code is: 123 
mf 
See Also 
Reference 
Long Class 
Concepts 


Long Members 
java.lang Package 


Visual J# Reference 


Long.getLong Method 


Overload List 





Name 


Description 





Long.getLong (String) 


Returns the long value of the system property specified by a string. 





Long.getLong (String, long) 


Returns a long value that represents the system property with the specified name. 





Long.getLong (String, Long) 








Returns a long value that represents the system property with the specified name. 





See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 





Visual J# Reference 


Long.getLong Method (String) 


Returns the long value of the system property specified by a string. 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.Long getLong( 
java.lang.String prop); 


Parameters 


prop 


The system property name. 


Return Value 


The long value of prop. 


Example 


// 1-getLong1.jsl 
// Long.getLong example 


public class MyClass 


public static void main(String[] args) 


{ 
{ 
} 
} 
/* 
Output: 


String s = System.getProperty("os.version") ; 

// Notice that the output from the following statement 

// can be different on different machines: 
System.out.println("os.version: " + s); 
System.out.println("The long value is: " + Long.getLong(s)); 


os.version: 5.1 
The long value is: null 


*/ 


See Also 
Reference 
Long Class 
Concepts 


Long Members 
java.lang Package 


Visual J# Reference 


Long.getLong Method (String, Int64) 


Returns a long value that represents the system property with the specified name. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.Long getLong( 
java.lang.String prop, 
long defval); 


Parameters 
prop 
The property name. 
defval 
The long default value. 
Return Value 
The long value that represents the system property prop. 
Example 


// 1-getLong2.jsl 
// Long.getLong example 


public class MyClass 


{ 
public static void main(String[] args) 
ii 
String s = System.getProperty("os.version") ; 
// Notice that the output from the following statement 
// can be different on different machines: 
System.out.println("os.version: " + s); 
System.out.println("The value is: " + 
Long.getLong(s,123)); 
} 
} 
/* 


os.version: 5.1 
The value is: 123 
*/ 


Remarks 
If the value that represents the system property is null, the default value defval is returned. 


See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 


Visual J# Reference 


Long.getLong Method (String, Long) 


Returns a long value that represents the system property with the specified name. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.Long getLong( 
java.lang.String prop, 
java.lang.Long defobj); 


Parameters 
prop 
The property name. 
defobj 
The default value object. 
Return Value 
The long value that represents the system property prop. 


Example 


// 1-getLong3.jsl 
// Long.getLong example 


public class MyClass 


{ 
public static void main(String[] args) 
i 
String s = System.getProperty("os.version"); 
// The default object: 
Long 1 = new Long("123"); 
// Notice that the output from the following statement 
// can be different on different machines: 
System.out.println("os.version: " + s); 
System.out.println("The value is: " + Long.getLong(s,1)); 
} 
} 
/* 


os.version: 5.1 
The value is: 123 
=] 


Remarks 
If the value that represents the system property is null, defobj is returned. 


See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 


Visual J# Reference 


Long.intValue Method 


Returns the value of a Long object as an int. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public int intValue(); 





Return Value 


The value of the Long object as an int. 


Example OO 








// 1-intValue1.jsl 
// Long.intValue example 
public class MyClass 
{ 
public static void main(String[] args) 
{ 
Long b = new Long("123"); 
// Convert it and add it to another int: 
int i = b.intValue() + 321; 
System.out.print("The new int is: " + i); 
} 
} 
/* 
Output: 
The new int is: 444 
*/ 
See Also 
Reference 
Long Class 
Concepts 


Long Members 
java.lang Package 


Visual J# Reference 


Long.longValue Method 


Returns the value of a Long object as a long number. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public long longValue(); 





Return Value 


The value of the Long object as a long number. 


Example OO 








// 1-longValue1.jsl 
// Long.longValue example 
public class MyClass 
{ 
public static void main(String[] args) 
if 
Long b = new Long("123"); 
// Convert it and add it to another long number: 
long 1 = b.longValue() + 321L; 
System.out.print("The new long number is: " + 1); 
} 
} 
/* 
Output: 
The new long number is: 444 
af 
See Also 
Reference 
Long Class 
Concepts 


Long Members 
java.lang Package 


Visual J# Reference 


Long.parseLong Method 


Overload List 





Name Description 





Long.parseLong (String) Returns the long value represented by a string parameter. 





Long.parseLong (String, int) |Returns the signed long value represented by a string parameter in the specified radix. 











See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 


Visual J# Reference 


Long.parseLong Method (String) 


Returns the long value represented by a string parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static long parseLong( 
java.lang.String str) throws java.lang.NumberFormatException; 


Parameters 
str 
The string to be parsed. 
Return Value 
The long value represented by the string parameter. 
Example 


// 1-parseLong1.jsl 
// Long.parseLong example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
String s = new String("123"); 
long 1 = Long.parseLong(s); 
System.out.print("The long value is: " + 1); 
} 
} 
/* 
Output: 
The long value is: 123 
nh 
Remarks 


The string characters must all be decimal digits except the first character, which can be a minus sign (-). 
The returned value is a signed long in the decimal radix. 
If the string could not be parsed to a signed decimal long, the exception java.lang.NumberFormatException is thrown. 


See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 


Visual J# Reference 


Long.parseLong Method (String, Int32) 


Returns the signed long value represented by a string parameter in the specified radix. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static long parseLong( 
java.lang.String str, 
int radix) throws java.lang.NumberFormatException; 


Parameters 
str 
The string to be parsed. 
radix 
The radix used in parsing str. 
Return Value 
The long value represented by str in the specified radix. 
Example 


// 1-parse2.jsl 
// Long.parseLong example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
String s1 = new String("255"); // Decimal 
String s2 = new String("FF"); // Hexadecimal 
long 11 = Long.parseLong(si1,10); 
long 12 = Long.parseLong(s2,16); 
System.out.print("11 = "+ 11 + "\nl2 = " 4+ 12); 
} 
} 
/* 
Output: 
11 = 255 
12 = 255 
ef 
Remarks 


The string characters must all be digits in the specified radix except the first character, which can be a minus sign (-). 
The exception java.lang.NumberFormatException is generated if any of the following conditions occurred: 

The string parameter is null. 

The length of the string parameter is zero (""). 

If the value of the radix is not in the range Character.MIN_RADIX to Character. MAX_RADIX. 

The string does not represent a long value. 


If any of the characters in the string, except the first character, which can be a minus sign, is not a valid digit in the specified 
radix. 


See Also 


Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 


Visual J# Reference 


Long.shortValue Method 


Returns the value of a Long object as a short number. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public short shortValue(); 





Return Value 


The value of the Long object as a short number. 


Example TE 











// 1-shvaluel1.jsl 
// Long.shortValue example 
public class MyClass 
{ 
public static void main(String[] args) 
if 
Long 1 = new Long("123"); 
short s = 1.shortValue(); 
System.out.print("The short value is: " +s); 
} 
} 
/* 
Output: 
The short value is: 123 
a) 
See Also 
Reference 
Long Class 
Concepts 


Long Members 
java.lang Package 


Visual J# Reference 


Long.toBinaryString Method 


Returns the binary string that represents a long value. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.String toBinaryString( 
long Inum); 


Parameters 
lnum 
A long expression. 
Return Value 
The binary string that represents the long value. 
Example 


// 1-toBStr1.jsl 
// Long.toBinaryString example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
long 1 = 124; 
// Converting to a string and catenating to another string: 
String s = "The string is: " + Long.toBinaryString(1); 
System.out.print(s); 
} 
} 
/* 
The string is: 1111100 
*/ 
See Also 
Reference 
Long Class 
Concepts 


Long Members 
java.lang Package 


Visual J# Reference 


Long.ToBoolean Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public boolean ToBoolean( 
System.IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 


Visual J# Reference 


Long.ToByte Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.Byte ToByte( 


System. IFormatProvider provider) ; 





Parameters 
provider 


See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 


Visual J# Reference 


Long.ToChar Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public char ToChar( 


System. IFormatProvider provider) ; 





Parameters 
provider 


See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 


Visual J# Reference 


Long.ToDateTime Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.DateTime ToDateTime( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 


Visual J# Reference 


Long.ToDecimal Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.Decimal ToDecimal ( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 


Visual J# Reference 


Long.ToDouble Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public double ToDouble( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 


Visual J# Reference 


Long.toHexString Method 


Returns the hexadecimal string that represents a long value. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.String toHexString( 
long Inum); 


Parameters 
lnum 
A long expression. 
Return Value 
The hexadecimal string that represents the long value. 
Example 


// 1-toHStr1.jsl 
// Long.toHexString example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
long 1 = 255; 
// Converting to a string and catenating to another string: 
String s = "The string is: " + Long.toHexString(1); 
System.out.print(s); 
} 
} 
/* 
The string is: ff 
*/ 
See Also 
Reference 
Long Class 
Concepts 


Long Members 
java.lang Package 


Visual J# Reference 


Long.Tolnt16 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public short ToInt16( 


System. IFormatProvider provider) ; 





Parameters 
provider 


See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 


Visual J# Reference 


Long.Tolnt32 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public int ToInt32( 


System. IFormatProvider provider) ; 





Parameters 
provider 


See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 


Visual J# Reference 


Long.Tolnt64 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public long ToInt64( 


System. IFormatProvider provider) ; 





Parameters 
provider 


See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 


Visual J# Reference 


Long.toOctalString Method 


Returns the octal string that represents the value of a long value. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.String toOctalString( 
long Inum); 


Parameters 
lnum 
A long expression. 
Return Value 
The octal string that represents the value of a long value. 
Example 


// 1-toOStr1.jsl 
// Long.toOctalString example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
long 1 = 254; 
// Converting to a string and catenating to another string: 
String s = "The string is: " + Long.toOctalString(1); 
System.out.print(s); 
} 
} 
/* 
The string is: 376 
*/ 
See Also 
Reference 
Long Class 
Concepts 


Long Members 
java.lang Package 


Visual J# Reference 


Long.ToSByte Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public byte ToSByte( 


System. IFormatProvider provider) ; 





Parameters 
provider 


See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 


Visual J# Reference 


Long.ToSingle Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public float ToSingle( 


System. IFormatProvider provider) ; 





Parameters 
provider 


See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 


Visual J# Reference 


Long.ToString Method 


Overload List 





Name Description 





Long.ToString () Returns the string that represents the value of a Long object. 





Long.ToString (IFormatProvider) 





Long.toString (Int64) Returns the string that represents a long value. 





Long.toString (Int64, Int32) Returns the string that represents a long value in the specified radix. 














See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 


Visual J# Reference 


Long.ToString Method () 


Returns the string that represents the value of a Long object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.String toString(); 





Return Value 


The string that represents the value of the current Long object 


Example 











// 1-toStr3.jsl 
// Long.toString example 
public class MyClass 
{ 
public static void main(String[] args) 
if 
Long 1 = new Long(255); 
// Converting to a string and catenating to another string: 
String s = "The string is: " + 1.toString(); 
System.out.print(s); 
} 
} 
/* 
The string is: 255 
=f 
See Also 
Reference 
Long Class 
Concepts 


Long Members 
java.lang Package 


Visual J# Reference 


Long.ToString Method (IFormatProvider) 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String ToString( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 


Visual J# Reference 


Long.toString Method (Int64) 


Returns the string that represents a long value. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.String toString( 
long Inum); 


Parameters 
lnum 
A long expression. 
Return Value 
The string that represents the long value. 
Example 


// 1-toStr1.jsl 
// Long.toString example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
long 1 = 254; 
// Converting to a string and catenating to another string: 
String s = "The string is: " + Long.toString(1); 
System.out.print(s); 
} 
} 
/* 
The string is: 254 
*/ 
See Also 
Reference 
Long Class 
Concepts 


Long Members 
java.lang Package 


Visual J# Reference 


Long.toString Method (Int64, Int32) 


Returns the string that represents a long value in the specified radix. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.String toString( 
long lInum, 
int radix); 


Parameters 
[num 
A long expression. 
radix 
The specified radix. 
Return Value 
The string that represents the long value in the specified radix. 
Example 


// 1-toStr2.jsl 
// Long.toString example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
long 1 = 255; 
// Converting to a string and catenating to another string, 
// using the hexadecimal radix: 
String s = "The string is: " + Long.toString(1,16); 
System.out.print(s); 
} 
} 
/* 
The string is: ff 
uy | 
See Also 
Reference 
Long Class 
Concepts 


Long Members 
java.lang Package 


Visual J# Reference 


Long.ToType Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object ToType( 
System.Type conversionType, 
System. IFormatProvider provider) ; 


Parameters 
conversionType 


provider 


See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 


Visual J# Reference 


Long.ToUInt16 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.UInt16 ToUInt16( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 


Visual J# Reference 


Long.ToUInt32 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.UInt32 ToUInt32( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 


Visual J# Reference 


Long.ToUInt64 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.UInt64 ToUInt64( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 


Visual J# Reference 


Long.valueOf Method 


Overload List 





Name Description 





Long.valueOf (String) Returns the Long object represented by a string parameter. 





Long.valueOf (String, int) Returns the Long object represented by a string parameter in the specified radix. 














See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 


Visual J# Reference 


Long.valueOf Method (String) 


Returns the Long object represented by a string parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.Long valueOf( 
java.lang.String str) throws java.lang.NumberFormatException; 


Parameters 
str 
The string to be parsed. 
Return Value 
The Long object represented by str. 
Example 


// 1-ValueOf1.jsl 
// Long.valueOf example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
String s = new String("-128"); 
Long 1 = Long.valueOf(s); 
System.out.print("The Long is: " + 1); 
} 
} 
Phi 
Output: 
The Long is: -128 
aA 
Remarks 


The string characters must all be decimal digits except the first character, which can be a minus sign (-). 
If the string could not be parsed to a signed decimal long, the exception java.lang.NumberFormatException is thrown. 


See Also 
Reference 

Long Class 
Concepts 

Long Members 
java.lang Package 


Visual J# Reference 


Long.valueOf Method (String, Int32) 


Returns the Long object represented by a string parameter in the specified radix. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.Long valueOf( 
java.lang.String str, 
int radix) throws java.lang.NumberFormatException; 


Parameters 
str 
The string to be parsed. 
radix 
The radix used in parsing str. 
Return Value 
The Long object represented by str in the specified radix. 
Example 


// 1-ValueOf2.js1 
// Long.valueOf example 


public class MyClass 


{ 
public static void main(String[] args) 
i 
String s = new String("-80"); 
// Parse to a hexadecimal number: 
Long 1 = Long.valueOf(s,16); 
System.out.print("The long value is: " + 1); 
} 
} 
/* 
Output: 
The long value is: -128 
ay 
Remarks 


The string characters must all be digits in the specified radix except the first character, which can be a minus sign (-). 
The exception java.lang.NumberFormatException is generated if any of the following conditions occurred: 

The string parameter is null. 

The length of the string parameter is zero (""). 

If the value of the radix is not in the range Character.MIN_RADIX to Character. MAX_RADIX. 

The string does not represent a long value. 


If any of the characters in the string, except the first character, which can be a minus sign, is not a valid digit in the specified 
radix. 


See Also 
Reference 
Long Class 
Concepts 


Long Members 
java.lang Package 


Visual J# Reference 


Math Class 


Declares the Math class type, which contains method members to perform basic numeric operations such as exponentiation, 
logarithms, and trigonometric functions. 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public final class java.lang.Math 
extends java.lang.Object 





Inheritance Hierarchy 
java.lang.Object 
java.lang.Math 


See Also 
Concepts 

Math Members 
java.lang Package 


Visual J# Reference 


Math Members 


Declares the Math class type, which contains method members to perform basic numeric operations such as exponentiation, 
logarithms, and trigonometric functions. 


The following tables list the members exposed by the Math type. 


Public Constructors 


Name Description 





Math Consus anew Math object. 


Public Fields 
Name _ Description 








E Returns the value of the base of the natural system of logarithms (e). 


Pl Returns the approximate value of the ratio of a circle's circumference to its diameter (Pl). 





Public Methods 




















Name Description 

abs Overloaded. 

acos Returns the arc cosine of a double value. 

asin Returns the arc sine of a double value. 

atan Returns the arc tangent of double value. 

atan2 Converts the Cartesian coordinates of a point (x,y) to the polar coordinates by computing the arc tangent for y/ 
xX. 














ceil Returns a double number that represents the smallest mathematical integer that is not less than a double para 
meter. 

cos Returns the cosine of double parameter. 

equals (inherited from Object ) 

exp Returns the value of the base of the natural system of logarithms (e) raised to the power of a double parameter. 

floor Returns a double number that represents the largest mathematical integer that is not greater than a double par 


ameter. 





hashCode (inherited from Object ) 





getClass (inherited from Object ) 





|EEEremainder|Returns the remainder of the integer division of a double parameter by a second double parameter. 





log Returns the natural logarithm of a double parameter. 





max Overloaded. 














min Overloaded. 























pow Returns the value of a base double number raised to the power of a double exponent. 
random Returns a random double value between 0.0 and 1.0. 

rint Returns a double number that represents the closest integer to a double parameter. 
round Overloaded. 

sin Returns the sine of a double angle. 

sqrt Returns the square root of a double parameter. 

tan Returns the tangent of a double angle. 


toDegrees Converts an angle from radians angle to degrees. 
toRadians Converts an angle from degrees to radians. 


toString Overridden. Returns the string representation of an object. 





Protected Methods 
MemberwiseClone 


Performs a shallow copy of the object. 


See Also 
Reference 

Math Class 
Concepts 
java.lang Package 
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Math Fields 


Public Fields 





Name _ Description 





E Returns the value of the base of the natural system of logarithms (e). 





Pl Returns the approximate value of the ratio of a circle's circumference to its diameter (Pl). 














See Also 
Reference 

Math Class 
Concepts 
java.lang Package 
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Math.E Field 


Returns the value of the base of the natural system of logarithms (e). 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final double E; 





Example 


This example displays the value of the field E. 








// m-E.jsl 
// Math.E example 
public class MyClass 
x 
public static void main(String[] args) 
{ 
System.out.println("Euler's number = " + Math.E); 
} 
z 
/* 
Output: 
Euler's number = 2.7182818284590451 
of, 
See Also 
Reference 
Math Class 
Concepts 


Math Members 
java.lang Package 
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Math.PI Field 


Returns the approximate value of the ratio of a circle's circumference to its diameter (Pl). 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final double PI; 





Example 


This example displays the value of the field PI. 











// m-PI.jsl 
// Math.PI example 
public class MyClass 
x 
public static void main(String[] args) 
{ 
System.out.println("The approximate value of PI = " + Math.PI); 
} 
z 
/* 
Output: 
The approximate value of PI = 3.1415926535897931 
oy 
See Also 
Reference 
Math Class 
Concepts 


Math Members 
java.lang Package 
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Math Constructor 


Constructs a new Math object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.Math(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 
Reference 

Math Class 
Concepts 

Math Members 
java.lang Package 
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Math Methods 


Public Methods 





























Name Description 

abs Overloaded. 

acos Returns the arc cosine of a double value. 

asin Returns the arc sine of a double value. 

atan Returns the arc tangent of double value. 

atan2 Converts the Cartesian coordinates of a point (x,y) to the polar coordinates by computing the arc tangent for y/ 
xX. 

ceil Returns a double number that represents the smallest mathematical integer that is not less than a double para 
meter. 

cos Returns the cosine of double parameter. 

equals (inherited from Object ) 

exp Returns the value of the base of the natural system of logarithms (e) raised to the power of a double parameter. 

floor Returns a double number that represents the largest mathematical integer that is not greater than a double par 
ameter. 

hashCode (inherited from Object ) 

getClass (inherited from Object ) 





IEEEremainder|Returns the remainder of the integer division of a double parameter by a second double parameter. 























log Returns the natural logarithm of a double parameter. 

max Overloaded. 

min Overloaded. 

pow Returns the value of a base double number raised to the power of a double exponent. 
random Returns a random double value between 0.0 and 1.0. 

rint Returns a double number that represents the closest integer to a double parameter. 
round Overloaded. 

sin Returns the sine of a double angle. 

sqrt Returns the square root of a double parameter. 

tan Returns the tangent of a double angle. 








toDegrees Converts an angle from radians angle to degrees. 


toRadians Converts an angle from degrees to radians. 


toString Overridden. Returns the string representation of an object. 








Protected Methods 
MemberwiseClone 


Performs a shallow copy of the object. 


See Also 
Reference 

Math Class 
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java.lang Package 
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Math.abs Method 


Overload List 





Name 


Description 





Math.abs (double) 


Returns the absolute value of a double parameter. 





Math.abs (int) 


Returns the absolute value of an int parameter. 





Math.abs (long) 


Returns the absolute value of long parameter. 





Math.abs (float) 





Returns the absolute value of float parameter. 





See Also 
Reference 

Math Class 
Concepts 

Math Members 
java.lang Package 
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Math.abs Method (Double) 


Returns the absolute value of a double parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static double abs( 
double a); 


Parameters 
a 


A double expression. 
Return Value 
The absolute value of the parameter. 
Example 


The following example displays some double values and their absolute values. 


// m-absDouble.jsl 
// Math.abs example using Double 


public class MyClass 
{ 
public static void main(String[] args) 
{ 
double x = Double.MAX_VALUE; 
double y = Double.MIN_VALUE; 
double z = -88.1; 


// Original values: 
System.out.println("The original values:"); 
System.out.println(x) ; 
System.out.println(y); 
System.out.println(z); 


// Absolute values: 
System.out.println("The absolute values:"); 
System.out.println(Math.abs(x)); 
System.out.println(Math.abs(y) ); 
System.out.println(Math.abs(z)); 


} 
} 
/* 
Output: 


The original values: 
1.7976931348623157E308 
4.94065645841247E-324 
-88.1 

The absolute values: 
1.7976931348623157E308 
4.94065645841247E-324 
88.1 

*/ 


Remarks 


If the parameter is not negative, the parameter is returned. 


If the parameter is negative, the negation of the parameter is returned. 
If the parameter is Double.MIN_VALUE, the same value is returned. 


See Also 
Reference 

Math Class 
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java.lang Package 
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Math.abs Method (Int32) 


Returns the absolute value of an int parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static int abs( 
int a); 


Parameters 
a 
An int expression. 
Return Value 
The absolute value of the parameter. 
Example 
The following example displays some int values and their absolutes values. 


// m-absint.jsl 
// Math.abs example using int variables 


public class MyClass 


i 
public static void main(String[] args) 
{ 
int x = Integer.MAX_VALUE; 
int y = Integer.MIN_VALUE; 
int z = -88; 


// Original values: 
System.out.println("The original values:"); 
System.out.println(x) ; 
System.out.println(y); 
System.out.println(z); 


// Absolute values: 
System.out.println("The absolute values:"); 
System.out.println(Math.abs(x)); 
System.out.println(Math.abs(y)); 
System.out.println(Math.abs(z)); 


} 
/* 


The original values: 
2147483647 
-2147483648 

-88 

The absolute values: 
2147483647 
-2147483648 

88 

*/ 


Remarks 
If the parameter is not negative, the parameter is returned. 


If the parameter is negative, the negation of the parameter is returned. 


If the parameter is Integer. MIN_VALUE, which is equal to -2147483648, the same value is returned. 


See Also 
Reference 

Math Class 
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Math Members 
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Math.abs Method (Int64) 


Returns the absolute value of long parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static long abs( 
long a); 


Parameters 
a 


A long expression. 
Return Value 
The absolute value of the parameter. 
Example 


The following example displays some long values and their absolutes values 


// m-abslong.jsl 
// Math.abs example using long variables 


public class MyClass 
{ 
public static void main(String[] args) 
{ 
long x = Long.MAX_VALUE; 
long y = Long.MIN_VALUE; 
long z = -88; 


// Original values: 
System.out.println("The original values:"); 
System.out.println(x) ; 
System.out.println(y); 
System.out.println(z); 


// Absolute values: 
System.out.println("The absolute values:"); 
System.out.println(Math.abs(x)); 
System.out.println(Math.abs(y)); 
System.out.println(Math.abs(z)); 


} 
/* 


The original values: 
9223372036854775807 
-9223372036854775808 
-88 
The absolute values: 
9223372036854775807 
-9223372036854775808 
88 
*/ 


Remarks 
If the parameter is not negative, the parameter is returned. 


If the parameter is negative, the negation of the parameter is returned. 


If the parameter is Long.MIN_VALUE, which is equal to -9223372036854775808, the same value is returned. 


See Also 
Reference 

Math Class 
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Math.abs Method (Single) 


Returns the absolute value of float parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static float abs( 
float a); 


Parameters 
a 


A float expression. 
Return Value 
The absolute value of the parameter. 
Example 
The following example displays some float values and their absolutes values 


// m-absfloat.jsl 
// Math.abs example using float variables 


public class MyClass 
{ 
public static void main(String[] args) 
{ 
float x Float .MAX_VALUE ; 
float y = Float.MIN_VALUE; 
float z = -88.1f; 


// Original values: 
System.out.println("The original values:"); 
System.out.println(x) ; 
System.out.println(y); 
System.out.println(z); 


// Absolute values: 
System.out.println("The absolute values:"); 
System.out.println(Math.abs(x)); 
System.out.println(Math.abs(y)); 
System.out.println(Math.abs(z)); 


} 


/* 

Output: 

The original values: 
3 .40282347E38 
1.401298E-45 

-88.1 

The absolute values: 
3 .40282347E38 
1.401298E-45 

88.1 

ef 


Remarks 


If the parameter is not negative, the parameter is returned. 


If the parameter is negative, the negation of the parameter is returned. 
If the parameter is Float.‘MIN_VALUE, the same value is returned. 


See Also 
Reference 

Math Class 
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Math Members 
java.lang Package 
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Math.acos Method 


Returns the arc cosine of a double value. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static double acos( 
double a); 


Parameters 
a 


A double expression that represents the angle for which the arc cosine is computed. 
Return Value 
The arc cosine of the double parameter. 
Example 
The following example starts by converting the angle 60 degrees to radians, and then computes the tangent and arc tangent 


for this angle. 


// m-cos1.jsl 
// Math.cos and Math.acos example 


public class MyClass 


if 
public static void main(String[] args) 
{ 
double radians = Math.toRadians(6@.@); 
System.out.println("The angle in radians = "+ radians); 
System.out.println("The cosine of the angle = " + 
Math.cos(radians) ); 
System.out.println("The angle computed with arc cosine = " + 
Math.acos(Math.cos(radians) )); 
} 
} 
/* 
Output: 


The angle in radians = 1.0471975511965976 

The cosine of the angle = @.500000@00000000011 

The angle computed with arc cosine = 1.0471975511965976 
*/ 


Remarks 
If the value of the angle is NaN or greater than 1, the returned value will be NaN. 


See Also 
Reference 

Math Class 
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Math.asin Method 


Returns the arc sine of a double value. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static double asin( 
double a); 


Parameters 
a 


A double expression that represents the angle for which the arc sine is calculated. 
Return Value 
The arc sine of double parameter. 
Example 
This example displays the sine of the angle PI/2 (90 degrees), which is 1.0, and the arc sine of 1.0 in degrees, which is 90. 
// m-asin1.jsl 


// Math.asin and Math.sin examples 
public class MyClass 


{ 
public static void main(String[] args) 
1 
System.out.println("Sine of PI/2 = " + Math.sin(Math.PI/2)); 
System.out.println("Arc sine of 1.0 = " + 
Math. toDegrees(Math.asin(Math.sin(Math.PI/2))))3; 
} 
i 
/* 
Output: 


Sine of PI/2 = 1.0 
Arc sine of 1.0 = 90.0 
a | 


Remarks 
If the value of the parameter is 0, the returned value will be 0 with the same sign. 
If the value of the parameter is NaN or greater than 1, the returned value will be NaN. 


See Also 
Reference 

Math Class 
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Math Members 
java.lang Package 
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Math.atan Method 


Returns the arc tangent of double value. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static double atan( 
double a); 


Parameters 
a 


A double expression that represents the angle for which the arc tangent is calculated. 
Return Value 
The arc tangent of double parameter. 
Example 
The following example starts by converting the angle 45 degrees to radians, and then computes the tangent and arc tangent 


for this angle. 


// m-atan1.jsl 
// Math.tan and Math.atan example 


public class MyClass 


af 
public static void main(String[] args) 
{ 
double radians = Math.toRadians(45.@); 
System.out.println("The angle 45 in radians = "+ radians); 
System.out.println("The tangent of the angle = " + 
Math.ceil(Math.tan(radians))); 
System.out.println("The angle computed with atan = " + 
Math.toDegrees(Math.atan(Math.tan(radians)))); 
} 
} 
/* 
Output: 


The angle 45 in radians = 0.78539816339744828 
The tangent of the angle = 1.0 

The angle computed with atan = 45.0 

*/ 


Remarks 
If the value of the parameter is 0, the returned value will be 0 with the same sign. 
If the value of the parameter is NaN, the returned value will be NaN. 


See Also 
Reference 

Math Class 
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Math Members 
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Math.atan2 Method 


Converts the Cartesian coordinates of a point (x,y) to the polar coordinates by computing the arc tangent for y/x. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static double atan2( 
double y, 
double x); 


Parameters 


y 


A double expression that represents the ordinate. 


A double expression that represents the ordinate the abscissa. 
Return Value 
The arc tangent for y/x. 
Example 
This example computes the angle whose tangent is 100.0/100.0. The result is displayed in both radians and degrees. 


// m-atan2.jsl 
// Math.atan2 example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
System.out.println("Angle in radinas computed with atan2 = " + 
Math.atan2(100.0,100.0)); 
System.out.printlin("Angle in degrees computed with atan2 = " + 
Math.atan2(100.0, 100.0)*180/Math.PI); 
} 
} 
/* 
Output: 


0.78539816339744828 
45.0 


Angle in radinas computed with atan2 
Angle in degrees computed with atan2 


wi 


Remarks 
If the value of one of the parameters is NaN, the returned value will be NaN. 


See Also 
Reference 

Math Class 
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Math.ceil Method 


Returns a double number that represents the smallest mathematical integer that is not less than a double parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static double ceil( 
double a); 


Parameters 
a 


A double expression. 
Return Value 
A double number that represents the smallest mathematical integer that is not less than the double parameter. 
Example 


// m-ceil1.jsl 
// Math.ceil example 


public class MyClass 
{ 


public static void main(String[] args) 


dl 
System.out.println("The ceil of 25.64 = " + 


Math.ceil(25.64)); 


} 


/* 

Output: 

The ceil of 25.64 = 26.0 
*/ 


See Also 
Reference 

Math Class 
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Math Members 
java.lang Package 
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Math.cos Method 


Returns the cosine of double parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static double cos( 
double a); 


Parameters 
a 
A double expression that represents the angle in radians. 
Return Value 
The cosine of double parameter. 
Example 
See the example for acos. 
Remarks 
If the value of the angle is NaN or infinity, the returned value will be NaN. 


See Also 
Reference 

Math Class 
Concepts 

Math Members 
java.lang Package 
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Math.exp Method 


Returns the value of the base of the natural system of logarithms (e) raised to the power of a double parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static double exp( 
double a); 


Parameters 
a 
A double expression that represents the exponent. 
Return Value 
The value of "e" raised to the power of the double parameter 
Example 
This example displays the value of e, which is approximately 2.7183, and the value of e raised to the power zero, which is 1.0. 
// m-exp1.jsl 


// Math.exp example 
public class MyClass 


{ 
public static void main(String[] args) 
1 
System.out.println("The value of e = " + Math.exp(1.@)); 
System.out.println("The value of e raised to the power @ = " + 
Math.exp(@)); 
} 
i 
/* 
Output: 


The value of e = 2.7182818284590451 
The value of e raised to the power @ = 1.0 


yA 


See Also 
Reference 

Math Class 
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java.lang Package 


Visual J# Reference 


Math.floor Method 


Returns a double number that represents the largest mathematical integer that is not greater than a double parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static double floor( 
double a); 


Parameters 
a 


A double expression. 
Return Value 
A double number that represents the largest mathematical integer that is not greater than the double parameter. 
Example 


// m-floor1.jsl 

// Math.floor example 
public class MyClass 
{ 


public static void main(String[] args) 


{ 
System.out.println("The floor of 25.64 = " + 
Math. floor(25.64)); 


i 


/* 

Output: 

The floor of 25.64 = 25.0 
*/ 


See Also 
Reference 


Math Class 
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Math.IEEEremainder Method 


Returns the remainder of the integer division of a double parameter by a second double parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static double IEEEremainder( 
double f1, 
double £2); 


Parameters 


fl 
A double expression that represents the dividend. 
f2 
A double expression that represents the divisor. 
Return Value 
The remainder of f1/f2. 
Example 
The following example calculates the remainder of the division 26.0/4.0. 
// m-remainder1.jsl 


// Math. IEEEremainder example 
public class MyClass 


{ 
public static void main(String[] args) 
{ 
System.out.println("The remainder of 26.0/4.0 = " + 
Math. IEEEremainder(26.0,4.0)); 
} 
} 
/* 
Output: 
The remainder of 26.0/4.0 = 2.0 
arf 
Remarks 


The remainder is calculated as the result of the operation f1-f2*n, where n the result of the integer division of f1/f2. 


If one of the parameters is NaN the result will be NaN. 
If the first parameter is infinite or if the second parameter is 0 result will be NaN. 


See Also 
Reference 

Math Class 
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java.lang Package 
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Math.log Method 


Returns the natural logarithm of a double parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static double log( 
double a); 





Parameters 
a 


A double expression for which the logarithm is computed. 
Return Value 
The natural logarithm of the double parameter. 
Example 


This example calculates the logarithm of E. 











// m-log1.jsl 
// Math.log example 
public class MyClass 
{ 
public static void main(String[] args) 
{ 
System.out.println("The log of e =" + 
Math. log(Math.E)); 
} 
i 
/* 
Output: 
The log of e = 1.0 
*/ 
See Also 
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java.lang Package 
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Math.max Method 


Overload List 





Name 


Description 





Math.max (double, double) 


Returns the larger of two double parameters. 





Math.max (int, int) 


Returns the larger of two int parameters. 





Math.max (long, long) 


Returns the larger of two long parameters. 





Math.max (float, float) 





Returns the larger of two float parameters. 





See Also 
Reference 

Math Class 
Concepts 

Math Members 
java.lang Package 
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Math.max Method (Double, Double) 


Returns the larger of two double parameters. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static double max( 
double a, 
double b); 


Parameters 
a 


A double expression. 
b 

A double expression. 
Return Value 
The larger of a and b. 


See Also 
Reference 

Math Class 
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Math Members 
java.lang Package 
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Math.max Method (Int32, Int32) 


Returns the larger of two int parameters. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static int max( 
int a, 
int b); 


Parameters 
a 

An int expression. 
b 

An int expression. 
Return Value 
The larger of a and b. 


See Also 
Reference 

Math Class 
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Math Members 
java.lang Package 
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Math.max Method (Int64, Int64) 


Returns the larger of two long parameters. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static long max( 
long a, 
long b); 


Parameters 
a 


A long expression. 
b 

A long expression. 
Return Value 
The larger of a and b. 
Example 


This example displays the larger of two long numbers. 


// m-maxl.jsl 

// Math.max example 
public class MyClass 
{ 


public static void main(String[] args) 


{ 
System.out.printin("The maximum of the two long numbers 
Math.max(2345L,2244L)); 


} 


/* 
Output: 
The maximum of the two long numbers = 2345 


*/ 


See Also 
Reference 

Math Class 
Concepts 

Math Members 
java.lang Package 
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Math.max Method (Single, Single) 


Returns the larger of two float parameters. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static float max( 
float a, 
float b); 


Parameters 
a 


A float expression. 
b 

A float expression. 
Return Value 
The larger of a and b. 
Example 


// m-maxf.jsl 

// Math.max example 
public class MyClass 
if 


public static void main(String[] args) 


{ 


System.out.println("The maximum of the two floats = " + 
Math.max(25.02f,25.01f)); 


} 


/* 

Output: 

The maximum of the two floats = 25.02 
=] 


See Also 
Reference 

Math Class 
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Math.min Method 


Overload List 





Name 


Description 





Math.min (double, double) 


Returns the smaller of two double parameters. 





Math.min (int, int) 


Returns the smaller of two int parameters. 





Math.min (long, long) 


Returns the smaller of two long meters. 





Math.min (float, float) 





Returns the smaller of two float parameters. 





See Also 
Reference 

Math Class 
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Math Members 
java.lang Package 





Visual J# Reference 


Math.min Method (Double, Double) 


Returns the smaller of two double parameters. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static double min( 
double a, 
double b); 


Parameters 
a 


A double expression. 
b 

A double expression. 
Return Value 
The smaller of aand b 


See Also 
Reference 

Math Class 
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java.lang Package 
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Math.min Method (Int32, Int32) 


Returns the smaller of two int parameters. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static int min( 
int a, 
int b); 


Parameters 
a 
An int expression. 
b 
An int expression. 
Return Value 
The smaller of a and b. 


See Also 
Reference 

Math Class 
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Math Members 
java.lang Package 
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Math.min Method (Int64, Int64) 


Returns the smaller of two long meters. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static long min( 
long a, 
long b); 


Parameters 
a 


A long expression. 
b 

A long expression. 
Return Value 
The smaller of a and b. 
Example 


The following example displays the minimum of two long numbers. 


// minijsl 
// Math.min example 


public class MyClass 
{ 


public static void main(String[] args) 


{ 


System.out.println("The minimum is = " + 
Math.min(234L, 62345L)); 


} 


/* 
Output: 
The minimum is = 234 


*/ 


See Also 
Reference 

Math Class 
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Math.min Method (Single, Single) 


Returns the smaller of two float parameters. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static float min( 
float a, 
float b); 


Parameters 
a 


A float expression. 
b 

A float expression. 
Return Value 
The smaller of a and b. 
Example 


This example displays the smaller of two float numbers. 


// m-minf.jsl 
// Math.min example 
public class MyClass 
{ 
public static void main(String[] args) 


{ 


System.out.println("The minimum of the two floats = " + 
Math.min(25.02f,25.01f)); 


} 


/* 
Output: 
The minimum of the two floats = 25.01 


*/ 


See Also 
Reference 

Math Class 
Concepts 

Math Members 
java.lang Package 
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Math.pow Method 


Returns the value of a base double number raised to the power of a double exponent. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static double pow( 
double a, 
double b); 


Parameters 
a 
A double expression. 
b 
A double expression that represents the exponent. 
Return Value 
The value of a raised to the power b. 
Example 
This example displays the powers of some double expressions. 


// m-pow1.jsl 
// Math.pow example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
double x = .25; 
double y = 4; 
double z = @; 
// Original values: 
System.out.println("The original values:"); 
System.out.println("x = " + x); 
System.out.println("y = " + y); 
System.out.println("z = " + z); 
// Absolute values: 
System.out.println("The powers:"); 
System.out.println("pow(x,y)= "+ Math.pow(x,y))3; 
System.out.println("pow(y,x)= "+ Math.pow(y,x)); 
System.out.println("pow(x,z)= "+ Math.pow(x,z)); 
} 
} 
/* 
Output: 
The original values: 
xX = 0.25 
y = 4.0 
Z = 0.0 


The powers: 

pow(x,y)= @.00390625 
pow(y,xX)= 1.4142135623730952 
pow(x,z)= 1.0 

*/ 


See Also 
Reference 

Math Class 
Concepts 

Math Members 
java.lang Package 


Visual J# Reference 


Math.random Method 


Returns a random double value between 0.0 and 1.0. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static synchronized double random(); 





Return Value 
A value between 0.0 and 1.0. 
Example 


This example displays the closest mathematical integer to a random value between 1.0 and 10.0. 











// m-random1.jsl 
// Math.random example 
public class MyClass 
{ 
public static void main(String[] args) 
if 
System.out.println("The generated random number is = " + 
Math.rint(Math.random()*1@)); 
} 
} 
/* 
Output: 
The generated random number is = 4.0 
*/ 
See Also 
Reference 
Math Class 
Concepts 


Math Members 
java.lang Package 


Visual J# Reference 


Math.rint Method 


Returns a double number that represents the closest integer to a double parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static double rint( 
double a); 





Parameters 
a 


A double expression. 
Return Value 
A double number that represents the closest integer to the double parameter. 
Example 


This example displays the closest integer value to 25.02. 





// m-rint1i.jsl 
// Math.rint example 
public class MyClass 
{ 
public static void main(String[] args) 
{ 
System.out.println("The closest integer value = " + 
Math.rint(25.02)); 
i 
} 
/* 
Output: 
The closest integer value = 25.0 
* 
See Also 
Reference 
Math Class 
Concepts 


Math Members 
java.lang Package 





Visual J# Reference 


Math.round Method 


Overload List 





Name Description 





Math.round (double) Returns the closest long number to a double parameter. 





Math.round (float) Returns the closest int to a float parameter. 














See Also 
Reference 

Math Class 
Concepts 

Math Members 
java.lang Package 


Visual J# Reference 


Math.round Method (Double) 


Returns the closest long number to a double parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static long round( 
double a); 


Parameters 
a 
A double expression. 
Return Value 
The closest long number to the double parameter. 
Example 
This example displays result of rounding the two double values 45.5 and 45.4. 


// m-round1.jsl 
// Math.round example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
System.out.println("The rounded long number of 45.5 is = " + 
Math. round(45.5))3; 
System.out.println("The rounded long number of 45.4 is = " + 
Math.round(45.4)); 
is 
} 
Ph 
Output: 


The rounded long number of 45.5 is = 46 
The rounded long number of 45.4 is = 45 
a A 


Remarks 
If the number contains a fraction, and if it is equal to or greater than 0.5, it is approximated to 1; truncated otherwise. 
If the parameter is NaN, the returned value is 0. 


See Also 
Reference 

Math Class 
Concepts 

Math Members 
java.lang Package 


Visual J# Reference 


Math.round Method (Single) 


Returns the closest int to a float parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static int round( 
float a); 


Parameters 
a 
A float expression. 
Return Value 
The closest int to the float parameter. 
Example 
This example displays result of rounding the two float values 45.5f and 45.4f. 


// m-round2.jsl 
// Math.round example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
System.out.println("The closest int to 45.5f is = " + 
Math. round(45.5f)); 
System.out.println("The closest int to 45.4f is = " + 
Math.round(45.4Ff)); 
is 
} 
Phi 
Output: 
The closest int to 45.5f is = 46 
The closest int to 45.4f is = 45 
ef: 
Remarks 


If the number contains a fraction, and if it is equal to or greater than 0.5, it is approximated to 1; truncated otherwise. 
If the parameter is NaN, the returned value is 0. 


See Also 
Reference 

Math Class 
Concepts 

Math Members 
java.lang Package 


Visual J# Reference 


Math.sin Method 


Returns the sine of a double angle. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static double sin( 
double a); 


Parameters 
a 


The angle in radians for which the sine is computed. 
Return Value 
The sine of the double parameter. 
Example 
The following example displays the trigonometric sine and arc sine values for some numbers. 
// m-asin2.jsl 


// Math.asin and Math.sin example 
public class MyClass 


{ 
public static void main(String[] args) 
1 
System.out.println("Sine of PI/2 = " + Math.sin(Math.PI/2)); 
System.out.println("Arc sine of 1.0 = " + 
Math.asin(Math.sin(Math.PI/2))); 
System.out.println("Sine of -@.0 = " + Math.sin(-@.@)); 
System.out.println("Arc sine of -@.0 = " + Math.asin(-0.@)); 
System.out.println("Sine of NaN = " + Math.sin(Math.sqrt(-4))); 
System.out.println("Sine of infinity = " + Math.sin(Math.PI/@)); 
} 
} 
/* 
Output: 


Sine of PI/2 = 1.0 

Arc sine of 1.0 = 1.5707963267948966 
Sine of -0.0 = -0.0 

Arc sine of -@.0 = -0.0 

Sine of NaN = NaN 

Sine of infinity = NaN 


i 


Remarks 
If the value of the angle is 0, the returned value will be 0 with the same sign. 
If the value of the angle is NaN or infinity, the returned value will be NaN. 


See Also 
Reference 

Math Class 
Concepts 

Math Members 
java.lang Package 


Visual J# Reference 


Math.sqrt Method 


Returns the square root of a double parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static double sqrt( 
double a); 


Parameters 
a 
A double expression. 
Return Value 
The square root of the double parameter. 
Example 
This example displays the square root of some double numbers. 


// m-sgqrt.jsl 
// Math.sqrt example 


public class MyClass 


{ 

public static void main(String[] args) 

{ 
double x= -1.0; 
double y = 16.0; 
double z = 0.@; 
// Original values: 
System.out.println("Numbers:"); 
System.out.println("x = " + x); 
System.out.printlin("y = " + y); 
System.out.printin("z = " + z); 
// Square roots: 
System.out.println("Square roots:"); 
System.out.println("Sqrt(x) = " + Math.sqrt(x)); 
System.out.printin("Sqrt(sqrt(x)) = " 

+ Math.sqrt(Math.sqrt(x)))35 //Nan 
System.out.printlin("Sqrt(y) = " + Math.sqrt(y)); 
System.out.printin("Sqrt(z) = " + Math.sqrt(z)); 

} 
} 
/* 
Output: 
Numbers: 
xX = -1.0 
y = 16.0 
Z = 0.0 


Square roots: 
Sqrt(x) = NaN 
Sqrt(sqrt(x)) = NaN 
Sqrt(y) = 4.0 
Sqrt(z) = 0.0 

sf 


//Nan 


Remarks 
If the argument is NaN or less than zero, the result is NaN. 


See Also 
Reference 

Math Class 
Concepts 

Math Members 
java.lang Package 


Visual J# Reference 


Math.tan Method 


Returns the tangent of a double angle. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static double tan( 
double a); 


Parameters 
a 
A double expression that represents the angle in radians. 
Return Value 
The tangent of the double parameter. 
Example 
See the example for atan. 
Remarks 
If the value of the angle is 0, the returned value will be 0 with the same sign. 
If the value of the angle is NaN or infinity, the returned value will be NaN. 


See Also 
Reference 

Math Class 
Concepts 

Math Members 
java.lang Package 


Visual J# Reference 


Math.toDegrees Method 


Converts an angle from radians angle to degrees. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static double toDegrees( 
double angrad); 


Parameters 
angrad 


A double expression that represents the angle in radians. 
Return Value 
The angle in degrees. 
Example 
The following example does two conversion operations, one to convert the angle 45 to radians, and another to convert it back 


to degrees. 


// m-toDegrees1.jsl 
// Math.toDegrees s example 


public class MyClass 


af 
public static void main(String[] args) 
{ 
System.out.println("The angle in degrees = " + 
Math. toDegrees(Math. toRadians(45.0)))3; 
} 
} 
/* 
Output: 
The angle in degrees = 45.0 
*/ 
Remarks 


The method returns the result of the expression: angrad * 180/Math.PI. 


See Also 
Reference 

Math Class 
Concepts 

Math Members 
java.lang Package 
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Math.toRadians Method 


Converts an angle from degrees to radians. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static double toRadians( 
double angdeg); 


Parameters 
angdeg 
A double expression that represents the angle in degrees. 
Return Value 
The angle converted to radians. 
Example 
This example converts the angle 45 degrees to radians and displays the result. 


// m-toRadians1.jsl 
// Math.toRadins example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
System.out.println("The angle 45 in radians = " + 
Math. toRadians(45.0)); 
} 
i 
/* 
Output: 
The angle 45 in radians = @.78539816339744828 
*/ 
Remarks 


The method returns the result of the expression: angdeg * Math.PI/180. 


See Also 
Reference 

Math Class 
Concepts 

Math Members 
java.lang Package 
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Math.toString Method 


Returns the string representation of an object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





Return Value 
The string representation of the object. 


Example 





See the examples on different members. 





Remarks 


This method is implicitly included into the print and prinin statements. 


See Also 
Reference 

Math Class 
Concepts 

Math Members 
java.lang Package 
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NegativeArraySizeException Class 


The exception that is thrown when attempting to create an array with less than zero elements. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.NegativeArraySizeException 
extends java. lang.RuntimeException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.lang.RuntimeException 
java.lang.NegativeArraySizeException 


See Also 

Concepts 

NegativeArraySizeException Members 
java.lang Package 
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NegativeArraySizeException Members 


The exception that is thrown when attempting to create an array with less than zero elements. 


The following tables list the members exposed by the NegativeArraySizeException type. 


Public Constructors 





Name 


Description 





NegativeArraySizeException 


Overloaded. Initializes a new instance of a NegativeArraySizeException object. 








Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 





Description 


(inherited from Exception ) 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 








printStackTrace 





getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 

clone (inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 








toString (inherited from Throwable ) 





Protected Methods 
Name 








finalize (inherited from Object ) 
See Also 

Reference 

NegativeArraySizeException Class 

Concepts 


java.lang Package 





Visual J# Reference 


NegativeArraySizeException Constructor 


Initializes a new instance of a NegativeArraySizeException object. 


Overload List 





Name Description 

NegativeArraySizeException () Initializes a new instance of a NegativeArraySizeException o 
bject. 

NegativeArraySizeException (String) Initializes a new instance of a NegativeArraySizeException o 


bject with the given message. 


NegativeArraySizeException (SerializationInfo, StreamingContext)|Initializes a new instance of a NegativeArraySizeException o 
bject during deserialization. 


NegativeArraySizeException (String, Exception) Initializes a new instance of a NegativeArraySizeException o 
bject with the given message and inner exception. 














See Also 

Reference 
NegativeArraySizeException Class 
Concepts 

NegativeArraySizeException Members 
java.lang Package 


Visual J# Reference 


NegativeArraySizeException Constructor () 


Initializes a new instance of a NegativeArraySizeException object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.NegativeArraySizeException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
NegativeArraySizeException Class 
Concepts 

NegativeArraySizeException Members 
java.lang Package 


Visual J# Reference 


NegativeArraySizeException Constructor (String) 


Initializes a new instance of a NegativeArraySizeException object with the given message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.NegativeArraySizeException( 


java.lang.String s); 
| 


Parameters 
S 


A message describing the exceptional condition. 


See Also 

Reference 
NegativeArraySizeException Class 
Concepts 

NegativeArraySizeException Members 
java.lang Package 
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NegativeArraySizeException Constructor (SerializationI|nfo, 
StreamingContext) 


Initializes a new instance of a NegativeArraySizeException object during deserialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java. lang.NegativeArraySizeException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
NegativeArraySizeException Class 
Concepts 

NegativeArraySizeException Members 
java.lang Package 
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NegativeArraySizeException Constructor (String, Exception) 


Initializes a new instance of a NegativeArraySizeException object with the given message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.NegativeArraySizeException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the exceptional condition. 
inner 
An inner exception that led to the NegativeArraySizeException being thrown. 


See Also 

Reference 
NegativeArraySizeException Class 
Concepts 

NegativeArraySizeException Members 
java.lang Package 


Visual J# Reference 


NegativeArraySizeException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


NegativeArraySizeException Class 


Concepts 
java.lang Package 
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NegativeArraySizeException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 


NegativeArraySizeException Class 


Concepts 
java.lang Package 








Visual J# Reference 


NoClassDefFoundError Class 


An error occurs when a class fails to load because no definition of this class was found. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.NoClassDefFoundError 
extends java.lang.LinkageError 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Error 
java.lang.LinkageError 
java.lang.NoClassDefFoundError 


See Also 

Concepts 

NoClassDefFoundError Members 
java.lang Package 
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NoClassDefFoundError Members 


An error occurs when a class fails to load because no definition of this class was found. 


The following tables list the members exposed by the NoClassDefFoundError type. 


Public Constructors 





Name 


Description 





NoClassDefFoundError 


Overloaded. Constructs a NoClassDefFoundError object. 





Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 





Description 


(inherited from Exception ) 





Name 


Description 





<exceptFilter> 


Maps an error object to a NoClassDefFoundError object. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 





getMessage 


GetObjectData 


getClass 


clone 





(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 








printStackTrace 


Overloaded. (inherited from Throwable ) 





toString 


Protected Methods 





(inherited from Throwable ) 





Name 


Description 





finalize 








(inherited from Object ) 








See Also 

Reference 
NoClassDefFoundError Class 
Concepts 

java.lang Package 


Visual J# Reference 


NoClassDefFoundError Constructor 


Constructs a NoClassDefFoundError object. 


Overload List 





Name Description 

NoClassDefFoundError () Constructs a NoClassDefFoundError object without a text messag 
e. 

NoClassDefFoundError (String) Constructs a NoClassDefFoundError object with a specific text m 
essage. 


NoClassDefFoundError (SerializationInfo, StreamingContext)|Constructs a NoClassDefFoundError object during serialization. 


NoClassDefFoundError (String, Exception) Constructs a NoClassDefFoundError object with a text message a 
nd inner exception. 








See Also 

Reference 
NoClassDefFoundError Class 
Concepts 

NoClassDefFoundError Members 
java.lang Package 
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NoClassDefFoundError Constructor () 


Constructs a NoClassDefFoundError object without a text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.NoClassDefFoundError(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
NoClassDefFoundError Class 
Concepts 

NoClassDefFoundError Members 
java.lang Package 
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NoClassDefFoundError Constructor (String) 


Constructs a NoClassDefFoundError object with a specific text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.NoClassDefFoundError( 
java.lang.String s); 


Parameters 
Ss 


The string that contains the description of the error. 


See Also 

Reference 
NoClassDefFoundError Class 
Concepts 

NoClassDefFoundError Members 
java.lang Package 
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NoClassDefFoundError Constructor (SerializationInfo, 
StreamingContext) 


Constructs a NoClassDefFoundError object during serialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java. lang.NoClassDefFoundError( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information required for serializing an object. 
context 
The source or destination for the serialization. 


See Also 

Reference 
NoClassDefFoundError Class 
Concepts 

NoClassDefFoundError Members 
java.lang Package 
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NoClassDefFoundError Constructor (String, Exception) 


Constructs a NoClassDefFoundError object with a text message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.NoClassDefFoundError( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


The string that contains the message text. 
inner 
The inner exception that led to NoClassDefFoundError. 


See Also 

Reference 
NoClassDefFoundError Class 
Concepts 

NoClassDefFoundError Members 
java.lang Package 
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NoClassDefFoundError Methods 


Public Methods 





Name 


Description 





<exceptFilter> 


Maps an error object to a NoClassDefFoundError object. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 


Protected Methods 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


NoClassDefFoundError Class 


Concepts 
java.lang Package 
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NoClassDefFoundError Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
NoClassDefFoundError Class 
Concepts 

java.lang Package 
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NoSuchFieldError Class 


An error thrown when the application tries to access a field of an object and that field does not exist anymore or has changed. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.NoSuchFieldError 
extends java. lang. IncompatibleClassChangeError 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Error 
java.lang.LinkageError 

java.lang.IncompatibleClassChangeError 
java.lang.NoSuchFieldError 


See Also 

Concepts 

NoSuchFieldError Members 
java.lang Package 
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NoSuchFieldError Members 


An error thrown when the application tries to access a field of an object and that field does not exist anymore or has changed. 


The following tables list the members exposed by the NoSuchFieldError type. 


Public Constructors 





Name 


Description 





NoSuchFieldError 


Overloaded. Constructs a NoSuchFieldError object. 








Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 





Description 


(inherited from Exception ) 





Name 


Description 





<exceptFilter> 


Maps an error object to a NoSuchFieldError object. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 





getMessage 


GetObjectData 


getClass 


clone 





(inherited from Throwable ) 
(inherited from Throwable ) 
(inherited from Object ) 


(inherited from Throwable ) 








printStackTrace Overloaded. (inherited from Throwable ) 





toString (inherited from Throwable ) 





Protected Methods 
Name Description 








finalize (inherited from Object ) 














See Also 
Reference 


NoSuchFieldError Class 
Concepts 
java.lang Package 
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NoSuchFieldError Constructor 


Constructs a NoSuchFieldError object. 


Overload List 


Name Description 
NoSuchFieldError () Constructs a NoSuchFieldError object without a specific text message. 
NoSuchFieldError (String) Constructs a NoSuchFieldError object with a specific text message. 


NoSuchFieldError (Serialization|Info, StreamingContext)|Constructs a NoSuchFieldError object during serialization. 


NoSuchFieldError (String, Exception) Constructs a NoSuchFieldError object with a specific text message and 
inner exception. 





See Also 

Reference 
NoSuchFieldError Class 
Concepts 

NoSuchFieldError Members 
java.lang Package 
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NoSuchFieldError Constructor () 


Constructs a NoSuchFieldError object without a specific text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.NoSuchFieldError(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
NoSuchFieldError Class 
Concepts 

NoSuchFieldError Members 
java.lang Package 
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NoSuchFieldError Constructor (String) 


Constructs a NoSuchFieldError object with a specific text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.NoSuchFieldError( 
java.lang.String s); 


Parameters 
Ss 


The string that contains the error message details. 


See Also 

Reference 
NoSuchFieldError Class 
Concepts 

NoSuchFieldError Members 
java.lang Package 
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NoSuchFieldError Constructor (SerializationInfo, 
StreamingContext) 


Constructs a NoSuchFieldError object during serialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java. lang.NoSuchFieldError( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information required for serializing an object. 
context 
The source or destination for the serialization. 


See Also 

Reference 
NoSuchFieldError Class 
Concepts 

NoSuchFieldError Members 
java.lang Package 
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NoSuchFieldError Constructor (String, Exception) 


Constructs a NoSuchFieldError object with a specific text message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.NoSuchFieldError( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


The string that contains the message text. 
inner 
The inner exception that led to NoSuchFieldError. 


See Also 

Reference 
NoSuchFieldError Class 
Concepts 

NoSuchFieldError Members 
java.lang Package 
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NoSuchFieldError Methods 


Public Methods 





Name 


Description 





<exceptFilter> 


Maps an error object to a NoSuchFieldError object. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 


Protected Methods 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


NoSuchFieldError Class 


Concepts 
java.lang Package 
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NoSuchFieldError Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
NoSuchFieldError Class 
Concepts 

java.lang Package 
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NoSuchFieldException Class 


An exception thrown to indicate that a class doesn't contain a specific field. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java. lang.NoSuchFieldException 
extends java.lang.Exception 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.lang.NoSuchFieldException 


See Also 

Concepts 

NoSuchFieldException Members 
java.lang Package 
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NoSuchFieldException Members 


An exception thrown to indicate that a class doesn't contain a specific field. 


The following tables list the members exposed by the NoSuchFieldException type. 


Public Constructors 





Name 


Description 





NoSuchFieldException 


Overloaded. Constructs a NoSuchFieldException exception object. 








Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 





Description 


(inherited from Exception ) 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 








printStackTrace 





getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 

clone (inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 








toString 


(inherited from Throwable ) 





Protected Methods 
Name 


finalize 





See Also 

Reference 
NoSuchFieldException Class 
Concepts 

java.lang Package 





(inherited from Object ) 
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NoSuchFieldException Constructor 


Constructs a NoSuchFieldException exception object. 


Overload List 
Name Description 


NoSuchFieldException () Constructs a NoSuchFieldException exception object without speci 
fic text message. 





NoSuchFieldException (String) Constructs a NoSuchFieldException exception object with a specifi 
c text message. 


NoSuchFieldException (SerializationInfo, StreamingContext)|Constructs a NoSuchFieldException exception object during seriali 
zation. 


NoSuchFieldException (String, Exception) Constructs a NoSuchFieldException exception object with a specifi 
c text message and inner exception. 














See Also 

Reference 
NoSuchFieldException Class 
Concepts 

NoSuchFieldException Members 
java.lang Package 
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NoSuchFieldException Constructor () 


Constructs a NoSuchFieldException exception object without specific text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.NoSuchFieldException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
NoSuchFieldException Class 
Concepts 

NoSuchFieldException Members 
java.lang Package 


Visual J# Reference 


NoSuchFieldException Constructor (String) 


Constructs a NoSuchFieldException exception object with a specific text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.NoSuchFieldException( 
java.lang.String s); 


Parameters 
Ss 


The string that contains the message text. 


See Also 

Reference 
NoSuchFieldException Class 
Concepts 

NoSuchFieldException Members 
java.lang Package 
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NoSuchFieldException Constructor (SerializationInfo, 
StreamingContext) 


Constructs a NoSuchFieldException exception object during serialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java. lang.NoSuchFieldException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information required for serializing an object. 
context 
The source or destination for the serialization. 


See Also 

Reference 
NoSuchFieldException Class 
Concepts 

NoSuchFieldException Members 
java.lang Package 


Visual J# Reference 


NoSuchFieldException Constructor (String, Exception) 


Constructs a NoSuchFieldException exception object with a specific text message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.NoSuchFieldException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


The string that contains the message text. 
inner 
The inner exception that led to NoSuchFieldException. 


See Also 

Reference 
NoSuchFieldException Class 
Concepts 

NoSuchFieldException Members 
java.lang Package 


Visual J# Reference 


NoSuchFieldException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


NoSuchFieldException Class 


Concepts 
java.lang Package 








Visual J# Reference 


NoSuchFieldException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
NoSuchFieldException Class 
Concepts 

java.lang Package 
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NoSuchMethodError Class 


An error that occurs when an application references a method that does not exist. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.NoSuchMethodError 
extends java. lang. IncompatibleClassChangeError 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Error 
java.lang.LinkageError 

java.lang.IncompatibleClassChangeError 
java.lang.NoSuchMethodError 


See Also 

Concepts 

NoSuchMethodError Members 
java.lang Package 
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NoSuchMethodError Members 


An error that occurs when an application references a method that does not exist. 


The following tables list the members exposed by the NoSuchMethodError type. 


Public Constructors 





Name 


Description 





NoSuchMethodError 


Overloaded. Constructs a NoSuchMethodError object. 








Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 





Description 


(inherited from Exception ) 





Name 


Description 





<exceptFilter> 


Maps an error object to a NoSuchMethodError object. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 





getMessage 


GetObjectData 


getClass 


clone 





(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 








printStackTrace 


Overloaded. (inherited from Throwable ) 





toString 


Protected Methods 





(inherited from Throwable ) 





Name 


Description 





finalize 








(inherited from Object ) 








See Also 
Reference 


NoSuchMethodError Class 
Concepts 
java.lang Package 
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NoSuchMethodError Constructor 


Constructs a NoSuchMethodError object. 


Overload List 





Name Description 

NoSuchMethodError () Constructs a NoSuchMethodError object without a specific text mes 
sage. 

NoSuchMethodError (String) Constructs a NoSuchMethodError object with a specific text messag 
e. 


NoSuchMethodError (SerializationInfo, StreamingContext)|Constructs a NoSuchMethodError object during serialization. 


NoSuchMethodError (String, Exception) Constructs a NoSuchMethodError object with a specific text messag 
e and inner exception. 








See Also 

Reference 
NoSuchMethodError Class 
Concepts 

NoSuchMethodError Members 
java.lang Package 
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NoSuchMethodError Constructor () 


Constructs a NoSuchMethodError object without a specific text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.NoSuchMethodError(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
NoSuchMethodError Class 
Concepts 

NoSuchMethodError Members 
java.lang Package 
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NoSuchMethodError Constructor (String) 


Constructs a NoSuchMethodError object with a specific text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.NoSuchMethodError( 
java.lang.String s); 


Parameters 
Ss 


The string that contains the NoSuchMethodError message text. 


See Also 

Reference 
NoSuchMethodError Class 
Concepts 

NoSuchMethodError Members 
java.lang Package 
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NoSuchMethodError Constructor (Serialization|nfo, 
StreamingContext) 


Constructs a NoSuchMethodError object during serialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java. lang.NoSuchMethodError( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information required for serializing an object. 
context 
The source or destination for the serialization. 


See Also 

Reference 
NoSuchMethodError Class 
Concepts 

NoSuchMethodError Members 
java.lang Package 
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NoSuchMethodError Constructor (String, Exception) 


Constructs a NoSuchMethodError object with a specific text message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.NoSuchMethodError( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


The string that contains the message text. 
inner 
The inner exception that led to NoSuchMethodError. 


See Also 

Reference 
NoSuchMethodError Class 
Concepts 

NoSuchMethodError Members 
java.lang Package 
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NoSuchMethodError Methods 


Public Methods 





Name 


Description 





<exceptFilter> 


Maps an error object to a NoSuchMethodError object. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 


Protected Methods 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


NoSuchMethodError Class 


Concepts 
java.lang Package 
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NoSuchMethodError Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
NoSuchMethodError Class 
Concepts 

java.lang Package 
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NoSuchMethodException Class 


An exception thrown when an application tries to access a method that doesn't exist in the class. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java. lang.NoSuchMethodException 
extends java.lang.Exception 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.lang.NoSuchMethodException 


See Also 

Concepts 

NoSuchMethodException Members 
java.lang Package 
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NoSuchMethodException Members 


An exception thrown when an application tries to access a method that doesn't exist in the class. 


The following tables list the members exposed by the NoSuchMethodException type. 


Public Constructors 





Name 


Description 





NoSuchMethodException 


Overloaded. Constructs a NoSuchMethodException object. 





Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 





Description 


(inherited from Exception ) 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 








printStackTrace 





getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 

clone (inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 








toString (inherited from Throwable ) 





Protected Methods 
Name 


finalize (inherited from Object ) 








See Also 

Reference 
NoSuchMethodException Class 
Concepts 

java.lang Package 
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NoSuchMethodException Constructor 


Constructs a NoSuchMethodException object. 


Overload List 
Name Description 


NoSuchMethodException () Constructs a NoSuchMethodException object without a specifie 
d text message.. 





NoSuchMethodException (String) Constructs a NoSuchMethodException object with a specified t 
ext message. 


NoSuchMethodException (Serialization|Info, StreamingContext)|Constructs a NoSuchMethodException object during serializati 
on. 


NoSuchMethodException (String, Exception) Constructs a NoSuchMethodException object with a specified 
message and an inner exception. 








See Also 

Reference 
NoSuchMethodException Class 
Concepts 

NoSuchMethodException Members 
java.lang Package 
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NoSuchMethodException Constructor () 


Constructs a NoSuchMethodException object without a specified text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.NoSuchMethodException() ; 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
NoSuchMethodException Class 
Concepts 

NoSuchMethodException Members 
java.lang Package 
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NoSuchMethodException Constructor (String) 


Constructs a NoSuchMethodException object with a specified text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.NoSuchMethodException( 
java.lang.String s); 


Parameters 
Ss 


The string that contains the exception text. 


See Also 

Reference 
NoSuchMethodException Class 
Concepts 

NoSuchMethodException Members 
java.lang Package 
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NoSuchMethodException Constructor (Serialization|nfo, 
StreamingContext) 


Constructs a NoSuchMethodException object during serialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java. lang.NoSuchMethodException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information required for serializing an object. 
context 
The source or destination for the serialization. 


See Also 

Reference 
NoSuchMethodException Class 
Concepts 

NoSuchMethodException Members 
java.lang Package 
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NoSuchMethodException Constructor (String, Exception) 


Constructs a NoSuchMethodException object with a specified message and an inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.NoSuchMethodException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


The string that contains the message text. 
inner 
The inner exception that led to the NoSuchMethodException. 


See Also 

Reference 
NoSuchMethodException Class 
Concepts 

NoSuchMethodException Members 
java.lang Package 
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NoSuchMethodException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


NoSuchMethodException Class 


Concepts 
java.lang Package 
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NoSuchMethodException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 


NoSuchMethodException Class 


Concepts 
java.lang Package 
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NullPointerException Class 


An exception thrown when you try to use a null value where an object should be used. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.NullPointerException 
extends java. lang.RuntimeException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.lang.RuntimeException 
java.lang.NullPointerException 


See Also 

Concepts 

NullPointerException Members 
java.lang Package 
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NullPointerException Members 


An exception thrown when you try to use a null value where an object should be used. 


The following tables list the members exposed by the NullPointerException type. 


Public Constructors 





Name 


Description 





NullPointerException 


Overloaded. Constructs a NullPointerException object. 





Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 





Description 


(inherited from Exception ) 





Name 


Description 





<exceptFilter> 


Maps an exception object to a NullPointerException object. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 





getMessage 


GetObjectData 


getClass 


clone 








(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 








printStackTrace Overloaded. (inherited from Throwable ) 








toString (inherited from Throwable ) 


Protected Methods 





Name Description 





finalize (inherited from Object ) 














See Also 

Reference 
NullPointerException Class 
Concepts 

java.lang Package 
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NullPointerException Constructor 


Constructs a NullPointerException object. 


Overload List 





Name Description 

NullPointerException () Constructs a NullPointerException object without a specified text m 
essage. 

NullPointerException (String) Constructs a NullPointerException object with a specified text mess 
age. 


NullPointerException (SerializationInfo, StreamingContext)|Constructs a NullPointerException object during serialization. 


NullPointerException (String, Exception) Constructs a NullPointerException object with a specified text mess 
age and inner exception. 





See Also 

Reference 
NullPointerException Class 
Concepts 

NullPointerException Members 
java.lang Package 
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NullPointerException Constructor () 


Constructs a NullPointerException object without a specified text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.NullPointerException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
NullPointerException Class 
Concepts 

NullPointerException Members 
java.lang Package 
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NullPointerException Constructor (String) 


Constructs a NullPointerException object with a specified text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.NullPointerException( 
java.lang.String s); 


Parameters 
Ss 


The string that contains the message text. 


See Also 

Reference 
NullPointerException Class 
Concepts 

NullPointerException Members 
java.lang Package 
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NullPointerException Constructor (SerializationInfo, 
StreamingContext) 


Constructs a NullPointerException object during serialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java.lang.NullPointerException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information required for serializing an object. 
context 
The source or destination for the serialization. 


See Also 

Reference 
NullPointerException Class 
Concepts 

NullPointerException Members 
java.lang Package 
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NullPointerException Constructor (String, Exception) 


Constructs a NullPointerException object with a specified text message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.NullPointerException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


The string that contains the message text. 
inner 
The inner exception that led to NullPointerException. 


See Also 

Reference 
NullPointerException Class 
Concepts 

NullPointerException Members 
java.lang Package 
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NullPointerException Methods 


Public Methods 





Name 


Description 





<exceptFilter> 


Maps an exception object to a NullPointerException object. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 


Protected Methods 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 




















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


NullPointerException Class 


Concepts 
java.lang Package 
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NullPointerException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
NullPointerException Class 
Concepts 

java.lang Package 
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Number Class 


An abstract class extended by all classes that represent numeric primitive types such as Byte, Short, Integer, Long, Float, and 
Double. The class contains abstract methods that convert the object value to any of the other numeric types. All these methods 
are overridden by the numeric subclasses. It also contains methods to convert numeric types to strings and vise versa. 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public abstract class java.lang.Number 
extends java.lang.Object 
implements java.io.Serializable 


Example 





See examples on classes: Byte, Short, Integer, Long, Float, and Double. 











Inheritance Hierarchy 
java.lang.Object 
java.lang.Number 
Derived Classes 


See Also 
Concepts 
Number Members 
java.lang Package 
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Number Members 


An abstract class extended by all classes that represent numeric primitive types such as Byte, Short, Integer, Long, Float, and 
Double. The class contains abstract methods that convert the object value to any of the other numeric types. All these methods 
are overridden by the numeric subclasses. It also contains methods to convert numeric types to strings and vise versa. 


The following tables list the members exposed by the Number type. 


Public Constructors 






























































Name Description 

Number Constructs a new object. 
Public Methods 

Name Description 

byteValue Returns the value of a specified object as a byte. 
doubleValue Returns the value of a specified object as a double. 
equals (inherited from Object ) 

floatValue Returns the value of a specified object as a float. 
hashCode (inherited from Object ) 

getClass (inherited from Object ) 

intValue Returns the value of a specified object as an int. 
longValue Returns the value of a specified object as a long. 
clone 

shortValue Returns the value of a specified object as a short. 
toString Overridden. Returns the string representation of the numeric value of the object. 
Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 

Number Class 

Concepts 


java.lang Package 
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Number Constructor 


Constructs a new object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.Number(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 
Reference 
Number Class 
Concepts 

Number Members 
java.lang Package 
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Number Methods 


Public Methods 












































Name Description 

byteValue Returns the value of a specified object as a byte. 
doubleValue Returns the value of a specified object as a double. 
equals (inherited from Object ) 

floatValue Returns the value of a specified object as a float. 
hashCode (inherited from Object ) 

getClass (inherited from Object ) 

intValue Returns the value of a specified object as an int. 
longValue Returns the value of a specified object as a long. 
clone 

shortValue Returns the value of a specified object as a short. 
toString Overridden. Returns the string representation of the numeric value of the object. 
Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 

Number Class 

Concepts 


java.lang Package 
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Number.byteValue Method 


Returns the value of a specified object as a byte. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public byte byteValue(); 





Return Value 
The value of the specified object as a byte. 
Example 


See also examples on classes: Byte, Short, Integer, Long, Float, and Double. 








// n-byteval1.jsl 
// Number.byteValue example 
public class MyClass 
{ 
public static void main(String[] args) 
if 
Number n = new Double(123.4); 
System.out.printin(n.byteValue()); 
} 
; 
/* 
Output 
123 
ays 
Remarks 


The conversion might involve rounding or truncation. 


See Also 
Reference 
Number Class 
Concepts 

Number Members 
java.lang Package 
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Number.clone Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





Example 
See examples on classes: Byte, Short, Integer, Long, Float, and Double. 


See Also 
Reference 
Number Class 
Concepts 

Number Members 
java.lang Package 
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Number.doubleValue Method 


Returns the value of a specified object as a double. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public abstract double doubleValue(); 


Return Value 

The value of the specified object as a double. 

Example 

See examples on classes: Byte, Short, Integer, Long, Float, and Double. 
Remarks 

The conversion might involve rounding. 


See Also 
Reference 
Number Class 
Concepts 

Number Members 
java.lang Package 
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Number.floatValue Method 


Returns the value of a specified object as a float. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public abstract float floatValue(); 





Return Value 

The value of the specified object as a float. 

Example 

See examples on classes: Byte, Short, Integer, Long, Float, and Double. 
Remarks 

The conversion might involve rounding. 


See Also 
Reference 
Number Class 
Concepts 

Number Members 
java.lang Package 
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Number.intValue Method 


Returns the value of a specified object as an int. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public abstract int intValue(); 





Return Value 

The value of the specified object as an int. 

Example 

See examples on classes: Byte, Short, Integer, Long, Float, and Double. 
Remarks 

The conversion might involve rounding or truncation. 


See Also 
Reference 
Number Class 
Concepts 

Number Members 
java.lang Package 
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Number.longValue Method 


Returns the value of a specified object as a long. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public abstract long longValue(); 





Return Value 

The value of the specified object as a long. 

Example 

See examples on classes: Byte, Short, Integer, Long, Float, and Double. 
Remarks 

The conversion might involve rounding or truncation. 


See Also 
Reference 
Number Class 
Concepts 

Number Members 
java.lang Package 
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Number.shortValue Method 


Returns the value of a specified object as a short. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public short shortValue(); 





Return Value 

The value of the specified object as a short. 

Example 

See examples on classes: Byte, Short, Integer, Long, Float, and Double. 
Remarks 

The conversion might involve rounding or truncation. 


See Also 
Reference 
Number Class 
Concepts 

Number Members 
java.lang Package 
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Number.toString Method 


Returns the string representation of the numeric value of the object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





Return Value 

The string representation of the numeric value of the object. 

Example 

See examples on classes: Byte, Short, Integer, Long, Float, and Double. 


See Also 
Reference 
Number Class 
Concepts 

Number Members 
java.lang Package 
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NumberFormatException Class 


An exception thrown when an invalid number format is encountered. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.NumberFormatException 
extends java.lang.IllegalArgumentException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.lang.RuntimeException 
java.lang.lllegalArgumentException 
java.lang.NumberFormatException 


See Also 

Concepts 

NumberFormatException Members 
java.lang Package 
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NumberFormatException Members 


An exception thrown when an invalid number format is encountered. 


The following tables list the members exposed by the NumberFormatException type. 


Public Constructors 





Name 


Description 





NumberFormatException 


Overloaded. Constructs a NumberFormatException object. 








Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 





Description 


(inherited from Exception ) 





Name 


Description 





<exceptFilter> 


Maps an exception to a NumberFormatException object. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 





getMessage 


GetObjectData 


getClass 


clone 





(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 











printStackTrace 


Overloaded. (inherited from Throwable ) 





toString 


Protected Methods 





(inherited from Throwable ) 





Name 


Description 





finalize 








(inherited from Object ) 





See Also 
Reference 


NumberFormatException Class 


Concepts 
java.lang Package 
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NumberFormatException Constructor 


Constructs a NumberFormatException object. 


Overload List 
Name 


NumberFormatException () 


Description 


Constructs a NumberFormatException object without a text me 
ssage. 





NumberFormatException (String) 


NumberFormatException (SerializationInfo, StreamingContext) 


NumberFormatException (String, Exception) 





Constructs an instance of a NumberFormatException object wit 


h a text message. 


Constructs a NumberFormatException object during serializati 
on. 


Constructs a NumberFormatException object with a text messa 
ge and inner exception. 








See Also 

Reference 
NumberFormatException Class 
Concepts 

NumberFormatException Members 
java.lang Package 
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NumberFormatException Constructor () 


Constructs a NumberFormatException object without a text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.NumberFormatException() ; 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
NumberFormatException Class 
Concepts 

NumberFormatException Members 
java.lang Package 
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NumberFormatException Constructor (String) 


Constructs an instance of a NumberFormatException object with a text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.NumberFormatException( 
java.lang.String s); 


Parameters 
Ss 


The string that contains the message text. 


See Also 

Reference 
NumberFormatException Class 
Concepts 

NumberFormatException Members 
java.lang Package 
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NumberFormatException Constructor (SerializationInfo, 
StreamingContext) 


Constructs a NumberFormatException object during serialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java. lang.NumberFormatException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information required for serializing an object. 
context 
The source or destination for the serialization. 


See Also 

Reference 
NumberFormatException Class 
Concepts 

NumberFormatException Members 
java.lang Package 
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NumberFormatException Constructor (String, Exception) 


Constructs a NumberFormatException object with a text message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.NumberFormatException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


The string that contains the message text. 
inner 
The inner exception that led to NumberFormatException. 


See Also 

Reference 
NumberFormatException Class 
Concepts 

NumberFormatException Members 
java.lang Package 
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NumberFormatException Methods 


Public Methods 





Name 


Description 





<exceptFilter> 


Maps an exception to a NumberFormatException object. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 


Protected Methods 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 




















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


NumberFormatException Class 


Concepts 
java.lang Package 
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NumberFormatException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 


NumberFormatException Class 


Concepts 
java.lang Package 
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OutOfMemoryError Class 


An error that occurs when your application runs out of memory. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.OutOfMemoryError 
extends java.lang.VirtualMachineError 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Error 
java.lang.VirtualMachineError 
java.lang.OutOfMemoryError 
com.ms.com.ComError 


See Also 

Concepts 

OutOfMemoryError Members 
java.lang Package 
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OutOfMemoryError Members 


An error that occurs when your application runs out of memory. 


The following tables list the members exposed by the OutOfMemoryError type. 


Public Constructors 





Name 


Description 





OutOfMemoryError 


Overloaded. Constructs a OutOfMemoryError object. 





Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 





Description 


(inherited from Exception ) 





Name 


Description 





<exceptFilter> 


Maps an error object to a OutOfMemoryError object. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 





getMessage 


GetObjectData 


getClass 


clone 








(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 








printStackTrace 


Overloaded. (inherited from Throwable ) 





toString 


Protected Methods 





(inherited from Throwable ) 





Name 


Description 





finalize 








(inherited from Object ) 





See Also 

Reference 
OutOfMemoryError Class 
Concepts 

java.lang Package 
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OutOfMemoryError Constructor 


Constructs a OutOfMemoryError object. 


Overload List 


Name Description 
OutOfMemoryError () Constructs a OutOfMemoryError object without a text message. 
OutOfMemoryError (String) Constructs a OutOfMemoryError object with a text message. 


OutOfMemoryError (Serialization|Info, StreamingContext)|Constructs a OutOfMemoryError object during serialization. 


OutOfMemoryError (String, Exception) Constructs a OutOfMemoryeError object with a text message and inn 
er exception. 





See Also 
Reference 


OutOfMemoryError Class 
Concepts 

OutOfMemoryError Members 
java.lang Package 
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OutOfMemoryError Constructor () 


Constructs a OutOfMemoryError object without a text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.OutOfMemoryError(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
OutOfMemoryeError Class 
Concepts 

OutOfMemoryError Members 
java.lang Package 
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OutOfMemoryError Constructor (String) 


Constructs a OutOfMemoryError object with a text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.OutOfMemoryError( 
java.lang.String s); 


Parameters 
Ss 


The string that contains the message text. 


See Also 

Reference 
OutOfMemoryeError Class 
Concepts 

OutOfMemoryError Members 
java.lang Package 
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OutOfMemoryError Constructor (SerializationInfo, 
StreamingContext) 


Constructs a OutOfMemoryError object during serialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java.lang.OutOfMemoryError( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information required for serializing an object. 
context 
The source or destination for the serialization. 


See Also 

Reference 
OutOfMemoryError Class 
Concepts 

OutOfMemoryError Members 
java.lang Package 
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OutOfMemoryError Constructor (String, Exception) 


Constructs a OutOfMemoryError object with a text message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.OutOfMemoryError( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


The string that contains the message text. 
inner 
The inner exception that led to OutOfMemoryError. 


See Also 

Reference 
OutOfMemoryeError Class 
Concepts 

OutOfMemoryError Members 
java.lang Package 
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OutOfMemoryError Methods 


Public Methods 





Name 


Description 





<exceptFilter> 


Maps an error object to a OutOfMemoryError object. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 


Protected Methods 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 




















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


OutOfMemoryError Class 


Concepts 
java.lang Package 
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OutOfMemoryError Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
OutOfMemoryError Class 
Concepts 

java.lang Package 
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Process Class 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public abstract class java.lang.Process 
extends java.lang.Object 





Inheritance Hierarchy 
java.lang.Object 
java.lang.Process 


See Also 
Concepts 
Process Members 
java.lang Package 
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Process Members 


The following tables list the members exposed by the Process type. 


Public Constructors 


Name 


Process 


Public Methods 


Description 








Name 


Description 








getinputStream 


getOutputStream 


getClass 


clone 


toString 


waitFor 


Protected Methods 


destroy 

equals (inherited from Object ) 
exitValue 

getErrorStream 

hashCode (inherited from Object ) 


(inherited from Object ) 


Overridden. 





Name 


Description 





finalize 








(inherited from Object ) 





See Also 
Reference 
Process Class 
Concepts 
java.lang Package 
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Process Constructor 


Initializes a new instance of the Process Class . 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.Process(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 
Reference 
Process Class 
Concepts 

Process Members 
java.lang Package 
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Process Methods 


Public Methods 





Name 


Description 

















getInputStream 


getOutputStream 


getClass 


clone 


toString 


waitFor 





Protected Methods 


destroy 

equals (inherited from Object ) 
exitValue 

getErrorStream 

hashCode (inherited from Object ) 


(inherited from Object ) 


Overridden. 





Name 


Description 





finalize 








(inherited from Object ) 





See Also 
Reference 
Process Class 
Concepts 
java.lang Package 
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Process.clone Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





See Also 
Reference 
Process Class 
Concepts 

Process Members 
java.lang Package 
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Process.destroy Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public abstract void destroy(); 





See Also 
Reference 
Process Class 
Concepts 

Process Members 
java.lang Package 
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Process.exitValue Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public abstract int exitValue(); 


See Also 
Reference 
Process Class 
Concepts 

Process Members 
java.lang Package 
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Process.getErrorStream Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public abstract java.io.InputStream getErrorStream() ; 


See Also 
Reference 
Process Class 
Concepts 

Process Members 
java.lang Package 
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Process.getInputStream Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public abstract java.io.InputStream getInputStream() ; 


See Also 
Reference 
Process Class 
Concepts 

Process Members 
java.lang Package 
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Process.getOutputStream Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public abstract java.io.OutputStream getOutputStream() ; 


See Also 
Reference 
Process Class 
Concepts 

Process Members 
java.lang Package 
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Process.toString Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





See Also 
Reference 
Process Class 
Concepts 

Process Members 
java.lang Package 
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Process.waitFor Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public abstract int waitFor() throws java.lang.InterruptedException; 


See Also 
Reference 
Process Class 
Concepts 

Process Members 
java.lang Package 
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Runnable Interface 


An interface that abstracts an object that executes code when it is active such as a thread. A class that implements Runnable 
can run without inheriting the Thread class. 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public interface java.lang.Runnable 








See Also 

Concepts 

Runnable Members 
java.lang Package 
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Runnable Members 


An interface that abstracts an object that executes code when it is active such as a thread. A class that implements Runnable 
can run without inheriting the Thread class. 


The following tables list the members exposed by the Runnable type. 


Public Methods 
Na |Description 
me 





run |An object implementing Runnable must define the run method. When the object is used to create a thread the method is 
called and executed in a separate thread. 





See Also 
Reference 
Runnable Interface 
Concepts 

java.lang Package 
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Runnable Methods 


Public Methods 


Na |Description 





run |An object implementing Runnable must define the run method. When the object is used to create a thread the method is 
called and executed in a separate thread. 











See Also 
Reference 
Runnable Interface 
Concepts 

java.lang Package 
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Runnable.run Method 


An object implementing Runnable must define the run method. When the object is used to create a thread the method is called 
and executed in a separate thread. 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public abstract void run(); 


Example 


In this example, MyClass implements the Runnable interface and defines the run method. In main(), two threads are started. 
Each one displays a massage and then sleeps for 2 milliseconds. 


When you run the program, it keeps printing "Hi..." and "Bye!" until you terminate the program execution. 


// Runnable.run example 


public class MyClass implements Runnable 


{ 
String myString; 
int delayTime; 
MyClass(String myString, int delayTime) 
{ 
this.myString = myString; 
this.delayTime = delayTime; 
} 
public void run() 
{ 
try 
for (33) 
1 
System.out.println(myString) ; 
Thread.sleep(delayTime) ; 
} 
} 
catch (InterruptedException e) 
{ 
Tf sees 
} 
} 
public static void main(String[] args) 
{ 
Runnable proci = new MyClass("Hi... ",2);3 
Runnable proc2 = new MyClass("Bye! ",2); 
new Thread(proci, "threadi").start(); 
new Thread(proc2, "thread2").start(); 
} 
} 
See Also 
Reference 
Runnable Interface 
Concepts 


Runnable Members 
java.lang Package 
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Runtime Class (J#) 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public class java.lang.Runtime 
extends java.lang.Object 





Inheritance Hierarchy 
java.lang.Object 
java.lang.Runtime 


See Also 

Concepts 

Runtime Members 
java.lang Package 
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Runtime Members 


The following tables list the members exposed by the Runtime type. 


Public Methods 





Name Description 

equals (inherited from Object ) 
exec Overloaded. 

exit 

gc 

hashCode (inherited from Object ) 





getLocalizedinputStream 





getLocalizedOutputStream 





getRuntime 





getClass 


(inherited from Object ) 





loadLibrary 





clone 





runFinalization 





runfinalizersOnExit 





toString 


Overridden. 





Protected Methods 
Name 


finalize 





See Also 
Reference 
Runtime Class 
Concepts 
java.lang Package 





(inherited from Object ) 
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Runtime Methods 


Public Methods 




















getLocalizedinputStream 


getLocalizedOutputStream 


getRuntime 


getClass 


loadLibrary 


clone 


runFinalization 


runfinalizersOnExit 


toString 


Protected Methods 


Name Description 

equals (inherited from Object ) 
exec Overloaded. 

exit 

gc 

hashCode (inherited from Object ) 


(inherited from Object ) 


Overridden. 





Name 


Description 





finalize 








(inherited from Object ) 





See Also 
Reference 
Runtime Class 
Concepts 
java.lang Package 
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Runtime.clone Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





See Also 
Reference 
Runtime Class 
Concepts 

Runtime Members 
java.lang Package 
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Runtime.exec Method 


Overload List 





Name 


Description 





Runtime.exec (String) 





Runtime.exec (String[]) 





Runtime.exec (String, String[]) 





Runtime.exec (String[], String[]) 








See Also 
Reference 
Runtime Class 
Concepts 

Runtime Members 
java.lang Package 
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Runtime.exec Method (String) 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Process exec( 
java.lang.String command) throws java.io. IOException; 


Parameters 
command 


See Also 
Reference 
Runtime Class 
Concepts 

Runtime Members 
java.lang Package 
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Runtime.exec Method (String[ ]) 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Process exec( 
java.lang.String[] cmd) throws java.io. IOException; 


Parameters 
cmd 


See Also 
Reference 
Runtime Class 
Concepts 

Runtime Members 
java.lang Package 
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Runtime.exec Method (String, String[ ]) 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Process exec( 
java.lang.String command, 
java.lang.String[] envp) throws java.io. IOException; 


Parameters 
command 


envp 


See Also 
Reference 
Runtime Class 
Concepts 

Runtime Members 
java.lang Package 
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Runtime.exec Method (String|[ ], String[ ]) 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Process exec( 
java.lang.String[] cmd, 
java.lang.String[] envp) throws java.io. IOException; 


Parameters 
cmd 


envp 


See Also 
Reference 
Runtime Class 
Concepts 

Runtime Members 
java.lang Package 


Visual J# Reference 


Runtime.exit Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public void exit( 


int status); 





Parameters 
status 


See Also 
Reference 
Runtime Class 
Concepts 

Runtime Members 
java.lang Package 


Visual J# Reference 


Runtime.gc Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public void gc(); 





See Also 
Reference 
Runtime Class 
Concepts 

Runtime Members 
java.lang Package 
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Runtime.getLocalizedinputStream Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.io.InputStream getLocalizedInputStream( 
java.io.InputStream in); 


Parameters 
in 


See Also 
Reference 
Runtime Class 
Concepts 

Runtime Members 
java.lang Package 


Visual J# Reference 


Runtime.getLocalizedOutputStream Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.io.OutputStream getLocalizedOutputStream( 
java.io.OutputStream out); 


Parameters 
out 


See Also 
Reference 
Runtime Class 
Concepts 

Runtime Members 
java.lang Package 
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Runtime.getRuntime Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.Runtime getRuntime(); 


See Also 
Reference 
Runtime Class 
Concepts 

Runtime Members 
java.lang Package 
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Runtime.loadLibrary Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public synchronized void loadLibrary( 
java.lang.String libname) ; 


Parameters 
libname 


See Also 
Reference 
Runtime Class 
Concepts 

Runtime Members 
java.lang Package 
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Runtime.runFinalization Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public void runFinalization(); 


See Also 
Reference 
Runtime Class 
Concepts 

Runtime Members 
java.lang Package 
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Runtime.runfinalizersOnExit Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static void runFinalizersOnExit( 
boolean on); 


Parameters 
on 


See Also 
Reference 
Runtime Class 
Concepts 

Runtime Members 
java.lang Package 
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Runtime.toString Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





See Also 
Reference 
Runtime Class 
Concepts 

Runtime Members 
java.lang Package 
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RuntimeException Class 


An exception thrown to indicate that a runtime error has occurred. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.RuntimeException 
extends java.lang.Exception 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.lang.RuntimeException 
Derived Classes 


See Also 

Concepts 

RuntimeException Members 
java.lang Package 
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RuntimeException Members 


An exception thrown to indicate that a runtime error has occurred. 


The following tables list the members exposed by the RuntimeException type. 


Public Constructors 





Name Description 





RuntimeException Overloaded. Constructs a RuntimeException object. 





Public Properties 




















Name Description 

HelpLink (inherited from Exception ) 
InnerException (inherited from Exception ) 
Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 


Name Description 


HResult (inherited from Exception ) 





Public Methods 


























Name Description 

equals (inherited from Object ) 
filllnStackTrace (inherited from Throwable ) 
GetBaseException (inherited from Exception ) 
hashCode (inherited from Object ) 
getLocalizedMessage (inherited from Throwable ) 
getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 
clone (inherited from Throwable ) 


printStackTrace Overloaded. (inherited from Throwable ) 











toString 


(inherited from Throwable ) 





Protected Methods 
Name 


finalize 





See Also 

Reference 
RuntimeException Class 
Concepts 

java.lang Package 





(inherited from Object ) 
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RuntimeException Constructor 


Constructs a RuntimeException object. 


Overload List 








Name Description 

RuntimeException () Constructs a RuntimeException object without a specified text messag 
e. 

RuntimeException (String) Constructs a RuntimeException object with a specified text message. 





RuntimeException (Serialization|Info, StreamingContext)|Constructs a RuntimeException object during serialization. 





RuntimeException (String, Exception) Constructs a RuntimeException object with a specific text message and 
inner exception. 








See Also 

Reference 
RuntimeException Class 
Concepts 

RuntimeException Members 
java.lang Package 





Visual J# Reference 


RuntimeException Constructor () 


Constructs a RuntimeException object without a specified text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.RuntimeException() ; 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
RuntimeException Class 
Concepts 

RuntimeException Members 
java.lang Package 
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RuntimeException Constructor (String) 


Constructs a RuntimeException object with a specified text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.RuntimeException( 
java.lang.String s); 


Parameters 
Ss 


The string that contains the message text. 


See Also 

Reference 
RuntimeException Class 
Concepts 

RuntimeException Members 
java.lang Package 
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RuntimeException Constructor (SerializationInfo, 
StreamingContext) 


Constructs a RuntimeException object during serialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java. lang.RuntimeException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information required for serializing an object. 
context 
The source or destination for the serialization. 


See Also 

Reference 
RuntimeException Class 
Concepts 

RuntimeException Members 
java.lang Package 
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RuntimeException Constructor (String, Exception) 


Constructs a RuntimeException object with a specific text message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.RuntimeException( 
java.lang.String msg, 
System.Exception innerEx) ; 


Parameters 
msg 


The string that contains the message text. 
innerEx 
The inner exception that led to RuntimeException. 


See Also 

Reference 
RuntimeException Class 
Concepts 

RuntimeException Members 
java.lang Package 
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RuntimeException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


RuntimeException Class 


Concepts 
java.lang Package 
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RuntimeException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
RuntimeException Class 
Concepts 

java.lang Package 
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SecurityException Class 


An exception thrown when a security error occurs. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.SecurityException 
extends java. lang.RuntimeException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.lang.RuntimeException 
java.lang.SecurityException 


See Also 

Concepts 

SecurityException Members 
java.lang Package 
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SecurityException Members 


An exception thrown when a security error occurs. 


The following tables list the members exposed by the SecurityException type. 


Public Constructors 





Name 


Description 





SecurityException 


Overloaded. Constructs a SecurityException object. 





Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 





Description 


(inherited from Exception ) 





Name 


Description 





<exceptFilter> 


Maps an exception object to a SecurityException object. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 





getMessage 


GetObjectData 


getClass 


clone 








(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 








printStackTrace 


Overloaded. (inherited from Throwable ) 





toString 


Protected Methods 





(inherited from Throwable ) 





Name 


Description 





finalize 








(inherited from Object ) 





See Also 

Reference 
SecurityException Class 
Concepts 

java.lang Package 
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SecurityException Constructor 


Constructs a SecurityException object. 


Overload List 


Name Description 
SecurityException () Constructs a SecurityException object without a specified text message. 
SecurityException (String) Constructs a SecurityException object with a specified text message. 


SecurityException (SerializationInfo, StreamingContext)|Constructs a SecurityException object during serialization. 


SecurityException (String, Exception) Constructs a SecurityException object with a specific text message and 
inner exception. 








See Also 

Reference 
SecurityException Class 
Concepts 

SecurityException Members 
java.lang Package 
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SecurityException Constructor () 


Constructs a SecurityException object without a specified text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.SecurityException(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
SecurityException Class 
Concepts 

SecurityException Members 
java.lang Package 
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SecurityException Constructor (String) 


Constructs a SecurityException object with a specified text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.SecurityException( 
java.lang.String s); 


Parameters 
Ss 


The string that contains the message text. 


See Also 

Reference 
SecurityException Class 
Concepts 

SecurityException Members 
java.lang Package 
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SecurityException Constructor (SerializationInfo, 
StreamingContext) 


Constructs a SecurityException object during serialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java.lang.SecurityException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information required for serializing an object. 
context 
The source or destination for the serialization. 


See Also 

Reference 
SecurityException Class 
Concepts 

SecurityException Members 
java.lang Package 


Visual J# Reference 


SecurityException Constructor (String, Exception) 


Constructs a SecurityException object with a specific text message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.SecurityException( 
java.lang.String msg, 
System.Exception innerEx) ; 


Parameters 
msg 


The string that contains the message text. 
innerEx 
The inner exception that led to SecurityException. 


See Also 

Reference 
SecurityException Class 
Concepts 

SecurityException Members 
java.lang Package 
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SecurityException Methods 


Public Methods 





Name 


Description 





<exceptFilter> 


Maps an exception object to a SecurityException object. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 


Protected Methods 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 




















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


SecurityException Class 


Concepts 
java.lang Package 
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SecurityException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
SecurityException Class 
Concepts 

java.lang Package 
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Short Class 


Wraps the primitive type short into an object. The class also contains methods for conversion and processing Short objects. 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public final class java.lang.Short 
extends java.lang.Number 
implements System.IConvertible, java.lang.Comparable 





Remarks 


This class implements |Convertible. 
Inheritance Hierarchy 
java.lang.Object 
java.lang.Number 
java.lang.Short 


See Also 
Concepts 

Short Members 
java.lang Package 
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Short Members 


Wraps the primitive type short into an object. The class also contains methods for conversion and processing Short objects. 


The following tables list the members exposed by the Short type. 


Public Constructors 






































Name Description 

Short Overloaded. 

Public Fields 

Name Description 

MAX_VALUE A constant that stores the maximum value a short can have. 
MIN_VALUE A constant that stores the minimum value a short can have. 

TYPE A readonly value that represents the Class instance of the primitive type short. 
Public Methods 

Name Description 

byteValue Overridden. Returns the byte value stored in a Short object. 
compareTo Overloaded. 

decode Decodes a string parameter to a Short object. 

doubleValue Overridden. Returns the value of a Short object converted to double. 
equals Overridden. Compares the current Short object to another object. 
floatValue Overridden. Returns value of a Short object converted to float. 
hashCode Overridden. Returns the hash code of a Short object. 

getClass (inherited from Object) 

intValue Overridden. Returns the value of a Short object as an int. 
longValue Overridden. Returns the value of a Short object as a long number. 
clone (inherited from Number) 

parseShort Overloaded. 

shortValue Overridden. Returns the value of a Short object as a short number. 
ToBoolean 

ToByte 

ToChar 














ToDateTime 





ToDecimal 





ToDouble 





Tolnt16 





Tolnt32 





Tolnt64 





ToSByte 





ToSingle 


toString 


toString 


ToType 


ToUInt16 


ToUInt32 


ToUInt64 


valueOf 





See Also 
Reference 

Short Class 
Concepts 
java.lang Package 


Returns the string that represents a short value. 


Overloaded. Overridden. 


Overloaded. 
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Short Fields 


Public Fields 


























Name Description 

MAX_VALUE A constant that stores the maximum value a short can have. 

MIN_VALUE A constant that stores the minimum value a short can have. 

TYPE A readonly value that represents the Class instance of the primitive type short. 
See Also 

Reference 

Short Class 

Concepts 


java.lang Package 
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Short.MAX_VALUE Field 


A constant that stores the maximum value a short can have. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final short MAX_VALUE; 


Example OOOO 


// sh-MAX_VALUE.js1 
// Short MAX_VALUE example 


public class MyClass 


public static void main(String[] args) 


{ 
} 


System.out.print("MAX_VALUE = " + Short.MAX_VALUE) ; 


} 


/* 

Output: 

MAX_VALUE = 32767 
*/ 











Remarks 
The value of MAX_VALUE is 32767. 


See Also 
Reference 

Short Class 
Concepts 

Short Members 
java.lang Package 
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Short.MIN_VALUE Field 


A constant that stores the minimum value a short can have. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final short MIN_VALUE; 


Example OOOO 


// sh-MIN_VALUE.js1 
// Short MIN_VALUE example 


public class MyClass 


public static void main(String[] args) 


{ 
} 


System.out.print("MIN_VALUE = " + Short.MIN_VALUE) ; 


} 


/* 

Output: 

MIN_VALUE = -32768 
| 











Remarks 
The value of MIN_VALUE is -32768. 


See Also 
Reference 

Short Class 
Concepts 

Short Members 
java.lang Package 
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Short. TYPE Field 


A readonly value that represents the Class instance of the primitive type short. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final java.lang.Class TYPE; 


Example ——__________________cc____§t_§___, 


// sh-TYPE.jsl 
// Short.TYPE example 


public class MyClass 


public static void main(String[] args) 


{ 
} 


System.out.print("TYPE = " + Short.TYPE); 


} 


/* 

Output: 

TYPE = short 
yA 











See Also 
Reference 

Short Class 
Concepts 

Short Members 
java.lang Package 
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Short Constructor 


Overload List 





Name Description 





Short (short) | |Constructs a new Short object that represents a specified short value. 





Short (String) |Constructs a new Short object that represents the short value specified by a string parameter. 














See Also 
Reference 

Short Class 
Concepts 

Short Members 
java.lang Package 
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Short Constructor (Int16) 


Constructs a new Short object that represents a specified short value. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.Short( 
short value); 





Parameters 
value 


A short expression. 








Example 
// sh-ctor1.jsl 
// Short.#ctor example 
public class MyClass 
public static void main(String[] args) 
{ 
Short sh = new Short((short)123) ; 
System.out.print("The short value is: " + sh); 
} 
} 
/* 
Output: 
The short value is: 123 
a, 
See Also 
Reference 
Short Class 
Concepts 


Short Members 
java.lang Package 
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Short Constructor (String) 


Constructs a new Short object that represents the short value specified by a string parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.Short( 
java.lang.String str) throws java.lang.NumberFormatException; 





Parameters 
str 


A string expression. 








Example 
// sh-ctor2.jsl 
// Short.#ctor example 
public class MyClass 
public static void main(String[] args) 
{ 
Short sh = new Short("123"); 
System.out.print("The short value is: " + sh); 
} 
} 
/* 
Output: 
The short value is: 123 
= 
Remarks 


Throws NumberFormatException if the string could not be parsed to a short value. 


See Also 
Reference 

Short Class 
Concepts 

Short Members 
java.lang Package 





Visual J# Reference 


Short Methods 


Public Methods 



































Name Description 

byteValue Overridden. Returns the byte value stored in a Short object. 
compareTo Overloaded. 

decode Decodes a string parameter to a Short object. 

doubleValue Overridden. Returns the value of a Short object converted to double. 
equals Overridden. Compares the current Short object to another object. 
floatValue Overridden. Returns value of a Short object converted to float. 
hashCode Overridden. Returns the hash code of a Short object. 

getClass (inherited from Object) 

intValue Overridden. Returns the value of a Short object as an int. 
longValue Overridden. Returns the value of a Short object as a long number. 
clone (inherited from Number) 

parseShort Overloaded. 

shortValue Overridden. Returns the value of a Short object as a short number. 
ToBoolean 

ToByte 

ToChar 

ToDateTime 

ToDecimal 

ToDouble 

Tolnt16 

Tolnt32 

Tolnt64 

ToSByte 

ToSingle 











toString 


Returns the string that represents a short value. 





toString 


Overloaded. Overridden. 





ToType 





ToUInt16 





ToUInt32 





ToUInt64 





valueOf 





Overloaded. 





See Also 
Reference 

Short Class 
Concepts 
java.lang Package 
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Short.byteValue Method 


Returns the byte value stored in a Short object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public byte byteValue(); 





Return Value 


The byte value stored in the Short object. 


Example TE 








// sh-bVal1.jsl 
// Short.byteValue example 
public class MyClass 
{ 
public static void main(String[] args) 
Short sh = new Short("123"); 
System.out.print("The byte value is: " + sh.byteValue()); 
} 
} 
/* 
Output: 
The byte value is: 123 
=f 
See Also 
Reference 
Short Class 
Concepts 


Short Members 
java.lang Package 
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Short.compareTo Method 


Overload List 





Name Description 





Short.compareTo (Object) Compares the current Short object to another object. 





Short.compareTo (Short) Compares the current Short object to another Short object. 











See Also 
Reference 

Short Class 
Concepts 

Short Members 
java.lang Package 
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Short.compareTo Method (Object) 


Compares the current Short object to another object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public int compareTo( 
java.lang.Object obj); 





Parameters 


obj 
The object to compare to. 
Return Value 
If obj is a Short object, it behaves exactly like compareTo, in which case it returns: 
0 if the two objects are identical. 
-1 if obj is greater then the current object. 


1 if obj is less then the current object. 


Example 


See the example on compareTo. 





Remarks 
Throws.ClassCastException if obj is not of the type Short. 


See Also 
Reference 

Short Class 
Concepts 

Short Members 
java.lang Package 


Visual J# Reference 


Short.compareTo Method (Short) 


Compares the current Short object to another Short object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public int compareTo( 
java.lang.Short aShort); 


Parameters 
aShort 

The Short object to compare to. 
Return Value 


0 if the two objects are identical. 1 if the value of aShort is less than the value of the current object. -1 if the value of aShort is 
greater than the value of the current object. 


Example 


// sh-comp1.js1 
// Short.compareTo example 


public class MyClass 


{ 
public static void main(String[] args) 
. 
Short sh = new Short("123"); 
Short sh1 = new Short("124"); 
System.out.println( 
"The result is: " + sh.compareTo(sh)); // @ 
System.out.print1ln( 
"The result is: " + sh.compareTo(sh1)); // -1 
System.out.println( 
"The result is: " + shl.compareTo(sh)); // 1 
} 
i 
/* 
Output: 


The result is: @ 
The result is: -1 
The result is: 1 


xf 


See Also 
Reference 

Short Class 
Concepts 

Short Members 
java.lang Package 
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Short.decode Method 


Decodes a string parameter to a Short object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.Short decode( 
java.lang.String str) throws java.lang.NumberFormatException; 


Parameters 
str 
The string to be decoded. 
Return Value 
The Short object that contains the short value of str. 
Example 


// sh-decode1.jsl 
// Short.decode example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
String s = new String("@x27"); // Hexadecimal number 
Short sh = Short.decode(s); 
System.out.print("The decoded short is: " + sh); 
} 
} 
Phi 
Output: 
The decoded short is: 39 
oy 
Remarks 


The string parameter str might contain decimal, hexadecimal, or octal digits. 

Hexadecimal digits are preceded by "Ox", OX", or "#". 

Octal digits are preceded by zero (0). 

If the string cannot be parsed to a short value, the exception java.lang.NumberFormatException is thrown. 


See Also 
Reference 

Short Class 
Concepts 

Short Members 
java.lang Package 
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Short.doubleValue Method 


Returns the value of a Short object converted to double. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public double doubleValue() ; 


Return Value 
The value of the Short object converted to double. 
Example 


// sh-doubleVal1.jsl 
// Short.doubleValue example 


public class MyClass 


{ 
public static void main(String[] args) 
Short sh = new Short("123"); 
// Convert it to double and add it to another double number: 
double d = sh.doubleValue() + 321.4; 
System.out.print("The new double number is: " + d); 
} 
} 
/* 
Output: 
The new double number is: 444.4 
*/ 
See Also 
Reference 
Short Class 
Concepts 


Short Members 
java.lang Package 
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Short.equals Method 


Compares the current Short object to another object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public boolean equals( 
java.lang.Object obj); 


Parameters 
obj 
The object to compare to. 
Return Value 
true if the two objects are identical; false otherwise. 
Example 


// sh-equalsi.jsl 
// Short.Equals example 


public class MyClass 


{ 
public static void main(String[] args) 
Short sh1 = new Short("123"); 
Short sh2 = new Short("123"); 
System.out.print("The result is: " + sh1.Equals(sh2)); 
} 
} 
Phi 
Output: 
The result is: true 
oy 
See Also 
Reference 
Short Class 
Concepts 


Short Members 
java.lang Package 
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Short.floatValue Method 


Returns value of a Short object converted to float. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public float floatValue(); 





Return Value 


The value of the Short object converted to float. 


Example OO 








// sh-floatValue1.jsl 
// Short.floatValue example 
public class MyClass 
{ 
public static void main(String[] args) 
{ 
Short sh = new Short("123"); 
// Convert it to float and add it to another float number: 
float f = sh.floatValue() + 321.4F; 
System.out.print("The new float number is: " + f); 
} 
} 
/* 
Output: 
The new float number is: 444.4 
*/ 
See Also 
Reference 
Short Class 
Concepts 


Short Members 
java.lang Package 
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Short.hashCode Method 


Returns the hash code of a Short object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public int hashCode(); 





Return Value 


The hash code of the Short object. 


Example TE 











// sh-getHashi.jsl 
// Short.GetHashCode example 
public class MyClass 
{ 
public static void main(String[] args) 
Short sh = new Short("123"); 
int h = sh.GetHashCode(); 
System.out.print("The hash code is: " + h); 
} 
} 
/* 
Output: 
The hash code is: 123 
ef 
See Also 
Reference 
Short Class 
Concepts 


Short Members 
java.lang Package 


Visual J# Reference 


Short.intValue Method 


Returns the value of a dda946ea-2660-45de-922b-686e3f018370 object as an int. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public int intValue(); 





Return Value 


The value of the Short object as an int. 


Example TE 











// sh-intValue1.jsl 
// Short.intValue example 
public class MyClass 
{ 
public static void main(String[] args) 
Short sh = new Short("123"); 
// Convert it and add it to another int: 
int i = sh.intValue() + 321; 
System.out.print("The new int is: " + i); 
} 
} 
/* 
Output: 
The new int is: 444 
mf 
See Also 
Reference 
Short Class 
Concepts 


Short Members 
java.lang Package 


Visual J# Reference 


Short.longValue Method 


Returns the value of a Short object as a long number. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public long longValue(); 





Return Value 


The value of the Short object as a long number. 


Example 











// sh-longValue1.jsl 
// Short.longValue example 
public class MyClass 
{ 
public static void main(String[] args) 
Short sh = new Short("123"); 
// Convert it and add it to another long number: 
long 1 = sh.longValue() + 321L; 
System.out.print("The new long number is: " + 1); 
} 
} 
/* 
Output: 
The new long number is: 444 
mf 
See Also 
Reference 
Short Class 
Concepts 


Short Members 
java.lang Package 


Visual J# Reference 


Short.parseShort Method 


Overload List 





Name Description 





Short.parseShort (String) Returns the signed short value represented by a string parameter. 








Short.parseShort (String, int) |Returns the signed short value represented by a string parameter in the specified radix. 











See Also 
Reference 

Short Class 
Concepts 

Short Members 
java.lang Package 


Visual J# Reference 


Short.parseShort Method (String) 


Returns the signed short value represented by a string parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static short parseShort( 
java.lang.String str) throws java.lang.NumberFormatException; 


Parameters 
str 
The string to be parsed. 
Return Value 
The short value represented by str. 
Example 


// sh-parse1.jsl 
// Short.parseShort example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
String s = new String("-123"); 
short sh = Short.parseShort(s); 
System.out.print("The short number is: " + sh); 
} 
} 
Phi 
Output: 
The short number is: -123 
aA 
Remarks 


The string characters must all be decimal digits except the first character, which can be a minus sign (-). 
The returned value is a signed short in the decimal radix. 


If the string could not be parsed to a signed decimal short, the exception java.lang.NumberFormatException is thrown. 


See Also 
Reference 

Short Class 
Concepts 

Short Members 
java.lang Package 


Visual J# Reference 


Short.parseShort Method (String, Int32) 


Returns the signed short value represented by a string parameter in the specified radix. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static short parseShort( 
java.lang.String str, 
int radix) throws java.lang.NumberFormatException; 


Parameters 
str 
The string to be parsed. 
radix 
The radix used in parsing str. 
Return Value 
The signed short value represented by str in the specified radix. 
Example 


// sh-parse2.jsl 
// Short.parseShort example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
String s1 = new String("127"); // Decimal 
String s2 = new String("-7F"); // Hexadecimal 
short shi = Short.parseShort(s1, 10); 
short sh2 = Short.parseShort(s2,16); 
System.out.print("sh1 = " + sh1 + "\nsh2 = " + sh2); 
} 
} 
/* 
Output: 
sh1 = 127 
sh2 = -127 
m/f 
Remarks 


The string characters must all be digits in the specified radix except the first character, which can be a minus sign (-). 
The exception java.lang.NumberFormatException is generated if any of the following conditions occurred: 

The string parameter is null. 

The length of the string parameter is zero (""). 

If the value of the radix is not in the range Character.MIN_RADIX to Character. MAX_RADIX. 

The string does not represent a short value. 


If any of the characters in the string, except the first character, which can be a minus sign, is not a valid digit in the specified 
radix. 


See Also 


Reference 

Short Class 
Concepts 

Short Members 
java.lang Package 


Visual J# Reference 


Short.shortValue Method 


Returns the value of a Short object as a short number. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public short shortValue(); 





Return Value 


The value of the Short object as a short number. 


Example TE 











// sh-shvalue1.jsl 
// Short.shortValue example 
public class MyClass 
{ 
public static void main(String[] args) 
Short s = new Short("123"); 
short sh = s.shortValue(); 
System.out.print("The short value is: " + sh); 
} 
} 
/* 
Output: 
The short value is: 123 
ef 
See Also 
Reference 
Short Class 
Concepts 


Short Members 
java.lang Package 


Visual J# Reference 


Short.ToBoolean Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public boolean ToBoolean( 
System. IFormatProvider provider) ; 


Parameters 
provider 


See Also 
Reference 

Short Class 
Concepts 

Short Members 
java.lang Package 


Visual J# Reference 


Short.ToByte Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.Byte ToByte( 
System. IFormatProvider provider) ; 





Parameters 
provider 


See Also 
Reference 

Short Class 
Concepts 

Short Members 
java.lang Package 


Visual J# Reference 


Short.ToChar Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public char ToChar( 
System. IFormatProvider provider) ; 





Parameters 
provider 


Example 





See Also 
Reference 

Short Class 
Concepts 

Short Members 
java.lang Package 


Visual J# Reference 


Short.ToDateTime Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.DateTime ToDateTime( 
System. IFormatProvider provider) ; 





Parameters 
provider 


Example 





See Also 
Reference 

Short Class 
Concepts 

Short Members 
java.lang Package 


Visual J# Reference 


Short.ToDecimal Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.Decimal ToDecimal( 
System. IFormatProvider provider) ; 





Parameters 
provider 


Example 





See Also 
Reference 

Short Class 
Concepts 

Short Members 
java.lang Package 


Visual J# Reference 


Short. ToDouble Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public double ToDouble( 


System. IFormatProvider provider) ; 





Parameters 
provider 


Example 





See Also 
Reference 

Short Class 
Concepts 

Short Members 
java.lang Package 


Visual J# Reference 


Short.Tolnt16 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public short ToInt16( 


System. IFormatProvider provider) ; 





Parameters 
provider 


Example 





See Also 
Reference 

Short Class 
Concepts 

Short Members 
java.lang Package 


Visual J# Reference 


Short.Tolnt32 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public int ToInt32( 


System. IFormatProvider provider) ; 





Parameters 
provider 


Example 





See Also 
Reference 

Short Class 
Concepts 

Short Members 
java.lang Package 


Visual J# Reference 


Short.Tolnt64 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public long ToInt64( 


System.IFormatProvider provider) ; 





Parameters 
provider 


Example 





See Also 
Reference 

Short Class 
Concepts 

Short Members 
java.lang Package 


Visual J# Reference 


Short.ToSByte Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public byte ToSByte( 


System. IFormatProvider provider) ; 





Parameters 
provider 


Example 





See Also 
Reference 

Short Class 
Concepts 

Short Members 
java.lang Package 


Visual J# Reference 


Short.ToSingle Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public float ToSingle( 


System. IFormatProvider provider) ; 





Parameters 
provider 


Example 





See Also 
Reference 

Short Class 
Concepts 

Short Members 
java.lang Package 


Visual J# Reference 


Short.toString Method (J#) 


Returns the string that represents a short value. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.String toString( 
short sval); 


Parameters 
sval 
A short expression 
Return Value 
The string that represents the value of bval. 
Example 


// sh-toStr1.jsl 
// Short.toString example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
short sh = 127; 
String s = Short.toString(sh) ; 
System.out.print("The string is: " + s); 
} 
} 
/* 
The result is: 127 
*/ 
See Also 
Reference 
Short Class 
Concepts 


Short Members 
java.lang Package 


Visual J# Reference 


Short.toString Method 


Overload List 





Name 


Description 





Short.ToString () 


Returns the string that represents the value of a Short object. 








Short.ToString (lFormatProvider) 








See Also 
Reference 

Short Class 
Concepts 

Short Members 
java.lang Package 





Visual J# Reference 


Short.toString Method () 


Returns the string that represents the value of a Short object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.String toString(); 





Return Value 


The string that represents the value of the Short object. 


Example 











// sh-toStr2.jsl 
// Short.toString example 
public class MyClass 
{ 
public static void main(String[] args) 
ii 
Short sh = new Short("123"); 
// Converting to a string and catenating to another string: 
String s = "The string is: " + sh.toString(); 
System.out.print(s); 
} 
} 
/* 
The string is: 123 
e/ 
See Also 
Reference 
Short Class 
Concepts 


Short Members 
java.lang Package 


Visual J# Reference 


Short.toString Method (IFormatProvider) 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String ToString( 
System. IFormatProvider provider) ; 





Parameters 
provider 


Example 





See Also 
Reference 

Short Class 
Concepts 

Short Members 
java.lang Package 


Visual J# Reference 


Short.ToType Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.Object ToType( 
System.Type conversionType, 
System. IFormatProvider provider) ; 





Parameters 
conversionType 


provider 


Example 





See Also 
Reference 

Short Class 
Concepts 

Short Members 
java.lang Package 


Visual J# Reference 


Short. ToUInt16 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.UInt16 ToUInt16( 


System. IFormatProvider provider) ; 





Parameters 
provider 


Example 





See Also 
Reference 

Short Class 
Concepts 

Short Members 
java.lang Package 


Visual J# Reference 


Short.ToUInt32 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.UInt32 ToUInt32( 


System. IFormatProvider provider) ; 





Parameters 
provider 


Example 





See Also 
Reference 

Short Class 
Concepts 

Short Members 
java.lang Package 


Visual J# Reference 


Short.ToUInt64 Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public System.UInt64 ToUInt64( 


System. IFormatProvider provider) ; 





Parameters 
provider 


Example 





See Also 
Reference 

Short Class 
Concepts 

Short Members 
java.lang Package 


Visual J# Reference 


Short.valueOf Method 


Overload List 





Name Description 





Short.valueOf (String) Returns the Short object represented by a string parameter. 





Short.valueOf (String, int) Returns the Short object represented by a string parameter in the specified radix. 











See Also 
Reference 

Short Class 
Concepts 

Short Members 
java.lang Package 


Visual J# Reference 


Short.valueOf Method (String) 


Returns the Short object represented by a string parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.Short valueOf( 
java.lang.String str) throws java.lang.NumberFormatException; 


Parameters 
str 


The string to be parsed. 
Return Value 
The Short object represented by str. 
Example 


// sh-Val0f1.js1 
// Short.valueOf example 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
String s = new String("-128"); 
Short sh = Short.valueOf(s); 
System.out.print("The short value is: " + sh); 
} 
} 
Phi 
Output: 
The short value is: -128 
aA 
Remarks 


The string characters must all be decimal digits except the first character, which can be a minus sign (-). 
If the string could not be parsed to a signed decimal short, the exception java.lang.NumberFormatException is thrown. 


See Also 
Reference 

Short Class 
Concepts 

Short Members 
java.lang Package 


Visual J# Reference 


Short.valueOf Method (String, Int32) 


Returns the Short object represented by a string parameter in the specified radix. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.Short valueOf( 
java.lang.String str, 
int radix) throws java.lang.NumberFormatException; 


Parameters 
str 
The string to be parsed. 
radix 
The radix used in parsing str. 
Return Value 
The Short object represented by str in the specified radix. 
Example 


// sh-Val0f2.js1 
// Short.valueOf example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
String s = new String("-80"); 
Short sh = Short.valueOf(s,16); 
System.out.print("The short value is: " + sh); 
} 
} 
/* 
Output: 
The short value is: -128 
wf 
Remarks 


The string characters must all be digits in the specified radix except the first character, which can be a minus sign (-). 


The exception java.lang.NumberFormatException is generated if any of the following conditions occurred: 


The string parameter is null. 


The length of the string parameter is zero (""). 


If the value of the radix is not in the range Character.MIN_RADIX to Character. MAX_RADIX. 


The string does not represent a short value. 


If any of the characters in the string, except the first character, which can be a minus sign, is not a valid digit in the specified 


radix. 


See Also 
Reference 
Short Class 
Concepts 

Short Members 


java.lang Package 


Visual J# Reference 


StackOverflowError Class 


An error that is issued when a stack overflow occurs. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.StackOverflowError 
extends java.lang.VirtualMachineError 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Error 
java.lang.VirtualMachineError 
java.lang.StackOverflowError 


See Also 

Concepts 

StackOverflowError Members 
java.lang Package 


Visual J# Reference 


StackOverflowError Members 


An error that is issued when a stack overflow occurs. 


The following tables list the members exposed by the StackOverflowError type. 


Public Constructors 





Name Description 





StackOverflowError Overloaded. Constructs a StackOverflowError object. 








Public Properties (see also Protected Properties 


Name 


HelpLink 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 





Description 


(inherited from Exception ) 





Name 


Description 





<exceptFilter> 


Maps an error object to a StackOverflowError object. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 





getMessage 


GetObjectData 


getClass 


clone 





(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 








printStackTrace 


Overloaded. (inherited from Throwable ) 





toString 


Protected Methods 





(inherited from Throwable ) 





Name 


Description 





finalize 








(inherited from Object ) 








See Also 
Reference 


StackOverflowError Class 
Concepts 
java.lang Package 


Visual J# Reference 


StackOverflowError Constructor 


Constructs a StackOverflowError object. 


Overload List 
Name 


StackOverflowError () 


Description 


Constructs a StackOverflowError object without a specific text messa 
ge. 





StackOverflowError (String) 


Constructs a StackOverflowError object with a specific text message. 





StackOverflowError (SerializationInfo, StreamingContext) 


Constructs a StackOverflowError object during serialization. 





StackOverflowError (String, Exception) 








Constructs a StackOverflowError object with a specific text message 
and inner exception. 





See Also 

Reference 
StackOverflowError Class 
Concepts 

StackOverflowError Members 
java.lang Package 





Visual J# Reference 


StackOverflowError Constructor () 


Constructs a StackOverflowError object without a specific text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.StackOverflowError(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
StackOverflowError Class 
Concepts 

StackOverflowError Members 
java.lang Package 


Visual J# Reference 


StackOverflowError Constructor (String) 


Constructs a StackOverflowError object with a specific text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.StackOverflowError ( 
java.lang.String s); 


Parameters 
Ss 


The string that contains the message text. 


See Also 

Reference 
StackOverflowError Class 
Concepts 

StackOverflowError Members 
java.lang Package 


Visual J# Reference 


StackOverflowError Constructor (SerializationInfo, 
StreamingContext) 


Constructs a StackOverflowError object during serialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java. lang.StackOverflowError( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information required for serializing an object. 
context 
The source or destination for the serialization. 


See Also 

Reference 
StackOverflowError Class 
Concepts 

StackOverflowError Members 
java.lang Package 
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StackOverflowError Constructor (String, Exception) 


Constructs a StackOverflowError object with a specific text message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.StackOverflowError ( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


The string that contains the message text. 
inner 
The inner exception that led to StackOverflowError. 


See Also 

Reference 
StackOverflowError Class 
Concepts 

StackOverflowError Members 
java.lang Package 


Visual J# Reference 


StackOverflowError Methods 


Public Methods 





Name 


Description 





<exceptFilter> 


Maps an error object to a StackOverflowError object. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 


Protected Methods 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


StackOverflowError Class 


Concepts 
java.lang Package 





Visual J# Reference 


StackOverflowError Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
StackOverflowError Class 
Concepts 

java.lang Package 








Visual J# Reference 


StringBuffer Class 


Implements a sequence of characters, which can be modified by using the appropriate method calls. The main difference 
between a StringBuffer object and String object is that the latter is immutable. Therefore, it is recommended that you use 
StringBuffer to manipulate and update the string, and then convert it to a String object. 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public class java.lang.StringBuffer 
extends java.lang.Object 
implements java.io.Serializable 


| 
Inheritance Hierarchy 

java.lang.Object 
java.lang.StringBuffer 


See Also 

Concepts 

StringBuffer Members 
java.lang Package 
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StringBuffer Members 


Implements a sequence of characters, which can be modified by using the appropriate method calls. The main difference 
between a StringBuffer object and String object is that the latter is immutable. Therefore, it is recommended that you use 
StringBuffer to manipulate and update the string, and then convert it to a String object. 


The following tables list the members exposed by the StringBuffer type. 


Public Constructors 





Name 


Description 





StringBuffer 


Overloaded. 





Public Methods 

















Name Description 

append Overloaded. 

capacity Returns the current capacity of StringBuffer. 

charAt Returns the character at a specified index. 

delete Deletes the characters within a specified range in a StringBuffer object and returns the new StringBuffer object. 
deleteCharAt |Deletes the character at a specified index. 





ensureCapacity/Ensures that the buffer capacity is not less than a specified minimum. 




















equals (inherited from Object ) 

getChars Copies the characters within a specified range from a StringBuffer object to a destination character array atas 
pecified position. 

hashCode (inherited from Object ) 

getClass (inherited from Object ) 

insert Overloaded. 

length Returns the length of the StringBuffer object. 

replace Replaces characters within a specified range in a StringBuffer object with a specified string. 

reverse Reverses the sequence of the characters in a StringBuffer object. 

setCharAt Changes a character at a specified index in a StringBuffer object. 

setLength Changes the length of a StringBuffer object to a specified length. 

substring Overloaded. 

toString Overridden. Converts a StringBuffer object to a String object. 





Protected Methods 








Name 


Description 





finalize 


MemberwiseClone 





See Also 
Reference 
StringBuffer Class 
Concepts 
java.lang Package 





(inherited from Object ) 


Performs a shallow copy of the object. 
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StringBuffer Constructor 


Overload List 





Name 


Description 





StringBuffer () 


Constructs a new StringBuffer object. 





StringBuffer (int) 


Constructs a new StringBuffer object with a specified initial capacity. 





StringBuffer (String) 





Constructs a new StringBuffer object using a specified string for the initial contents. 





See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 
java.lang Package 
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StringBuffer Constructor () 


Constructs a new StringBuffer object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.StringBuffer() ; 


Example OO 
StringBuffer buf = new StringBuffer() ; // Initial capacity 16. 








Remarks 
The default initial capacity of the buffer is 16 characters. 


See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 
java.lang Package 
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StringBuffer Constructor (Int32) 


Constructs a new StringBuffer object with a specified initial capacity. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.StringBuffer( 
int capacity); 





Parameters 
capacity 


The initial capacity of the object. 


Example 





StringBuffer buf = new StringBuffer (30) ; // Initial capacity 30. 








Remarks 
Throws NegativeArraySizeException if capacity is negative. 


See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 
java.lang Package 
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StringBuffer Constructor (String) 


Constructs a new StringBuffer object using a specified string for the initial contents. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.StringBuffer( 
java.lang.String str); 





Parameters 
str 


A string that represents the initial contents of the StringBuffer object. 


Example 





// Construct a StringBuffer object using a string: 


StringBuffer buf = new StringBuffer("Hi there."); 





See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 
java.lang Package 
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StringBuffer Methods 


Public Methods 





















































Name Description 

append Overloaded. 

capacity Returns the current capacity of StringBuffer. 

charAt Returns the character at a specified index. 

delete Deletes the characters within a specified range in a StringBuffer object and returns the new StringBuffer object. 

deleteCharAt |Deletes the character at a specified index. 

ensureCapacity|Ensures that the buffer capacity is not less than a specified minimum. 

equals (inherited from Object ) 

getChars Copies the characters within a specified range from a StringBuffer object to a destination character array atas 
pecified position. 

hashCode (inherited from Object ) 

getClass (inherited from Object ) 

insert Overloaded. 

length Returns the length of the StringBuffer object. 

replace Replaces characters within a specified range in a StringBuffer object with a specified string. 

reverse Reverses the sequence of the characters in a StringBuffer object. 

setCharAt Changes a character at a specified index in a StringBuffer object. 

setLength Changes the length of a StringBuffer object to a specified length. 

substring Overloaded. 

toString Overridden. Converts a StringBuffer object to a String object. 








Protected Methods 




















Name Description 

finalize (inherited from Object ) 
MemberwiseClone Performs a shallow copy of the object. 
See Also 

Reference 


StringBuffer Class 


Concepts 


java.lang Package 
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StringBuffer.append Method 


Overload List 





Name 


Description 





StringBuffer.append (boolean) 


Appends a boolean value to a StringBuffer object. 





StringBuffer.append (char) 


Appends a character to a StringBuffer object. 





StringBuffer.append (char[]) 


Appends a character array to a StringBuffer object. 





StringBuffer.append (double) 


Appends the string representation of a double to a StringBuffer object. 





StringBuffer.append (int) 
StringBuffer.append (long) 
StringBuffer.append (Object) 
StringBuffer.append (float) 
StringBuffer.append (String) 


StringBuffer.append (char[], int, int) 





Appends the string representation of an int to a StringBuffer object. 

Appends the string representation of a long to a StringBuffer object. 

Appends the string representation of an object to a StringBuffer object. 
Appends the string representation of a float to the value of a StringBuffer object. 
Appends a string to a StringBuffer object. 


Appends characters from a character array, starting at a specified index, to a StringBuffer o 
bject. 








See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 
java.lang Package 





Visual J# Reference 


StringBuffer.append Method (Boolean) 


Appends a boolean value to a StringBuffer object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.StringBuffer append( 
boolean b); 


Parameters 
b 
A Boolean expression. 
Return Value 
The value of the StringBuffer object after appending the boolean value. 
Example 


// sb-appBool.jsl 
// StringBuffer.append example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Initialize a boolean variable: 
boolean b = true; 
// Construct a StringBuffer object: 
StringBuffer s = new StringBuffer("Is that "); 
// Append the boolean value and display the buffer: 
System.out.println(s.append(b) + "?"); 
} 
} 
/* 
Output: 
Is that true? 
/ 
See Also 
Reference 
StringBuffer Class 
Concepts 


StringBuffer Members 
java.lang Package 


Visual J# Reference 


StringBuffer.append Method (Char) 


Appends a character to a StringBuffer object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public synchronized java.lang.StringBuffer append( 
char c); 


Parameters 
c 
The character to append. 
Return Value 
The value of the StringBuffer object after appending the character. 
Example 


// sb-appchar.jsl 
// StringBuffer.append example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Construct a StringBuffer object: 
StringBuffer s = new StringBuffer("Hello there"); 
// Append a char and display the buffer: 
System.out.println(s.append('!")); 
} 
} 
/* 
Output: 
Hello there! 
*/ 
See Also 
Reference 
StringBuffer Class 
Concepts 


StringBuffer Members 
java.lang Package 


Visual J# Reference 


StringBuffer.append Method (CharT ]) 


Appends a character array to a StringBuffer object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public synchronized java.lang.StringBuffer append( 
char[] str); 


Parameters 
str 
The character array to append. 
Return Value 
The value of the StringBuffer object after appending the character array. 
Example 


// sb-appca.jsl 
// StringBuffer.append example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Declare and initialize a char array: 
char[] ca = {'A'’, 'B', 'C'}; 
// Construct a StringBuffer object: 
StringBuffer s = new StringBuffer( 
"To learn a language, start with "); 
// Append the char array and display the buffer: 
System.out.println(s.append(ca) + "."); 
} 
} 
/* 
Output: 
To learn a language, start with ABC. 
*/ 
See Also 
Reference 
StringBuffer Class 
Concepts 


StringBuffer Members 
java.lang Package 


Visual J# Reference 


StringBuffer.append Method (Double) 


Appends the string representation of a double to a StringBuffer object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.StringBuffer append( 
double d); 


Parameters 
d 
A double expression. 
Return Value 
The value of the StringBuffer object after appending the string representation of the double value. 
Example 


// sb-appdbl.jsl 
// StringBuffer.append example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Declare and initialize a double: 
double d = 3.14; 
// Construct a StringBuffer object: 
StringBuffer s = new StringBuffer("The ratio is: "); 
// Append the double value and display the buffer: 
System.out.println(s.append(d) + ".")3 
} 
} 
/* 
Output: 
The ratio is: 3.14. 
*/ 
See Also 
Reference 
StringBuffer Class 
Concepts 


StringBuffer Members 
java.lang Package 


Visual J# Reference 


StringBuffer.append Method (Int32) 


Appends the string representation of an int to a StringBuffer object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.StringBuffer append( 
int i); 


Parameters 
l 
An int expression. 
Return Value 
The value of the StringBuffer object after appending the string representation of the int value. 
Example 
See the example on append. 


See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 
java.lang Package 


Visual J# Reference 


StringBuffer.append Method (Int64) 


Appends the string representation of a long to a StringBuffer object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.StringBuffer append( 
long 1); 


Parameters 
l 
A long expression. 
Return Value 
The value of the StringBuffer object after appending the string representation of the long value. 
Example 
See the example on append. 


See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 
java.lang Package 


Visual J# Reference 


StringBuffer.append Method (Object) 


Appends the string representation of an object to a StringBuffer object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public synchronized java.lang.StringBuffer append( 
java.lang.Object obj); 


Parameters 
obj 
An object. 
Return Value 
The value of the StringBuffer object after appending the string representation of the object. 
Example 


// sb-appobj.jsl 
// StringBuffer.append example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Declare and initialize an object: 
Object d = new Double(3.14); 
// Construct a StringBuffer object: 
StringBuffer s = new StringBuffer("The ratio is: "); 
// Append the object and display the buffer: 
System.out.println(s.append(d) + "."); 
} 
} 
/* 
Output: 
The ratio is: 3.14. 
*/ 
See Also 
Reference 
StringBuffer Class 
Concepts 


StringBuffer Members 
java.lang Package 


Visual J# Reference 


StringBuffer.append Method (Single) 


Appends the string representation of a float to the value of a StringBuffer object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.StringBuffer append( 
float f); 


Parameters 


f 
A float expression. 

Return Value 

The value of the StringBuffer object after appending the string representation of the float value. 

Example 

See the example on append. 


See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 
java.lang Package 


Visual J# Reference 


StringBuffer.append Method (String) 


Appends a string to a StringBuffer object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public synchronized java.lang.StringBuffer append( 
java.lang.String str); 


Parameters 
str 


Return Value 
The value of the StringBuffer object after appending the string. 
Example 


// sb-appstr.jsl 
// StringBuffer.append example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Construct a String object: 
String s1 = new String("3.14"); 
// Construct a StringBuffer object: 
StringBuffer s = new StringBuffer("The ratio is: "); 
// Append the string and display the buffer: 
System.out.println(s.append(s1) + "."); 
} 
} 
/* 
Output: 
The ratio is: 3.14. 
*/ 
See Also 
Reference 
StringBuffer Class 
Concepts 


StringBuffer Members 
java.lang Package 


Visual J# Reference 


StringBuffer.append Method (CharT J, Int32, Int32) 


Appends characters from a character array, starting at a specified index, to a StringBuffer object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public synchronized java.lang.StringBuffer append( 
char[] str, 
int offset, 
int len); 


Parameters 
str 
The name of the char array. 
offset 
The index of the first character to append. 
len 
The number characters to append. 
Return Value 
The value of the StringBuffer object after appending the characters. 
Example 


// sb-appcal.jsl 
// StringBuffer.append example 


public class MyClass 


{ 
public static void main(String[] args) 
1 
// Construct a char array: 
char[] ca = {'A', 'B', 'C'};5 
// Construct a StringBuffer object: 
StringBuffer s = new StringBuffer( 
"To learn a language, start with "); 
// Append the char array and display the buffer: 
System.out.println(s.append(ca,@,3) + "."); 
} 
} 
/* 
Output: 
To learn a language, start with ABC. 
ar A 
Remarks 


Throws ArraylndexOutOfBoundsException if len exceeds the number of available characters starting from offset. 


See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 
java.lang Package 


Visual J# Reference 


StringBuffer.capacity Method 


Returns the current capacity of StringBuffer. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public int capacity(); 


Return Value 
The capacity of StringBuffer. 


See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 
java.lang Package 


Visual J# Reference 


StringBuffer.charAt Method 


Returns the character at a specified index. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public synchronized char charAt( 
int index); 


Parameters 
index 

The index of the character. 
Return Value 
The character at index. 
Example 


// sb-charat.jsl 
// StringBuffer.charAt example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Construct a StringBuffer object: 
StringBuffer s = new StringBuffer( 
/* 01234567890123456789012345678901234 */ 
"To learn a language, start with J#."); 
int idx = 33; 
// Display the character at index 33: 
System.out.println("The character at the position " + 
idx + "is: \"" + s.charAt(idx) + "\"."); 
} 
} 
/* 
Output: 
The character at the position 33 is: "#". 
*/ 
Remarks 


Throws StringlndexOutOfBoundsException, if index is negative, or greater than or equal to length 


See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 
java.lang Package 


Visual J# Reference 


StringBuffer.delete Method 


Deletes the characters within a specified range in a StringBuffer object and returns the new StringBuffer object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public synchronized java.lang.StringBuffer delete( 
int start, 
int end); 


Parameters 
start 
The starting index. 
end 
The ending index. 
Return Value 
The new StringBuffer object. 
Example 


// sb-del.jsl 
// StringBuffer.delete example 


public class MyClass 


{ 
public static void main(String[] args) 
ii 
// Construct a StringBuffer object: 
StringBuffer s = new StringBuffer( 
/* 012345678901234567890123456789012 */ 
"To learn J#, start with keywords."); 
int start = Q@; 
int end = 13; 
// Delete chars from start to end: 
s = s.delete(start, end); 
// Catenate a string and display the buffer: 
System.out.println("Always " + s); 
} 
} 
/* 
Output: 
Always start with keywords. 
a A 
Remarks 


The characters are deleted from start, up to, but not including end. 
The exception StringlndexOutOfBoundsException is thrown, if start is negative, greater than length, or greater than end. 


See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 
java.lang Package 


Visual J# Reference 


StringBuffer.deleteCharAt Method 


Deletes the character at a specified index. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public synchronized java.lang.StringBuffer deleteCharAt( 
int index); 


Parameters 
index 
The index of the character to be deleted. 
Return Value 
The new StringBuffer object. 
Example 


// sb-delCharAt.jsl 
// StringBuffer.deleteCharAt example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Construct a StringBuffer object: 
StringBuffer s = new StringBuffer( 
/* 012345678901234567890123456789012 */ 
"To learn J#, start with keywords."); 
int index = 32; 
// Delete the char at position 32: 
s = s.deleteCharAt (index) ; 
// Catenate a string and display the buffer: 
System.out.printlin(s + "!"); 
} 
} 
/* 
Output: 
To learn J#, start with keywords! 
ff 
Remarks 


Throws StringlndexOutOfBoundsException if index is negative, or greater than or equal the length of StringBuffer. 


See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 
java.lang Package 


Visual J# Reference 


StringBuffer.ensureCapacity Method 


Ensures that the buffer capacity is not less than a specified minimum. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public synchronized void ensureCapacity( 
int minimumCapacity) ; 


Parameters 
minimumCapacity 


The minimum capacity. 
Example 


// Ensure that capacity is not less than 32: 
s.ensureCapacity(32); 


See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 
java.lang Package 


Visual J# Reference 


StringBuffer.getChars Method 


Copies the characters within a specified range from a StringBuffer object to a destination character array at a specified position. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public synchronized void getChars( 
int srcBegin, 
int srcEnd, 
char[] dst, 
int dstBegin); 


Parameters 
srcBegin 

The beginning position of the range. 
srcEnd 

The ending position of the range. 
dst 

The destination character array. 
dstBegin 

The insertion position. 
Example 
In this example, two characters are copied from the StringBuffer object, src, to a destination character array, dst. The destination 


array contains the string "J#." 


// sb-getCh.jsl 
// StringBuffer.getChars example 


public class MyClass 


if 
public static void main(String[] args) 
1 
// Construct a StringBuffer object: 
StringBuffer src = new StringBuffer( 
/* 012345678901234567890123456789012 */ 
"To learn J#, start with keywords."); 
// Declare a new char array: 
char[] dst = new char[2]; 
// Copy the chars #9 and #10 to dst: 
src.getChars(9,11,dst,@); 
// Display dst: 
System.out.println(dst) ; 
} 
} 
/* 
Output 
J# 
*/ 


Remarks 


Throws NullPointerException if dst is null. 

Throws StringlndexOutOfBoundsException if any of the following conditions is true: 
srcBegin is negative. 

dstBegin is negative. 

srcBegin is greater than srcEnd. 

srcEnd is greater than the current length of the string buffer. 

dstBegin + (srcEnd -srcBegin) is greater than dst.length. 


See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 
java.lang Package 


Visual J# Reference 


StringBuffer.insert 


Overload List 


Method 





Name 


Description 





StringBuffer.insert (int, boolean) 


StringBuffer.insert (int, char) 


StringBuffer.insert (int, char[]) 


Inserts the string representation of a boolean value into a StringBuffer object at a specifie 
d offset. 


Inserts the string representation of a char into a StringBuffer object at a specified offset. 


Inserts the string representation of a character array into a StringBuffer object at a specifi 
ed offset. 





StringBuffer.insert (int, double) 


Inserts the string representation of a double value into a StringBuffer object at a specifie 
d offset. 





StringBuffer.insert (int, int) 


Inserts the string representation of an int into a StringBuffer object at a specified offset. 





StringBuffer.insert (int, long) 


StringBuffer.insert (int, Object) 


Inserts the string representation of a long value into a StringBuffer object at a specified o 
ffset. 


Inserts the string representation of an object into a StringBuffer object at a specified offs 
et. 





StringBuffer.insert (int, float) 


Inserts the string representation of a float into a StringBuffer object at a specified offset. 





StringBuffer.insert (int, String) 


Inserts the string into a StringBuffer object at a specified offset. 





StringBuffer.insert (int, char[], int, int) 





See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 
java.lang Package 





Inserts characters from a character array starting at a specified character offset to a speci 
fied offset in a StringBuffer object. 





Visual J# Reference 


StringBuffer.insert Method (Int32, Boolean) 


Inserts the string representation of a boolean value into a StringBuffer object at a specified offset. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.StringBuffer insert( 
int offset, 
boolean b); 


Parameters 
offset 


The offset of insertion. 


The boolean value. 
Return Value 
The same instance of StringBuffer with data inserted. 
Example 
In this example the string representation of the boolean value true is inserted at the offset 6 of the StringBuffer object. 


// sb-inserti1.jsl 
// StringBuffer.insert example 


public class MyClass 


{ 
public static void main(String[] args) 
1 
// Construct a StringBuffer object: 
StringBuffer buf = new StringBuffer( 
/* 0123456 */ 
"Is it ?"); 
// Insert true at offset 6: 
buf = buf.insert(6,true); 
// Display the buffer: 
System.out.println(buf) ; 
} 
} 
/* 
Output: 
Is it true? 
* 
Remarks 


A valid offset must be greater than or equal to zero and less than or equal to the length of StringBuffer. 
Throws StringlndexOutOfBoundsException if offset is invalid. 


See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 


java.lang Package 


Visual J# Reference 


StringBuffer.insert Method (Int32, Char) 


Inserts the string representation of a char into a StringBuffer object at a specified offset. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public synchronized java.lang.StringBuffer insert( 
int offset, 
char c); 


Parameters 
offset 


The offset of the insertion. 


The character to be inserted. 
Return Value 
The same instance of StringBuffer with data inserted. 
Example 
In this example the character 'J' is inserted at offset 6 of the StringBuffer object. 


// sb-insert2.jsl 
// StringBuffer.insert example 


public class MyClass 


{ 
public static void main(String[] args) 
1 
// Construct a StringBuffer object: 
StringBuffer buf = new StringBuffer( 
/* 0123456 */ 
"Hello #!"); 
// Insert 'J' at the offset 6: 
buf = buf.insert(6,'J'); 
// Display the buffer: 
System.out.println(buf) ; 
} 
} 
/* 
Output: 
Hello J#! 
*/ 
Remarks 


A valid offset must be greater than or equal to zero and less than or equal to the length of StringBuffer. 
Throws StringlndexOutOfBoundsException if offset is invalid. 


See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 


java.lang Package 


Visual J# Reference 


StringBuffer.insert Method (Int32, Char[]) 


Inserts the string representation of a character array into a StringBuffer object at a specified offset. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public synchronized java.lang.StringBuffer insert( 
int offset, 
char[] str); 


Parameters 
offset 


The offset of the insertion. 
str 
The character array to be inserted. 
Return Value 
The same instance of StringBuffer with data inserted. 
Example 


// sb-insert3.jsl 
// StringBuffer.insert example 


public class MyClass 


{ 
public static void main(String[] args) 
ii 
// Construct a StringBuffer object: 
StringBuffer buf = new StringBuffer( 
/* 0123456 */ 
"Hello !"); 
// Construct a character array: 
char[] str = {'J','#'}; 
// Insert str at the offset 6: 
buf = buf.insert(6,str); 
// Display the buffer: 
System.out.println(buf) ; 
} 
} 
/* 
Output: 
Hello J#! 
mf: 
Remarks 


A valid offset must be greater than or equal to zero and less than or equal to the length of StringBuffer. 
Throws StringlndexOutOfBoundsException if offset is invalid. 


See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 


java.lang Package 


Visual J# Reference 


StringBuffer.insert Method (Int32, Double) 


Inserts the string representation of a double value into a StringBuffer object at a specified offset. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.StringBuffer insert( 
int offset, 
double d); 


Parameters 
offset 


The offset of the insertion. 
d 
The double value to be inserted. 
Return Value 
The same instance of StringBuffer with data inserted. 
Example 


// sb-insert4.jsl 
// StringBuffer.insert example 


public class MyClass 


{ 
public static void main(String[] args) 
ii 
// Construct a StringBuffer object: 
StringBuffer buf = new StringBuffer( 
/* 0123456 */ 
"Hello !"); 
// Construct a Double object: 
Double d = new Double(3.45); 
// Insert d at offset 6: 
buf = buf.insert(6,d); 
// Display the buffer: 
System.out.println(buf) ; 
} 
} 
pe 
Output: 
Hello 3.45! 
mf: 
Remarks 


A valid offset must be greater than or equal to zero and less than or equal to the length of StringBuffer. 
Throws StringlndexOutOfBoundsException if offset is invalid. 


See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 


java.lang Package 


Visual J# Reference 


StringBuffer.insert Method (Int32, Int32) 


Inserts the string representation of an int into a StringBuffer object at a specified offset. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.StringBuffer insert( 
int offset, 
int i); 


Parameters 
offset 


The offset of the insertion. 


The int to be inserted. 
Return Value 
The same instance of StringBuffer with data inserted. 
Example 
See the example on insert. 
Remarks 
A valid offset must be greater than or equal to zero and less than or equal to the length of StringBuffer. 
Throws StringlndexOutOfBoundsException if offset is invalid. 


See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 
java.lang Package 


Visual J# Reference 


StringBuffer.insert Method (Int32, Int64) 


Inserts the string representation of a long value into a StringBuffer object at a specified offset. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.StringBuffer insert( 
int offset, 
long 1); 


Parameters 
offset 


The offset of the insertion. 


The long value to be inserted. 
Return Value 
The same instance of StringBuffer with data inserted. 
Example 
See the example on insert. 
Remarks 
A valid offset must be greater than or equal to zero and less than or equal to the length of StringBuffer. 
Throws StringlndexOutOfBoundsException if offset is invalid. 


See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 
java.lang Package 


Visual J# Reference 


StringBuffer.insert Method (Int32, Object) 


Inserts the string representation of an object into a StringBuffer object at a specified offset. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public synchronized java.lang.StringBuffer insert( 
int offset, 
java.lang.Object obj); 


Parameters 
offset 


The offset of the insertion. 
obj 
The object to be inserted. 
Return Value 
The same instance of StringBuffer with data inserted. 
Example 


// sb-insert5S.jsl 
// StringBuffer.insert example 


public class MyClass 


{ 
public static void main(String[] args) 
ii 
// Construct a StringBuffer object: 
StringBuffer buf = new StringBuffer( 
/* 0123456 */ 
"Hello !"); 
// Construct an object: 
Object d = new Double(3.45); 
// Insert d at the offset 6: 
buf = buf.insert(6,d); 
// Display the buffer: 
System.out.println(buf) ; 
} 
} 
pe 
Output: 
Hello 3.45! 
mf: 
Remarks 


A valid offset must be greater than or equal to zero and less than or equal to the length of StringBuffer. 
Throws StringlndexOutOfBoundsException if offset is invalid. 


See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 


java.lang Package 


Visual J# Reference 


StringBuffer.insert Method (Int32, Single) 


Inserts the string representation of a float into a StringBuffer object at a specified offset. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.StringBuffer insert( 
int offset, 
float f); 


Parameters 
offset 


The offset of the insertion. 


The float to be inserted. 
Return Value 
The same instance of StringBuffer with data inserted. 
Example 
See the example on insert. 
Remarks 
A valid offset must be greater than or equal to zero and less than or equal to the length of StringBuffer. 
Throws StringlndexOutOfBoundsException if offset is invalid. 


See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 
java.lang Package 


Visual J# Reference 


StringBuffer.insert Method (Int32, String) 


Inserts the string into a StringBuffer object at a specified offset. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public synchronized java.lang.StringBuffer insert( 
int offset, 
java.lang.String str); 


Parameters 
offset 


The offset of the insertion. 
str 
The string to be inserted. 
Return Value 
The same instance of StringBuffer with data inserted. 
Example 


// sb-insert6.jsl 
// StringBuffer.insert example 


public class MyClass 


{ 
public static void main(String[] args) 
ii 
// Construct a StringBuffer object: 
StringBuffer buf = new StringBuffer( 
/* 0123456 */ 
"Hello !"); 
// Construct a String object: 
String s = new String("there"); 
// Insert the string "s" at offset 6: 
buf = buf.insert(6,s); 
// Display the buffer: 
System.out.println(buf) ; 
} 
} 
pe 
Output: 
Hello there! 
m/f 
Remarks 


A valid offset must be greater than or equal to zero and less than or equal to the length of StringBuffer. 
Throws StringlndexOutOfBoundsException if offset is invalid. 


See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 


java.lang Package 


Visual J# Reference 


StringBuffer.insert Method (Inta32, Char[], Int32, Int32) 


Inserts characters from a character array starting at a specified character offset to a specified offset in a StringBuffer object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public synchronized java.lang.StringBuffer insert( 
int index, 
char[] data, 
int offset, 
int count); 


Parameters 
index 


The index where the insertion starts. 
data 
The character array. 
offset 
The offset of the first character in the character array to be inserted. 
count 
The number of characters to be inserted. 
Return Value 
The same instance of StringBuffer with data inserted. 
Example 


// sb-insert7.jsl 
// StringBuffer.insert example 


public class MyClass 
if 


public static void main(String[] args) 


1 
// Construct a StringBuffer object: 


StringBuffer buf = new StringBuffer( 
/* 012345678901234567890123456789012345678901 */ 
"To learn programming, start with keywords."); 


// Construct a char array: 
char[] data = {' ','J','#'}; 


// Insert data into index 8 of the StringBuffer object, 
// starting at character @ with length 4: 
buf.insert(8,data,@,3); 


// Display the buffer: 
System.out.println(buf) ; 


r 


/* 
Output: 
To learn J# programming, start with keywords. 


| 


Remarks 

Throws StringlndexOutOfBoundsException if one of the following conditions is true: 
index is negative or greater than the length of StringBuffer. 

offset is negative or greater than the data.length. 

count is negative or (offset + count) is greater than data.length. 

Throws NullPointerException if data is null. 


See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 
java.lang Package 


Visual J# Reference 


StringBuffer.length Method 


Returns the length of the StringBuffer object. 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public int length(); 


Return Value 


The number of characters contained in a StringBuffer object. 


Example 


// sb-length.jsl 
// StringBuffer.length example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Construct two StringBuffer objects: 
StringBuffer s1 = new StringBuffer("Hello world!"); 
StringBuffer s2 = new StringBuffer("Hi there."); 
// Display the length of each buffer: 
System.out.println(s1 + " = " + s1.length() + " characters"); 
System.out.println(s2 + " = " + s2.length() + " characters"); 
} 
} 
/ * 
Output: 
Hello world! = 12 characters 
Hi there. = 9 characters 
*/ 
See Also 
Reference 


StringBuffer Class 


Concepts 


StringBuffer Members 
java.lang Package 
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StringBuffer.replace Method 


Replaces characters within a specified range in a StringBuffer object with a specified string. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public synchronized java.lang.StringBuffer replace( 
int start, 
int end, 
java.lang.String str); 


Parameters 
start 
The starting index of the range (inclusive). 
end 
The ending index of the range (exclusive). 
str 
The string to replace the characters in the specified range. 
Example 


// sb-replace.jsl 
// StringBuffer.insert example 


public class MyClass 


{ 
public static void main(String[] args) 
// Construct a StringBuffer object: 
StringBuffer buf = new StringBuffer( 
/* 012345678901234567890123456789012345678901 */ 
"To learn programming, start with keywords."); 
// Construct a string: 
String str = new String("about J#"); 
// Replace "Programming" with str: 
buf.replace(9,2@,str); 
// Display the buffer: 
System.out.println(buf) ; 
} 
} 
/* 
Output: 
To learn about J#, start with keywords. 
ays 
Remarks 


Throws StringlndexOutOfBoundsException if start is negative, greater than the length of StringBuffer, or greater than end. 


See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 
java.lang Package 
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StringBuffer.reverse Method 


Reverses the sequence of the characters in a StringBuffer object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public synchronized java.lang.StringBuffer reverse(); 


Return Value 
Returns the same instance of StringBuffer with data reversed in place. 
Example 


// sb-reverse.jsl 
// StringBuffer.reverse example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Construct a StringBuffer object: 
StringBuffer s = new StringBuffer("Hello world!"); 
// Reverse characters and display the buffer: 
System.out.println("Reversed Hello world!: " + s.reverse()); 
} 
} 
/* 
Output: 
Reversed Hello world!: !dlrow olleH 
= 
See Also 
Reference 
StringBuffer Class 
Concepts 


StringBuffer Members 
java.lang Package 
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StringBuffer.setCharAt Method 


Changes a character at a specified index in a StringBuffer object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public synchronized void setCharAt( 
int index, 
char ch); 





Parameters 
index 


The index of the character to be changed. 
ch 


The new character. 


Example OT 











// sb-setChAt.jsl 
// StringBuffer.setCharAt example 
public class MyClass 
+ 
public static void main(String[] args) 
{ 
// Construct a StringBuffer object: 
StringBuffer s = new StringBuffer("Hello world!"); 
// Change w to W: 
s.setCharAt(6, 'W'); 
// Display the buffer: 
System.out.println(s); 
} 
} 
/* 
Output: 
Hello World! 
*/ 
Remarks 


Throws StringlndexOutOfBoundsException if index is negative or greater than or equal to the current length of the buffer. 


See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 
java.lang Package 
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StringBuffer.setLength Method 


Changes the length of a StringBuffer object to a specified length. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public synchronized void setLength( 
int newLength) ; 





Parameters 
newLength 


The new length of the buffer. 








Example 
// sb-setLent.jsl 
// StringBuffer.setLength example 
public class MyClass 
public static void main(String[] args) 
{ 
// Construct a StringBuffer object: 
StringBuffer s = new StringBuffer("Hello world!"); 
// Change the length to 5 characters: 
s.setLength(5); 
// Display the buffer: 
System.out.println(s); 
} 
: 
/* 
Output: 
Hello 
o/. 
Remarks 


Throws StringlndexOutOfBoundsException if newLength is negative. 


See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 
java.lang Package 
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StringBuffer.substring Method 


Overload List 
Name Description 








StringBuffer.substring (int) | |Returns a substring that starts at a specific index in a StringBuffer object. 





StringBuffer.substring (int, int)/Returns the substring that begins at the specified starting index and extends up to, but not inclu 
ding, the character at the ending index. 








See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 
java.lang Package 
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StringBuffer.substring Method (Int32) 


Returns a substring that starts at a specific index in a StringBuffer object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String substring( 
int start); 


Parameters 
start 
The starting index of the substring. 
Return Value 
The substring that starts at start and extends to the end of the string. 
Example 


// sb-substring1.jsl 
// StringBuffer.substring example 


public class MyClass 


{ 
public static void main(String[] args) 
// Construct a StringBuffer object: 
StringBuffer s = new StringBuffer("Hello world!"); 
// Display the substring: 
System.out.printin("In \"" + s + 
"\", the substring starting at the 6th character is: " 
+ s.substring(6)); 
} 
} 
/* 
Output: 
In "Hello world!", the substring starting at the 6th character is: world! 
arf 
Remarks 


Throws StringlndexOutOfBoundsException if start is negative or greater than the length of StringBuffer. 


See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 
java.lang Package 
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StringBuffer.substring Method (Int32, Int32) 


Returns the substring that begins at the specified starting index and extends up to, but not including, the character at the 
ending index. 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public synchronized java.lang.String substring( 
int start, 
int end); 


Parameters 
start 
The starting index (inclusive). 
end 
The ending index (exclusive). 
Return Value 
The string specified by the start and end indexes. 
Example 


// sb-substring2.jsl 
// StringBuffer.subString example 


public class MyClass 


{ 
public static void main(String[] args) 
1 
// Construct a StringBuffer object: 
StringBuffer s = new StringBuffer("Hello world!"); 
// Display the substring: 
System.out.printin("In \"" + s + 
"\", the substring starting from 6th character up to, " + 
"but not including, the 11th character is: " 
+ s.substring(6,11)); 
} 
} 
/* 
Output: 


In "Hello world!", the substring starting from 6th character up to, but not including, the 
11th character is: world 


mh 


Remarks 


Throws StringlndexOutOfBoundsException if start or end is negative, if end is greater than the length of StringBuffer, or if start 
is greater than end. 


See Also 

Reference 
StringBuffer Class 
Concepts 

StringBuffer Members 
java.lang Package 
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StringBuffer.toString Method 


Converts a StringBuffer object to a String object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.String toString(); 





Return Value 


The String object equivalent to the value stored in the StringBuffer object. 


Example 








// sb-toStr.jsl 
// StringBuffer.toString example 
public class MyClass 
{ 
public static void main(String[] args) 
// Construct a StringBuffer object: 
StringBuffer s = new StringBuffer("Hello there"); 
// Append a char to the buffer: 
s.append('!'); 
// Convert to a String object and display it: 
System.out.println(s.toString()); 
} 
} 
/* 
Output: 
Hello there! 
m/f 
See Also 
Reference 
StringBuffer Class 
Concepts 


StringBuffer Members 
java.lang Package 
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StringlndexOutOfBoundsException Class 


An exception that is thrown by a string method when an index is greater than the size of the string 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.StringIndexOutOfBoundsException 
extends java. lang. IndexOutOfBoundsException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.lang.RuntimeException 
java.lang.IndexOutOfBoundsException 
java.lang.StringlndexOutOfBoundsException 


See Also 

Concepts 

StringlndexOutOfBoundsException Members 
java.lang Package 
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StringlndexOutOfBoundsException Members 


An exception that is thrown by a string method when an index is greater than the size of the string 


The following tables list the members exposed by the StringlndexOutOfBoundsException type. 


Public Constructors 





Name 


Description 





StringlndexOutOfBoundsException Overloaded. Constructs a StringlndexOutOfBoundsException object. 








Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 





Description 


(inherited from Exception ) 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 








printStackTrace 





getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 

clone (inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 








toString (inherited from Throwable ) 





Protected Methods 
Name 








finalize (inherited from Object ) 
See Also 

Reference 

StringlndexOutOfBoundsException Class 

Concepts 


java.lang Package 





Visual J# Reference 


StringlndexOutOfBoundsException Constructor 


Constructs a StringIndexOutOfBoundsException object. 


Overload List 
Name Description 


StringlndexOutOfBoundsException () Constructs a StringlndexOutOfBoundsException objec 
t without a specified text message. 





StringlndexOutOfBoundsException (int) Constructs a StringlndexOutOfBoundsException objec 
t with a specified element index. 


StringlndexOutOfBoundsException (String) Constructs a StringlndexOutOfBoundsException objec 
t with a specified text message. 


StringlndexOutOfBoundsException (SerializationInfo, StreamingContext)|Constructs a StringlndexOutOfBoundsException objec 
t during serialization. 





StringlndexOutOfBoundsException (String, Exception) Constructs a StringlndexOutOfBoundsException objec 
t with a specific text message and inner exception. 








See Also 

Reference 
StringlndexOutOfBoundsException Class 
Concepts 

StringlndexOutOfBoundsException Members 
java.lang Package 
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StringIndexOutOfBoundsException Constructor () 


Constructs a StringlndexOutOfBoundsException object without a specified text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.StringIndexOutOfBoundsException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
StringlndexOutOfBoundsException Class 
Concepts 

StringlndexOutOfBoundsException Members 
java.lang Package 
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StringIndexOutOfBoundsException Constructor (Int32) 


Constructs a StringlndexOutOfBoundsException object with a specified element index. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.StringIndexOutOfBoundsException( 
int i); 
| 
Parameters 
i 
The index of the string array element that exceeded the limit. 


See Also 

Reference 
StringlndexOutOfBoundsException Class 
Concepts 

StringlndexOutOfBoundsException Members 
java.lang Package 
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StringiIndexOutOfBoundsException Constructor (String) 


Constructs a StringindexOutOfBoundsException object with a specified text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.StringIndexOutOfBoundsException( 


java.lang.String s); 
| 


Parameters 
Ss 


The string that contains the message text. 


See Also 

Reference 
StringlndexOutOfBoundsException Class 
Concepts 

StringlndexOutOfBoundsException Members 
java.lang Package 
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StringlndexOutOfBoundsException Constructor 
(SerializationInfo, StreamingContext) 


Constructs a StringindexOutOfBoundsException object during serialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java. lang.StringIndexOutOfBoundsException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information required for serializing an object. 
context 
The source or destination for the serialization. 


See Also 

Reference 
StringlndexOutOfBoundsException Class 
Concepts 

StringlndexOutOfBoundsException Members 
java.lang Package 
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StringIndexOutOfBoundsException Constructor (String, 
Exception) 


Constructs a StringIndexOutOfBoundsException object with a specific text message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.StringIndexOutOfBoundsException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


The string that contains the message text. 
inner 
The inner exception that led to StringlndexOutOfBoundsException. 


See Also 

Reference 
StringlndexOutOfBoundsException Class 
Concepts 

StringlndexOutOfBoundsException Members 
java.lang Package 
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StringlndexOutOfBoundsException Methods 


Public Methods 












































Name Description 

equals (inherited from Object ) 
filllnStackTrace (inherited from Throwable ) 
GetBaseException (inherited from Exception ) 
hashCode (inherited from Object ) 
getLocalizedMessage (inherited from Throwable ) 
getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 
clone (inherited from Throwable ) 
printStackTrace Overloaded. (inherited from Throwable ) 
toString (inherited from Throwable ) 
Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 

StringlndexOutOfBoundsException Class 

Concepts 


java.lang Package 
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StringindexOutOfBoundsException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 


StringlndexOutOfBoundsException Class 


Concepts 
java.lang Package 
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System Class 


Contains useful fields such as the standard input, standard output, and standard error streams. It also contains methods to 
access properties, load files and libraries, and copy arrays. 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public final class java.lang.System 
extends java.lang.Object 





Inheritance Hierarchy 
java.lang.Object 
java.lang.System 


See Also 
Concepts 
System Members 
java.lang Package 
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System Members 


Contains useful fields such as the standard input, standard output, and standard error streams. It also contains methods to 
access properties, load files and libraries, and copy arrays. 


The following tables list the members exposed by the System type. 


Public Fields 


Name 


err 


out 


Description 


The standard error stream. 


The standard input stream. 


The standard output stream. 





Public Methods 


Name 


arraycopy 


Description 


Copies a specified portion of a source array, starting from a specified position, to a destination array, start 
ing at a specified position. 





currentTimeMiillis 


Retrieves the current time in milliseconds. 

















equals (inherited from Object) 

exit Terminates the current application and exits with a specified status code. 
gc Invokes the garbage collector. 

getenv This method is replaced by getProperty. 

hashCode (inherited from Object) 





getProperties 


Retrieves the current system properties. 





getProperty 


Overloaded. 





getSecurityManager|Returns the security manager. 











runFinalization 


runfinalizersOnExit 





getClass (inherited from Object) 

identityHashCode __|Retrieves the hash code for a specified object. 
load Loads a specified file. 

loadLibrary Loads a specified library. 

clone (inherited from Object) 


Runs the finalization methods on objects waiting to be finalized. 


Runs the garbage collection when the application exits. 








setErr Sets the standard error stream to a custom error stream. 











setin Sets the standard input stream to a custom input stream. 
setOut Sets the standard output stream to a custom output stream. 
setProperties Sets the system properties using a specified parameter. 





setSecurityManager |Sets the security manager. Obsolete. 





toString Overridden. Returns the string representation of the current object. 











See Also 
Reference 

System Class 
Concepts 
java.lang Package 
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System Fields 


Public Fields 























Name Description 

err The standard error stream. 
in The standard input stream. 
out The standard output stream. 
See Also 

Reference 

System Class 

Concepts 


java.lang Package 
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System.err Field 


The standard error stream. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final java.io.PrintStream err; 


Example OOOO 


// sys-err.jsl 
// System.err example 


public class MyClass 


public static void main(String[] args) 








{ 
// Write to the error stream: 
System.err.print("Hello world!"); 
} 
} 
/* 
Output: 
Hello world! 
od 
Remarks 


Typically, this stream is used for displaying error massages, especially when the standard output stream is redirected to a file 
and cannot be monitored. 


See Also 
Reference 
System Class 
Concepts 

System Members 
java.lang Package 
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System.in Field 


The standard input stream. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final java.io.InputStream in; 


Example OC 


// sys-in.jsl 
// System.in example 


public class MyClass 


public static void main(String[] args) throws java.io. IOException 
{ 

char c = (char)System.in.read(); 

System.out.print("You typed: " + c); 


} 


/* 

Input: 

E 

Output: 

You typed: E 
*/ 








Remarks 
Typically, the input stream corresponds to the keyboard. 
The java.io.IOException is expected with input operations. Use throws or try-catch statements to avoid exceptions. 


See Also 
Reference 
System Class 
Concepts 

System Members 
java.lang Package 
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System.out Field 


The standard output stream. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final java.io.PrintStream out; 


Example ——___________________c_____§_=, 


// sys-out.jsl 
// System.out example 


public class MyClass 


public static void main(String[] args) 


{ 
} 


System.out.print("Hello world!"); 


} 


/* 

Output: 
Hello world! 
+7, 











See Also 
Reference 
System Class 
Concepts 

System Members 
java.lang Package 
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System Methods 


Public Methods 





Name Description 





arraycopy Copies a specified portion of a source array, starting from a specified position, to a destination array, start 
ing at a specified position. 


currentTimeMillis |Retrieves the current time in milliseconds 














equals (inherited from Object ) 

exit Terminates the current application and exits with a specified status code. 
gc Invokes the garbage collector. 

getenv This method is replaced by getProperty. 

hashCode (inherited from Object ) 

getProperties Retrieves the current system properties. 

getProperty Overloaded. 





getSecurityManager|Returns the security manager. 





getClass (inherited from Object ) 





identityHashCode __|Retrieves the hash code for a specified object. 











load Loads a specified file. 
loadLibrary Loads a specified library. 
runFinalization Runs the finalization methods on objects waiting to be finalized. 





runfinalizersOnExit |Runs the garbage collection when the application exits. 














setErr Sets the standard error stream to a custom error stream.. 
setin Sets the standard input stream to a custom input stream. 
setOut Sets the standard output stream to a custom output stream. 
setProperties Sets the system properties using a specified parameter. 


setSecurityManager |Sets the security manager. Obsolete. 


toString Overridden. Returns the string representation of the current object. 





See Also 
Reference 
System Class 





Concepts 
java.lang Package 
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System.arraycopy Method 


Copies a specified portion of a source array, starting from a specified position, to a destination array, starting at a specified 
position. 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static void arraycopy( 
java.lang.Object src, 
int src_position, 
java.lang.Object dst, 
int dst_position, 
int length); 


Parameters 
Src 


The source array object. 
src_position 
The position where the copying starts in the source array. 
dst 
The destination array object. 
dst_position 
The position where the copying starts in the destination array. 
length 
The length of the array's portion to be copied. 
Example 


// sys-arr1.jsl 
// System.arraycopy example 


public class MyClass 
{ 
public static void main(String[] args) 
{ 
// Declare two arrays: 
int[] arri = {1,2,3,4,5,6}; 
int[] arr2 = {0,2,4,6,8,10}; 


// Copy two elements from arr1 starting from the second element 
// into arr2 starting at the fourth element: 
System. arraycopy( 
arri, 
1, // Second element. 
arr2, 
3, // Fourth element. 
2 // Length = 2. 
)3 
// Display the new array (arr2): 


for (int i=@; i<arr2.length; i++) 
System.out.printin("Element #" + i + "= " + arr2[i]); 


/* 


Output: 
Element #0 = 
Element #1 = 
Element #2 = 
Element #3 = 
Element #4 = 
Element #5 = 10 
*] 


WN ABN © 





Remarks 

Throws java.lang.ArrayIndexOutOfBoundsException if any of the following conditions is true: 
dst or src is an empty array. 

src_position is negative 

dst_position is negative. 

length is negative. 


See Also 
Reference 
System Class 
Concepts 

System Members 
java.lang Package 





Visual J# Reference 


System.currentTimeMillis Method 


Retrieves the current time in milliseconds 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static long currentTimeMillis(); 





Return Value 


A long value that represents the current time in milliseconds. 


Example a 








// sys-crntime.jsl 
// System.currentTimeMillis example 
public class MyClass 
{ 
public static void main(String[] args) 
if 
System.out.print(System.currentTimeMillis()); 
} 
} 
/* 
1094596466359 
*/ 
See Also 
Reference 
System Class 
Concepts 


System Members 
java.lang Package 
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System.exit Method 


Terminates the current application and exits with a specified status code. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static void exit( 
int status); 


Parameters 
status 


An int indicating the status code. 
Remarks 
Usually, the status code 0 indicates normal exit. 


See Also 
Reference 
System Class 
Concepts 

System Members 
java.lang Package 
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System.gc Method 


Invokes the garbage collector. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static void gc(); 


Example ——___________________c_____§_=, 


// sys-gc1.jsl 
// System.gc example 


public class MyClass 


public static void main(String[] args) 


{ 
System.gc(); 
System.out.println("Cleanup done!"); 


} 


/* 
Output: 
Cleanup done! 


7 








See Also 
Reference 
System Class 
Concepts 

System Members 
java.lang Package 
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System.getenv Method 


This method is replaced by getProperty. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.String getenv( 
java.lang.String name); 


Parameters 
name 


The variable name. 


See Also 
Reference 
System Class 
Concepts 

System Members 
java.lang Package 
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System.getProperties Method 


Retrieves the current system properties. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.util.Properties getProperties(); 


Return Value 
The current system properties. 
Example 


// sys-getProps1.jsl 
// System.getProperties example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
System.out.println(System.getProperties()); 
} 
} 
/* 
Output: 


{com.ms.locale.variant=, user.region=US, file.separator=\, file.encoding=Cp1252, 
browser=ActiveX Scripting Host, http.agent=Mozilla/4.@ (compatible; MSIE 6.0; W 
in32), user.name=samabo, user.language=en, jbcu.windowWarning=Warning - J# Brows 
er Control window, line.separator= 
» awt.toolkit=com.ms.vjsharp.windowing.win32.Win32Toolkit, os.arch=x86, os.name= 
Windows XP, com.ms.windir=C:\WINDOWS, os.version=5.1, com.ms.sysdir=C: \WINDOWS\S 
ystem32, com.ms.applet.enable.serversockets=false, http.ProxyPort=80, http.Proxy 
Host=//itgproxy, user.home=C:\WINDOWS, path.separator=;, user.dir=C:\jcompiler\L 
ang\System, user.timezone=PST } 


*/ 


See Also 
Reference 
System Class 
Concepts 

System Members 
java.lang Package 
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System.getProperty Method 


Overload List 





Name 


Description 





System.getProperty (String) 


Returns the system property associated with a specified key. 





System.getProperty (String, String) 








Returns the system property associated with a specified key. 





See Also 
Reference 

System Class 
Concepts 

System Members 
java.lang Package 
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System.getProperty Method (String) 


Returns the system property associated with a specified key. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.String getProperty( 
java.lang.String key); 


Parameters 
key 

The key that corresponds to the property. 
Return Value 
The system property specified by key. 
Example 


// sys-getProp1.jsl 
// System.getProperty example 


public class MyClass 


{ 
public static void main(String[] args) 
if 
String s = System.getProperty("os.version") ; 
// Notice that the output of the following statement can be 
// different for different machines: 
System.out.print("The OS version for this machine is: " +s); 
} 
} 
/* 
Output: 
The OS version for this machine is: 5.1 
m/f 
Remarks 


Throws java.lang.|llegalArgumentException if the key is null. 


See Also 
Reference 
System Class 
Concepts 

System Members 
java.lang Package 
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System.getProperty Method (String, String) 


Returns the system property associated with a specified key. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.String getProperty( 
java.lang.String key, 
java.lang.String def); 


Parameters 


key 
The key string. 
def 
The default name of the property. 
Return Value 
The system property associated with key or def if there is no property associated with the specified key. 
Example 


// sys-getProp2.jsl 
// System.getProperty example 


public class MyClass 
{ 


public static void main(String[] args) 


. 
String s1 = System.getProperty("os.name","My default"); 


// Notice that the property key is misspelled here: 
String s2. = System.getProperty("os-name","My default"); 


// Notice that the output of the following statement can be 
// different for different operating systems: 
System.out.println("The OS name is: " + s1); 


// The following statement displays the default property name: 
System.out.println("The OS name is: " + s2); 


r 


/* 

Output: 

The OS name is: Windows XP 
The OS name is: My default 
+f 


Remarks 
Throws java.lang.|llegalArgumentException if the key is null. 


See Also 
Reference 
System Class 
Concepts 

System Members 
java.lang Package 
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System.getSecurityManager Method 


Returns the security manager. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.SecurityManager getSecurityManager(); 


Return Value 
The security manager if it has been set; null otherwise. 
Example 


// sys-getseci.jsl 
// System.getSecurityManager example 


public class MyClass 
{ 


public static void main(String[] args) 


if 
System.out.println(System.getSecurityManager()); 


See Also 
Reference 
System Class 
Concepts 

System Members 
java.lang Package 
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System.identityHashCode Method 


Retrieves the hash code for a specified object. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static int identityHashCode( 
java.lang.Object x); 


Parameters 
x 


The object for which the hash code is retrieved. 
Return Value 
The hash code for the specified object. 
Example 


// sys-idHashCode1.js1l 
// System.identityHashCode example 


public class MyClass 
{ 


public static void main(String[] args) 


if 
int hc = System.identityHashCode(new Double(1.23)); 


System.out.println(hc); 


} 


/* 
Output: 
18643596 
a) 


See Also 
Reference 
System Class 
Concepts 

System Members 
java.lang Package 
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System.load Method 


Loads a specified file. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static void load( 
java.lang.String filename) ; 





Parameters 
filename 


The file to be loaded. 








Example 
// sys-load1.jsl 
// System.load example 
public class MyClass 
public static void main(String[] args) 
{ 
System. load("C:\\Lang\\System\\sys-gc1.exe") ; 
System.out.println("File loaded."); 
} 
} 
/* 
Output: 
File loaded. 
= 
Remarks 


The full path of the file to be loaded must me specified. 
Throws java.lang.UnsatisfiedLinkError if the file does not exist. 


See Also 
Reference 

System Class 
Concepts 

System Members 
java.lang Package 
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System.loadLibrary Method 


Loads a specified library. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static void loadLibrary( 
java.lang.String libname) ; 





Parameters 
libname 


The library to be loaded. 








Example 
// sys-load2.jsl 
// System.load example 
public class MyClass 
public static void main(String[] args) 
{ 
System. load("C:\\assembly\\vjslib.d11"); 
System.out.println("Library loaded."); 
} 
} 
/* 
Output: 
Library loaded. 
= 
Remarks 


The full path of the file to be loaded must me specified. 
Throws java.lang.UnsatisfiedLinkError if the library file does not exist. 


See Also 
Reference 

System Class 
Concepts 

System Members 
java.lang Package 
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System.runFinalization Method 


Runs the finalization methods on objects waiting to be finalized. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static void runFinalization(); 


Example OOOO 


// sys-runF1.jsl 
// System.runFinalization example 


public class MyClass 


public static void main(String[] args) 


{ 


System.runFinalization() ; 
System.out.println("Cleanup done!"); 


} 


/* 
Output: 
Cleanup done! 
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See Also 
Reference 
System Class 
Concepts 

System Members 
java.lang Package 
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System.runfinalizersOnExit Method 


Runs the garbage collection when the application exits. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static void runFinalizersOnExit( 
boolean value); 


Parameters 
value 


A value to indicate the 
Example 


// sys-runF2.jsl 
// System.runFinalizersOnExit example 


public class MyClass 


public static void main(String[] args) 


{ 


System.runFinalizersOnExit (true) ; 
System.out.println("Cleanup done!"); 


} 


/* 
Output: 
Cleanup done! 


*/ 


See Also 
Reference 
System Class 
Concepts 

System Members 
java.lang Package 
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System.setErr Method 


Sets the standard error stream to a custom error stream.. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final void setErr( 
java.io.PrintStream errStream) ; 


Parameters 
errStream 

The custom error stream. 
Example 


// sys-seEr1.jsl 
// System.setErr example 


import java.io.*; 


public class MyClass 


{ 
public static void main(String[] args) throws java.io. IOException 
{ 
// Create a file: 
System.setErr(new PrintStream( 
new FileOutputStream("MyErrorFile.txt"))); 
// Redirect the output to the file: 
System.err.printin("Hello to custom error stream!"); 
} 
} 
See Also 
Reference 
System Class 
Concepts 


System Members 
java.lang Package 
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System.setin Method 


Sets the standard input stream to a custom input stream. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final void setIn( 
java.io.InputStream inStream) ; 


Parameters 
inStream 


The custom input stream. 
Example 


In this example, you create a text file (InputFile.txt) that contains some numbers and the character 'E' at the end. Then you 
assign this file to the input stream, read the first char, and keep reading from the file until the char 'E' is encountered. 


// System.setIn example 
import java.io.*; 


public class MyClass 
+ 


public static void main(String[] args) throws java.io. IOException 


{ 


// Assign an existing input file to input stream: 
System.setIn(new FileInputStream("InputFile.txt")); 


// Read the first char in the file: 
int oneByteFromInFile = (char)System.in.read(); 


// Read and display chars until you encounter 'E': 
while (oneByteFromInFile != 'E') 


{ 
System.out.print((char)oneByteFromInFile + " "); 


oneByteFromInFile = (char)System.in.read(); 


} 


// Display a success message: 
System.out.println("\nAll chars have been read!"); 


} 


/* 

Output: 

123456789 

All chars have been read! 


*/ 


Remarks 
The method is successful if there are no security restrictions on re-assigning the input stream. 


See Also 
Reference 
System Class 
Concepts 

System Members 
java.lang Package 
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System.setOut Method 


Sets the standard output stream to a custom output stream. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static final void setOut( 
java.io.PrintStream outStream) ; 


Parameters 
outStream 
The custom output stream. 
Example 
In this example, you create the file MyOutputFile.txt and redirect the output to this file. After you run the program you can 


examine the contents of the file. 


// sys-seto1.jsl 
// System.setout example 


import java.io.*; 


public class MyClass 


x 
public static void main(String[] args) throws java.io. IOException 
{ 
// Create a file: 
System.setOut(new PrintStream( 
new FileOutputStream("MyOutputFile.txt"))); 
// Redirect the output to the file: 
System.out.println("Hello to custom output stream!"); 
} 
} 
Remarks 


The method is successful if there are no security restrictions on re-assigning the output stream. 


See Also 
Reference 
System Class 
Concepts 

System Members 
java.lang Package 
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System.setProperties Method 


Sets the system properties using a specified parameter. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static void setProperties( 
java.util.Properties props); 


Parameters 
props 
The new system properties. 


Example 


// sys-setprop1.jsl 
// System.setProperties example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
Properties p = new Properties(); 
// Set system properties using the newly allocated variable: 
System.setProperties(p); 
// The following statement is equivalent to 
// System.out.println(p). Both print an empty 
// set of properties: 
System.out.println(System.getProperties()); 
} 
} 
/* 
Output: 
{} 
*/ 
See Also 
Reference 
System Class 
Concepts 


System Members 
java.lang Package 
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System.setSecurityManager Method 


NOTE: This Method is now obsolete. 
Sets the security manager. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public static void setSecurityManager( 
java.lang.SecurityManager s); 


Parameters 
S 


The name of the security manager. 


See Also 
Reference 
System Class 
Concepts 

System Members 
java.lang Package 
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Throwable Class 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang. Throwable 
extends java.lang.Object 
implements java.io.Serializable 





Inheritance Hierarchy 
java.lang.Object 
Exception 


java.lang.Throwable 


com.ms.vjsharp.lang.ThrowableWrapper 


java.lang.Error 


java.lang.Exception 


See Also 
Concepts 

Throwable Members 
java.lang Package 
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Throwable Members 


The following tables list the members exposed by the Throwable type. 


Public Constructors 
Name 


Throwable 





Public Properties (see also Protected Properties ) 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 
Message 
Source 
StackTrace 


TargetSite 


Protected Properties 


(inherited from Exception ) 


(inherited from Exception ) 


(inherited from Exception ) 


(inherited from Exception ) 


(inherited from Exception ) 





Name 


Description 





HResult 





(inherited from Exception ) 





Public Methods 
Name 


<exceptFilter> 


equals 


filllnStackTrace 


GetBaseException 


hashCode 


getLocalizedMessage 


Description 


(inherited from Object ) 


(inherited from Exception ) 


(inherited from Object ) 











getMessage 

GetObjectData Overridden. 

getClass (inherited from Object ) 
clone 





printStackTrace 





Overloaded. 











toString 


Overridden. 





Protected Methods 
Name 


finalize 





See Also 
Reference 
Throwable Class 
Concepts 
java.lang Package 





(inherited from Object ) 
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Throwable Constructor 


Overload List 





Name 


Description 





Throwable () 





Throwable (String) 





Throwable (SerializationInfo, StreamingContext) 





Throwable (String, Exception) 











See Also 
Reference 
Throwable Class 
Concepts 

Throwable Members 
java.lang Package 
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Throwable Constructor () 


Initializes a new instance of the Throwable Class . 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.Throwable(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
Throwable Class 
Concepts 

Throwable Members 
java.lang Package 
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Throwable Constructor (String) 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Throwable( 
java.lang.String message) ; 


Parameters 
message 


See Also 

Reference 
Throwable Class 
Concepts 

Throwable Members 
java.lang Package 


Visual J# Reference 


Throwable Constructor (SerializationInfo, StreamingContext) 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java. lang. Throwable( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


context 


See Also 

Reference 
Throwable Class 
Concepts 

Throwable Members 
java.lang Package 
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Throwable Constructor (String, 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Throwable( 
java.lang.String message, 
System.Exception innerEx) ; 


Parameters 
message 


innerEx 


See Also 

Reference 
Throwable Class 
Concepts 

Throwable Members 
java.lang Package 


Exception) 
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Throwable Methods 


Public Methods 





Name Description 





<exceptFilter> 





equals (inherited from Object ) 





filllnStackTrace 





GetBaseException (inherited from Exception ) 





hashCode (inherited from Object ) 


getLocalizedMessage 


getMessage 

GetObjectData Overridden. 

getClass (inherited from Object ) 
clone 

printStackTrace Overloaded. 

toString Overridden. 





Protected Methods 





Name Description 





finalize (inherited from Object ) 














See Also 
Reference 
Throwable Class 
Concepts 
java.lang Package 
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Throwable.filllnStackTrace Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Throwable fillInStackTrace(); 


See Also 

Reference 
Throwable Class 
Concepts 

Throwable Members 
java.lang Package 


Visual J# Reference 


Throwable.getLocalizedMessage Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getLocalizedMessage(); 


See Also 

Reference 
Throwable Class 
Concepts 

Throwable Members 
java.lang Package 
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Throwable.getMessage Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getMessage(); 


See Also 

Reference 
Throwable Class 
Concepts 

Throwable Members 
java.lang Package 
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Throwable.GetObjectData Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public void GetObjectData( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


context 


See Also 

Reference 
Throwable Class 
Concepts 

Throwable Members 
java.lang Package 
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Throwable.printStackTrace Method 


Overload List 





Name Description 





Throwable.printStackTrace () 





Throwable.printStackTrace (PrintStream) 





Throwable.printStackTrace (PrintWriter) 











See Also 
Reference 
Throwable Class 
Concepts 

Throwable Members 
java.lang Package 
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Throwable.printStackTrace Method () 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public void printStackTrace(); 


See Also 

Reference 
Throwable Class 
Concepts 

Throwable Members 
java.lang Package 
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Throwable.printStackTrace Method (PrintStream) 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public void printStackTrace( 
java.io.PrintStream s); 


Parameters 
Ss 


See Also 

Reference 
Throwable Class 
Concepts 

Throwable Members 
java.lang Package 
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Throwable.printStackTrace Method (PrintWriter) 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public void printStackTrace( 
java.io.PrintwWriter wr); 


Parameters 
wr 


See Also 

Reference 
Throwable Class 
Concepts 

Throwable Members 
java.lang Package 
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Throwable.toString Method 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toString(); 


See Also 

Reference 
Throwable Class 
Concepts 

Throwable Members 
java.lang Package 
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Throwable Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 
Throwable Class 
Concepts 
java.lang Package 
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UnknowneError Class 


An error that is issued when an unknown error occurs. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.UnknownError 
extends java.lang.VirtualMachineError 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Error 
java.lang.VirtualMachineError 
java.lang.UnknownError 


See Also 

Concepts 

UnknownError Members 
java.lang Package 
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UnknownError Members 


An error that is issued when an unknown error occurs. 


The following tables list the members exposed by the UnknownError type. 


Public Constructors 





Name 


Description 





UnknownError 


Overloaded. Constructs a UnknownError object. 








Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 





Description 


(inherited from Exception ) 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 








printStackTrace 





getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 

clone (inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 








toString 


(inherited from Throwable ) 





Protected Methods 
Name 


finalize 





See Also 
Reference 
UnknownError Class 
Concepts 

java.lang Package 





(inherited from Object ) 
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UnknownError Constructor 


Constructs a UnknownError object. 


Overload List 


Name Description 
UnknownError () Constructs a UnknownError object without a specified text message. 
UnknowneError (String) Constructs a UnknownError object with a specified text message. 


UnknownError (SerializationInfo, StreamingContext) |Constructs a UnknownError object during serialization. 








UnknownError (String, Exception) a UnknownError object with a specific text message and inner exception. 








See Also 

Reference 
UnknownError Class 
Concepts 

UnknownError Members 
java.lang Package 
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UnknownError Constructor () 


Constructs a UnknownError object without a specified text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.UnknownError(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
UnknownError Class 
Concepts 

UnknownError Members 
java.lang Package 
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UnknownError Constructor (String) 


Constructs a UnknownError object with a specified text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java. lang.UnknownError( 
java.lang.String s); 


Parameters 
Ss 


The string that contains the message text. 


See Also 

Reference 
UnknownError Class 
Concepts 

UnknownError Members 
java.lang Package 
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UnknownError Constructor (SerializationInfo, 
StreamingContext) 


Constructs a UnknownError object during serialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java. lang.UnknownError( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information required for serializing an object. 
context 
The source or destination for the serialization. 


See Also 

Reference 
UnknownError Class 
Concepts 

UnknownError Members 
java.lang Package 
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UnknownError Constructor (String, Exception) 


a UnknownError object with a specific text message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java. lang.UnknownError( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


The string that contains the message text. 
inner 
The inner exception that led to UnknownError. 


See Also 

Reference 
UnknownError Class 
Concepts 

UnknownError Members 
java.lang Package 
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UnknownError Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 





Name 


Description 





finalize 








(inherited from Object ) 





See Also 
Reference 
UnknownError Class 
Concepts 

java.lang Package 
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UnknownError Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 
UnknownError Class 
Concepts 

java.lang Package 
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UnsatisfiedLinkError Class 


An error that is issued when the execution engine cannot find the appropriate definition for a declared method. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.UnsatisfiedLinkError 
extends java.lang.LinkageError 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Error 
java.lang.LinkageError 
java.lang.UnsatisfiedLinkError 


See Also 

Concepts 

UnsatisfiedLinkError Members 
java.lang Package 
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UnsatisfiedLinkError Members 


An error that is issued when the execution engine cannot find the appropriate definition for a declared method. 


The following tables list the members exposed by the UnsatisfiedLinkError type. 


Public Constructors 





Name 


Description 





UnsatisfiedLinkError 


Overloaded. Constructs an UnsatisfiedLinkError object. 








Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 





Description 


(inherited from Exception ) 





Name 


Description 





<exceptFilter> 


Maps an error object to an UnsatisfiedLinkError object. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 





getMessage 


GetObjectData 


getClass 


clone 





(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 











printStackTrace 


Overloaded. (inherited from Throwable ) 





toString 


Protected Methods 





(inherited from Throwable ) 





Name 


Description 





finalize 








(inherited from Object ) 





See Also 

Reference 
UnsatisfiedLinkError Class 
Concepts 

java.lang Package 
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UnsatisfiedLinkError Constructor 


Constructs an UnsatisfiedLinkError object. 


Overload List 





Name Description 

UnsatisfiedLinkError () Constructs an UnsatisfiedLinkError object without a specific text me 
ssage. 

UnsatisfiedLinkError (String) Constructs an UnsatisfiedLinkError object with a specific text messa 
ge. 


UnsatisfiedLinkError (SerializationInfo, StreamingContext)|Constructs an UnsatisfiedLinkError object during serialization. 


UnsatisfiedLinkError (String, Exception) Constructs an UnsatisfiedLinkError object with a specific text messa 
ge and inner exception. 





See Also 

Reference 
UnsatisfiedLinkError Class 
Concepts 

UnsatisfiedLinkError Members 
java.lang Package 
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UnsatisfiedLinkError Constructor () 


Constructs an UnsatisfiedLinkError object without a specific text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.UnsatisfiedLinkError(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
UnsatisfiedLinkError Class 
Concepts 

UnsatisfiedLinkError Members 
java.lang Package 
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UnsatisfiedLinkError Constructor (String) 


Constructs an UnsatisfiedLinkError object with a specific text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.UnsatisfiedLinkError( 
java.lang.String s); 


Parameters 
Ss 


The string that contains the message text. 


See Also 

Reference 
UnsatisfiedLinkError Class 
Concepts 

UnsatisfiedLinkError Members 
java.lang Package 
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UnsatisfiedLinkError Constructor (SerializationInfo, 
StreamingContext) 


Constructs an UnsatisfiedLinkError object during serialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java.lang.UnsatisfiedLinkError( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information required for serializing an object 
context 
The source or destination for the serialization. 


See Also 

Reference 
UnsatisfiedLinkError Class 
Concepts 

UnsatisfiedLinkError Members 
java.lang Package 
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UnsatisfiedLinkError Constructor (String, Exception) 


Constructs an UnsatisfiedLinkError object with a specific text message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.UnsatisfiedLinkError( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


The string that contains the message text. 
inner 
The inner exception that led to UnsatisfiedLinkError. 


See Also 

Reference 
UnsatisfiedLinkError Class 
Concepts 

UnsatisfiedLinkError Members 
java.lang Package 
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UnsatisfiedLinkError Methods 


Public Methods 





Name 


Description 





<exceptFilter> 


Maps an error object to an UnsatisfiedLinkError object. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 


Protected Methods 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 




















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


UnsatisfiedLinkError Class 


Concepts 
java.lang Package 
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UnsatisfiedLinkError Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
UnsatisfiedLinkError Class 
Concepts 

java.lang Package 
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UnsupportedOperationException Class 


An exception that is thrown when an application tries to perform an unsupported operation. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.UnsupportedOperationException 
extends java. lang.RuntimeException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.lang.RuntimeException 
java.lang.UnsupportedOperationException 


See Also 

Concepts 

UnsupportedOperationException Members 
java.lang Package 
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UnsupportedOperationException Members 


An exception that is thrown when an application tries to perform an unsupported operation. 


The following tables list the members exposed by the UnsupportedOperationException type. 


Public Constructors 





Name 


Description 





UnsupportedOperationException Overloaded. Constructs a UnsupportedOperationException object. 








Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 





Description 


(inherited from Exception ) 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 








printStackTrace 





getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 

clone (inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 








toString (inherited from Throwable ) 





Protected Methods 
Name 








finalize (inherited from Object ) 
See Also 

Reference 

UnsupportedOperationException Class 

Concepts 


java.lang Package 
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UnsupportedOperationException Constructor 


Constructs a UnsupportedOperationException object. 


Overload List 
Name Description 


UnsupportedOperationException () Constructs a UnsupportedOperationException object wi 
thout a specified text message. 





UnsupportedOperationException (String) Constructs a UnsupportedOperationException object wi 
th a specified text message. 


UnsupportedOperationException (SerializationInfo, StreamingContext)|Constructs a UnsupportedOperationException object d 
uring serialization. 


UnsupportedOperationException (String, Exception) Constructs a UnsupportedOperationException object wi 
th a specific text message and inner exception. 











See Also 

Reference 
UnsupportedOperationException Class 
Concepts 

UnsupportedOperationException Members 
java.lang Package 
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UnsupportedOperationException Constructor () 


Constructs a UnsupportedOperationException object without a specified text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.UnsupportedOperationException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
UnsupportedOperationException Class 
Concepts 

UnsupportedOperationException Members 
java.lang Package 
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UnsupportedOperationException Constructor (String) 


Constructs a UnsupportedOperationException object with a specified text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.UnsupportedOperationException( 


java.lang.String s); 
| 


Parameters 
Ss 


The string that contains the message text. 


See Also 

Reference 
UnsupportedOperationException Class 
Concepts 

UnsupportedOperationException Members 
java.lang Package 
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UnsupportedOperationException Constructor 
(SerializationInfo, StreamingContext) 


Constructs a UnsupportedOperationException object during serialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java. lang.UnsupportedOperationException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information required for serializing an object. 
context 
The source or destination for the serialization. 


See Also 

Reference 
UnsupportedOperationException Class 
Concepts 

UnsupportedOperationException Members 
java.lang Package 
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UnsupportedOperationException Constructor (String, 
Exception) 


Constructs a UnsupportedOperationException object with a specific text message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.UnsupportedOperationException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


The string that contains the message text. 
inner 
The inner exception that led to UnsupportedOperationException. 


See Also 

Reference 
UnsupportedOperationException Class 
Concepts 

UnsupportedOperationException Members 
java.lang Package 
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UnsupportedOperationException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


UnsupportedOperationException Class 


Concepts 
java.lang Package 
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UnsupportedOperationException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 


UnsupportedOperationException Class 


Concepts 
java.lang Package 
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VerifyError Class 


An error issued when the execution engine cannot verify a class code because it contains issues related to class format 
semantics. 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public class java.lang.VerifyError 
extends java.lang.LinkageError 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Error 
java.lang.LinkageError 
java.lang.VerifyError 


See Also 

Concepts 

VerifyError Members 
java.lang Package 
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VerifyError Members 


An error issued when the execution engine cannot verify a class code because it contains issues related to class format 
semantics. 


The following tables list the members exposed by the VerifyError type. 


Public Constructors 





Overloaded. Constructs a VerifyError object. 


Public Properties (see also Protected Properties ) 








Name Description 

HelpLink (inherited from Exception ) 
InnerException (inherited from Exception ) 
Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Protected Properties 
Name Description 








HResult (inherited from Exception ) 








Public Methods 














Name Description 

<exceptFilter> Maps an error object to a VerifyError object. 
equals (inherited from Object ) 
filllnStackTrace (inherited from Throwable ) 
GetBaseException (inherited from Exception ) 
hashCode (inherited from Object ) 
getLocalizedMessage (inherited from Throwable ) 
getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 
clone (inherited from Throwable ) 

















printStackTrace Overloaded. (inherited from Throwable ) 





toString (inherited from Throwable ) 








Protected Methods 
Name 


finalize (inherited from Object ) 








See Also 
Reference 
VerifyError Class 
Concepts 
java.lang Package 
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VerifyError Constructor 


Constructs a VerifyError object. 


Overload List 


Name Description 
VerifyError () Constructs a VerifyError object without a specified text message. 
VerifyError (String) Constructs a VerifyError object with a specified text message. 


VerifyError (SerializationInfo, StreamingContext)|Constructs VerifyError object during serialization. 





VerifyError (String, Exception) Constructs a VerifyError object with a specific text message and inner excepti 
on. 

See Also 

Reference 

VerifyError Class 

Concepts 


VerifyError Members 
java.lang Package 
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VerifyError Constructor () 


Constructs a VerifyError object without a specified text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public java.lang.VerifyError(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
VerifyError Class 
Concepts 

VerifyError Members 
java.lang Package 
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VerifyError Constructor (String) 


Constructs a VerifyError object with a specified text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.VerifyError( 
java.lang.String s); 


Parameters 
Ss 


The string that contains the message text. 


See Also 

Reference 
VerifyError Class 
Concepts 

VerifyError Members 
java.lang Package 
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VerifyError Constructor (SerializationInfo, StreamingContext) 


Constructs VerifyError object during serialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java. lang.VerifyError ( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information required for serializing an object. 
context 
The source or destination for the serialization. 


See Also 

Reference 
VerifyError Class 
Concepts 

VerifyError Members 
java.lang Package 
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VerifyError Constructor (String, Exception) 


Constructs a VerifyError object with a specific text message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.VerifyError( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


The string that contains the message text. 
inner 
The inner exception that led to VerifyError. 


See Also 

Reference 
VerifyError Class 
Concepts 

VerifyError Members 
java.lang Package 
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VerifyError Methods 


Public Methods 









































Name Description 

<exceptFilter> Maps an error object to a VerifyError object. 
equals (inherited from Object ) 

filllnStackTrace (inherited from Throwable ) 
GetBaseException (inherited from Exception ) 

hashCode (inherited from Object ) 
getLocalizedMessage (inherited from Throwable ) 

getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 

getClass (inherited from Object ) 

clone (inherited from Throwable ) 
printStackTrace Overloaded. (inherited from Throwable ) 
toString (inherited from Throwable ) 
Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 

VerifyError Class 

Concepts 


java.lang Package 
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VerifyError Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 
VerifyError Class 
Concepts 
java.lang Package 
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VirtualMachineError Class 


An error issued to indicate that there is a problem with the execution engine. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public class java.lang.VirtualMachineError 
extends java.lang.Error 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Error 
java.lang.VirtualMachineError 
java.lang.InternalError 
java.lang.OutOfMemoryError 
java.lang.StackOverflowError 
java.lang.UnknownError 


See Also 

Concepts 

VirtualMachineError Members 
java.lang Package 
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VirtualMachineError Members 


An error issued to indicate that there is a problem with the execution engine. 


The following tables list the members exposed by the VirtualMachineError type. 


Public Constructors 





Name 


Description 





VirtualMachineError 


Overloaded. Constructs a VirtualMachineError object. 





Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 





Description 


(inherited from Exception ) 





Name 


Description 





<exceptFilter> 


Maps an error object to a VirtualMachineError object. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 





getMessage 


GetObjectData 


getClass 


clone 





(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 








printStackTrace 


Overloaded. (inherited from Throwable ) 





toString 


Protected Methods 





(inherited from Throwable ) 





Name 


Description 





finalize 








(inherited from Object ) 








See Also 

Reference 
VirtualMachineError Class 
Concepts 

java.lang Package 
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VirtualMachineError Constructor 


Constructs a VirtualMachineError object. 


Overload List 





Name Description 

VirtualMachineError () Constructs a VirtualMachineError object without a specified text me 
ssage. 

VirtualMachineError (String) Constructs a VirtualMachineError object with a specified text messa 
ge. 


VirtualMachineError (SerializationInfo, StreamingContext)/Constructs a VirtualMachineError object during serialization. 


VirtualMachineError (String, Exception) Constructs a VirtualMachineError object with a specific text message 
and inner exception. 











See Also 

Reference 
VirtualMachineError Class 
Concepts 

VirtualMachineError Members 
java.lang Package 
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VirtualMachineError Constructor () 


Constructs a VirtualMachineError object without a specified text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.VirtualMachineError(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
VirtualMachineError Class 
Concepts 

VirtualMachineError Members 
java.lang Package 
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VirtualMachineError Constructor (String) 


Constructs a VirtualMachineError object with a specified text message. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.VirtualMachineError( 
java.lang.String s); 


Parameters 
Ss 


The string that contains the message text. 


See Also 

Reference 
VirtualMachineError Class 
Concepts 

VirtualMachineError Members 
java.lang Package 
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VirtualMachineError Constructor (SerializationInfo, 
StreamingContext) 


Constructs a VirtualMachineError object during serialization. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


protected java. lang.VirtualMachineError( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information required for serializing an object. 
context 
The source or destination for the serialization. 


See Also 

Reference 
VirtualMachineError Class 
Concepts 

VirtualMachineError Members 
java.lang Package 
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VirtualMachineError Constructor (String, Exception) 


Constructs a VirtualMachineError object with a specific text message and inner exception. 
Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public java.lang.VirtualMachineError( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


The string that contains the message text. 
inner 
The inner exception that led to VirtualMachineError. 


See Also 

Reference 
VirtualMachineError Class 
Concepts 

VirtualMachineError Members 
java.lang Package 
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VirtualMachineError Methods 


Public Methods 





Name 


Description 





<exceptFilter> 


Maps an error object to a VirtualMachineError object. 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 


Protected Methods 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


VirtualMachineError Class 


Concepts 
java.lang Package 
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VirtualMachineError Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
VirtualMachineError Class 
Concepts 

java.lang Package 
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Void Class 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 


public final class java.lang.Void 
extends java.lang.Object 





Inheritance Hierarchy 
java.lang.Object 
java.lang.Void 


See Also 
Concepts 

Void Members 
java.lang Package 
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Void Members 


The following tables list the members exposed by the Void type. 


Public Fields 


Name Description 


TYPE 





Public Methods 











Name Description 
equals (inherited from Object ) 
hashCode (inherited from Object ) 
getClass (inherited from Object ) 
toString Overridden. 








Protected Methods 
MemberwiseClone 


Performs a shallow copy of the object. 


See Also 
Reference 

Void Class 
Concepts 
java.lang Package 
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Void Fields 


Public Fields 





Name Description 








TYPE 











See Also 
Reference 

Void Class 
Concepts 
java.lang Package 
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Void. TYPE Field 


Package: java.lang 


Assembly: vjslib (in vjslib.dll) 





public static final java.lang.Class TYPE; 





See Also 
Reference 

Void Class 
Concepts 

Void Members 
java.lang Package 
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Void Methods 


Public Methods 























Name Description 
equals (inherited from Object ) 
hashCode (inherited from Object ) 
getClass (inherited from Object ) 
toString Overridden. 





Protected Methods 
MemberwiseClone 


Performs a shallow copy of the object. 


See Also 
Reference 

Void Class 
Concepts 
java.lang Package 
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java.lang.Class 


Represents class types and interface types. Using this class, you can determine the constructors, methods, fields, and other 
information of a type at runtime. 


J# 
public final class Class implements Serializable 


Example 


// class_overview.jsl 
import java.lang.reflect.*; 


public class Program 
< 
public static void main(String[] args) 
{ 
// Get the Class object associated with 
// “java.lang.String”. 
try 
{ 


Class stringClass = Class.forName("java.lang.String"); 


System.out.println("Class found: + 
stringClass.getName()); 


// Get the Class object associated with "Program". 
Class thisClass = Class.forName("Program") ; 


// Get the name of this class. 
String name = thisClass.getName(); 
System.out.println("\nThis class name: 


+ name) ; 


// Get all the public Class objects associated with the 
// Program class. 

Class[] classes = thisClass.getClasses(); 
System.out.println(); 

for (int i = @; i < classes.length; i++) 


{ 


System.out.println("Class found: + 
classes[i].getName()); 


} 


// Get all the Class objects associated with the 
// Program class. 

classes = thisClass.getDeclaredClasses(); 
System.out.println(); 

for (int i = @; i < classes.length; i++) 


{ 


System.out.println("Class found: + 
classes[i].getName()); 


} 


// Get all the public constructors for ths class. 
Constructor[] ctors = thisClass.getConstructors(); 
System.out.println(); 

for (int i = @; i < ctors.length; i++) 


{ 


System.out.println("Public constructor found: + 
ctors[i].toString()); 


} 


// Get all the constructors for ths class. 
ctors = thisClass.getDeclaredConstructors(); 


System.out.println(); 
for (int i = @; i < ctors.length; i++) 


{ 


System.out.println("Constructor found: + 
ctors[i].toString()); 
} 


// Get all the public fields associated with this class. 
Field[] fields = thisClass.getFields(); 
System.out.println(); 

for (int i = @; i < fields.length; i++) 

{ 


System.out.println("Public field found: + 
fields[i].toString()); 


} 


// Get all the fields associated with this class. 
fields = thisClass.getDeclaredFields(); 
System.out.println(); 

for (int i = @; i < fields.length; i++) 

{ 


System.out.println("Field found: + 
fields[i].toString()); 


} 


// Get the public methods associated with this class. 
Method[] methods = thisClass.getMethods(); 
System.out.println(); 

for (int i = @; i < methods.length; i++) 


{ 


System.out.println("Public method found: + 
methods[i].toString()); 
} 


// Get all the methods associated with this class. 
methods = thisClass.getDeclaredMethods() ; 
System.out.println(); 

for (int i = @; i < methods.length; i++) 


a 


System.out.println("Method found: + 


methods[i].toString()); 
} 


// Get the interfaces associated with this class. 
Class[] interfaces = thisClass.getInterfaces(); 
System.out.println(); 

for (int i = @; i < interfaces.length; i++) 


{ 


System.out.println("Interface found: + 
interfaces[i].toString()); 
} 


// Get the modifiers for this class. 
int i = thisClass.getModifiers(); 
String mods = Modifier.toString(i); 
System.out.println("\nClass modifiers: 


+ mods); 


// Get the super class of this class. 
Class superClass = thisClass.getSuperclass(); 


System.out.println("\nSuper class name: + 
superClass.getName()); 


catch (ClassNotFoundException ex) 


{ 
} 


System.out.println(ex.toString()); 


public class InnerPublicClass 


{ 


} 


public InnerPublicClass() 


it 
} 


private class InnerPrivateClass 


} 
} 
/* 
Output: 


public InnerPrivateClass() 


{ 
} 


Class found: java.lang.String 


This class name: Program 


Class found: Program$InnerPublicClass 


Class found: Program$InnerPublicClass 
Class found: Program$InnerPrivateClass 


Public constructor found: public Program() 


Constructor found: public Program() 


Public 
Public 


method found: public 
method found: public 


Public method found: public 
Public method found: public 
Exception 

Public method found: public 
ptedException 

Public method found: public 
erruptedException 

Public method found: public 


Public 
Public 
Public 


Method 


method found: public 
method found: public 
method found: public 


found: public static 


final 
final 
final 
final 


final 


final 


java.lang 
void java 
void java 
void java 


void java 


void java 


.Class java.lang.Object. getClass() 
.lang.Object.notify() 

.lang.Object.notifyA11() 

.lang.Object.wait() throws java.lang.Interrupted 


.lang.Object.wait(long) throws java.lang.Interru 


.lang.Object.wait(long,int) throws java.lang.Int 


static void Program.main(java.lang.String[ ]) 
java.lang.String java.lang.Object.toString() 
boolean java.lang.Object.equals(java.lang.Object) 
int java.lang.Object.hashCode() 


void Program.main(java.lang.String[ ]) 


Class modifiers: public synchronized 


Super class name: java.lang.Object 


ow | 
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java.lang.Class.forName(String className) 


Gets a bf6c9478-b86e-41e1 -b8c9-4837291 2df0a object for a given class name. 


J# 


public static java.lang.Class forName(java.lang.String className) 





Parameters 
Paramet |Description 
er 









classNa_ |The fully qualified name (package plus class name) of a class. A ccdb1072-df6f-4c83-8eb8-ccd08a9e57d1 is thrown 
if this name is invalid. 








Property Value/Return Value 
A bf6c9478-b86e-41e1-b8c9-48372912df0a object for the given class name. 


Example OO _______________ct_t______¥#_ 











// class_forname1.jsl 
public class Program 
public static void main(String[] args) 
{ 
try 
{ 
// Get the Class object associated with 
// “java.lang.String”. 
Class stringClass = Class.forName("java.lang.String") ; 
System.out.printlin("Class found: " + 
stringClass.getName()); 
catch (ClassNotFoundException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 
} 
/* 
Output: 
Class found: java.lang.String 
af 
See Also 
Reference 


java.lang.Class 
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java.lang.Class.forName(String assemblyName, String 
className, boolean absolutePath) 


Gets a bf6c9478-b86e-41e1 -b8c9-48372912df0a object for a given class name in an assembly. 


J# 





public static java.lang.Class forName(java.lang.String assemblyName, java.lang.String class 
Name, boolean absolutePath) 





Parameters 
Parameter |Description 


assemblyNa |The assembly that contains the class. 
me 


className _ |The fully qualified name (package plus class name) of a class. A ccdb1072-df6f-4c83-8eb8-ccd08a9e57d1 is thro 
wn if this name is invalid. 





absolutePat |true if assemblyName is an absolute path; false otherwise. 
h 








Property Value/Return Value 
A bf6c9478-b86e-41e1-b8c9-48372912df0a object for the given class name. 

















Example 
// class_forname2.jsl 
public class Program 
sf 
public static void main(String[] args) 
i 
try 
{ 

// Get the Class object associated with 

// “java.lang.String”. 

Class stringClass = Class. forName( 
"C:\\WINNT\\Microsoft.NET\\Framework\\v2.0.40903\\vjslib.d1l", 
"java.lang.String", true); 

System.out.println("Class found: " + 
stringClass.getName()); 

catch (ClassNotFoundException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 
} 
/* 
Output: 
Class found: java.lang.String 
of 
See Also 
Reference 


java.lang.Class 


Visual J# Reference 


java.lang.Class.getClasses() 


Gets all the public classes defined within the current class. 


J# 
public java.lang.Class[ ] getClasses() 


Property Value/Return Value 


An array of bf6c9478-b86e-41e1-b8c9-48372912df0a objects representing all the public classes defined within the current 
class. 


Example 


// class_getclasses.jsl 


public class Program 


{ 
public static void main(String[] args) 
{ 
try 
{ 
// Get the Class object associated with "Program". 
Class thisClass = Class. forName("Program") ; 
// Get all the public Class objects associated with the 
// Program class. 
Class[] classes = thisClass.getClasses(); 
for (int i = @; i < classes.length; i++) 
{ 
System.out.printlin("Class found: " + 
classes[i].getName()); 
} 
catch (ClassNotFoundException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
public class InnerPublicClass 
{ 
public InnerPublicClass() 
{ 
} 
} 
private class InnerPrivateClass 
{ 
public InnerPrivateClass() 
{ 
} 
} 
} 
/ * 
Output: 
Class found: Program$InnerClass 
nf 
See Also 
Reference 


java.lang.Class 


Visual J# Reference 


java.lang.Class.getClassLoader() 


Gets the java.lang.Class object associated with a java.lang.Class object. 


J# 
public java.lang.ClassLoader getClassLoader() 


Property Value/Return Value 
The Loader object associated with a java.lang.Class object, or null if the default system class was used. 
Example 


// class_getclassloader.jsl 


public class Program 


{ 
public static void main(String[] args) 
if 
try 
{ 
// Get the Class object associated with "java.lang.String". 
Class stringClass = Class.forName("java.lang.String"); 
// Get the ClassLoader object associated with this Class. 
ClassLoader loader = stringClass.getClassLoader(); 
if (loader == null) 
{ 
System.out.printlin("The default system class " + 
"was used."); 
} 
else 
{ 
// Nerify that this ClassLoader is associated with the 
// String class. 
Class loaderClass = loader.getClass(); 
System.out.println("Class associated with ClassLoader: " + 
loaderClass.getName()); 
} 
catch (ClassNotFoundException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 
} 
/ * 
Output: 
The default system class was used. 
of 
See Also 
Reference 


java.lang.Class 


Visual J# Reference 


java.lang.Class.getComponentType() 


Gets the component type of an array. 


J# 
public java.lang.Class getComponentType() 


Property Value/Return Value 


A bf6c9478-b86e-41e1 -b8c9-48372912df0a object representing the component type of an array, or null if the type is not an 
array. 


Example 


// class_getcomponentyype.jsl 


public class Program 


{ 


public static void main(String[] args) 
{ 
// Create a String object and an array of String objects. 
String str = "Hello, World!"; 
String[] strArr = new String[] { 
"Hello", "World" 


}3 


// Get the component type for the String. 

Class strClass = str.getClass(); 

Class strClassComp = strClass.getComponentType(); 
if (strClassComp != null) 


{ 


System.out.println("String component type: + 
strClassComp.getName()); 


} 


else 


{ 
} 


System.out.println("String component type is null."); 


// Get the component type for the array of String objects. 
Class strArrClass = strArr.getClass(); 

Class strArrClassComp = strArrClass.getComponentType() ; 

if (strArrClassComp != null) 


{ 


System.out.println("String array component type: + 
strArrClassComp. getName()); 
} 


else 


{ 


System.out.println("String array component type " + 
"is null."); 


} 


/* 

Output: 

String component type is null. 

String array component type: java.lang.String 


oy 


See Also 
Reference 


java.lang.Class 


Visual J# Reference 


java.lang.Class.getConstructor(Class[] parameterTypes) 


Gets the public constructor that takes the given arguments. 


J# 


public java.lang.reflect.Constructor getConstructor(java.lang.Class[ ] parameterTypes) 





Parameters 
Para |Description 
meter 





param |An array of bf6c9478-b86e-41e1 -b8c9-48372912df0a objects representing the arguments to the constructor. A 
eterTy |5c106966-ba6e-4e68-8ed8-e4131d1bebff is thrown if there is no constructor with the given parameter types or if the 
pes __|constructor does not have public access. 








Property Value/Return Value 
A 6350a6f2-aaa4-4243-a87e-bb08980b51a8 object representing the constructor that accepts the given parameter types. 








Example 
// class_getconstructor.jsl 
import java.lang.reflect.Constructor; 
public class Program 
{ 
public static void main(String[] args) 
1 
try 
{ 
// Get the Class object associated with this class. 
Program program = new Program(); 
Class progClass = program.getClass(); 
// Find the constructor that only takes a String. 
Class[] ctorArgs1 = new Class[1]; 
ctorArgs1[@] = String.class; 
Constructor strCtor = progClass.getConstructor(ctorArgs1) ; 
System.out.println("Constructor found: " + 
strCtor.toString()); 
// Find the constructor that takes a String and an int. 
Class[] ctorArgs2 = new Class[2]; 
ctorArgs2[@] = String.class; 
ctorArgs2[1] = Integer.class; 
Constructor strIntCtor = progClass.getConstructor(ctorArgs2) ; 
System.out.println("Constructor found: " + 
strIntCtor.toString()); 
catch (NoSuchMethodException ex) 
{ 
System.out.println("Constructor doesn't exist or is " + 
"not public: " + ex.toString()); 
} 
} 
public Program() 
{ 
} 
public Program(String str) 
i 
this.str = str; 








} 


private Program(String str, Integer i) 
{ 

this.str = str; 

this.i = i; 


} 


private String str = "Hello"; 
private Integer i = new Integer(@); 


} 


/* 

Output: 

Constructor found: public Program(java.lang.String) 

Constructor doesn't exist or is not public: java.lang.NoSuchMethodException 


*/ 


See Also 
Reference 
java.lang.Class 


Visual J# Reference 


java.lang.Class.getConstructors() 


Gets all the public constructors for a given bf6c9478-b86e-41e1 -b8c9-4837291 2df0a object. 


J# 
public java.lang.reflect.Constructor[ ] getConstructors() 


Property Value/Return Value 
An array of 6350a6f2-aaa4-4243-a87e-bb08980b51a8 objects representing all the public constructors for a given class. 
Example 


// class_getconstructors.jsl 
import java.lang.reflect.Constructor; 
public class Program 


public static void main(String[] args) 


{ 
// Get the Class object associated with this class. 
Program program = new Program(); 
Class progClass = program.getClass(); 
// Get all the public constructors for ths class. 
Constructor[] ctors = progClass.getConstructors(); 
for (int i = @; i < ctors.length; i++) 
{ 
System.out.println("Public constructor found: " + 
ctors[i].toString()); 
} 
} 
public Program() 
{ 
} 
public Program(String str) 
i 
this.str = str; 
} 
private Program(String str, Integer i) 
{ 
this.str = str; 
this.i = i; 
} 


private String str = "Hello"; 
private Integer i = new Integer(@); 


} 


/* 

Output: 

Public constructor found: public Program() 

Public constructor found: public Program(java.lang.String) 


*/ 


See Also 
Reference 
java.lang.Class 


Visual J# Reference 


java.lang.Class.getDeclaredClasses() 


Gets all the classes (public, private, and protected) defined within the current class. 


J# 
public java.lang.Class[ ] getDeclaredClasses() 


Property Value/Return Value 


An array of bf6c9478-b86e-41e1-b8c9-48372912df0a objects representing all the classes (public, private, and protected) 
defined within the current class. 


Example 


// class_getdeclaredclasses.jsl 


public class Program 


{ 
public static void main(String[] args) 
{ 
try 
{ 
// Get the Class object associated with "Program". 
Class thisClass = Class. forName("Program") ; 
// Get all the Class objects associated with the 
// Program class. 
Class[] classes = thisClass.getDeclaredClasses(); 
for (int i = @; i < classes.length; i++) 
{ 
System.out.printin("Class found: " + 
classes[i].getName()); 
} 
catch (ClassNotFoundException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
public class InnerPublicClass 
{ 
public InnerPublicClass() 
{ 
} 
} 
private class InnerPrivateClass 
{ 
public InnerPrivateClass() 
{ 
} 
} 
} 
/* 
Output: 


Class found: Program$InnerPublicClass 
Class found: Program$InnerPrivateClass 


*/ 


See Also 
Reference 


java.lang.Class 


Visual J# Reference 


java.lang.Class.getDeclaredConstructor(Class[] 
parameterTypes) 


Gets the constructor (public, private, or protected) that takes the given arguments. 


J# 


public java.lang.reflect.Constructor getDeclaredConstructor(java.lang.Class[ ] parameterTyp 
es) 


Parameters 
Param |Description 
eter 





parame |An array of bf6c9478-b86e-41e1-b8c9-48372912df0a objects representing the arguments to the constructor. A 
terType |5c106966-ba6e-4e68 -8ed8-e4131d1bebff is thrown if there is no constructor with the given parameter types. 
S 








Property Value/Return Value 
A 6350a6f2-aaa4-4243-a87e-bb08980b51a8 object representing the constructor that accepts the given parameter types. 
Example 


// class_getdeclaredconstructor.jsl 
import java.lang.reflect.Constructor; 


public class Program 
{ 
public static void main(String[] args) 
ii 
try 
{ 
// Get the Class object associated with this class. 
Program program = new Program(); 
Class progClass = program.getClass(); 


// Find the constructor that only takes a String. 

Class[] ctorArgs1 = new Class[1]; 

ctorArgs1[@] = String.class; 

Constructor strCtor = 
progClass.getDeclaredConstructor(ctorArgs1) ; 


System.out.println("Constructor found: + 
strCtor.toString()); 


// Find the constructor that takes a String and an int. 

Class[] ctorArgs2 = new Class[2]; 

ctorArgs2[@] = String.class; 

ctorArgs2[1] = Integer.class; 

Constructor strintCtor = 
progClass.getDeclaredConstructor(ctorArgs2); 


System.out.println("Constructor found: + 
striIntCtor.toString()); 


catch (NoSuchMethodException ex) 
{ 


System.out.println("Constructor doesn't exist: 
ex.toString()); 


} 


public Program() 
{ 





} 


public Program(String str) 


{ 
this.str = str; 
} 
private Program(String str, Integer i) 
{ 
this.str = str; 
this.i = i; 
} 


private String str = "Hello"; 
private Integer i = new Integer(@); 


} 


/* 

Output: 

Constructor found: public Program(java.lang.String) 

Constructor found: private Program(java.lang.String, java.lang. Integer) 


*/ 


See Also 
Reference 


java.lang.Class 


Visual J# Reference 


java.lang.Class.getDeclaredConstructors() 


Gets all the constructors (public, private, and protected) for a given bf6c9478-b86e-41e1-b8c9-48372912df0a object. 


J# 
public java.lang.reflect.Constructor[ ] getDeclaredConstructors() 


Property Value/Return Value 


An array of 6350a6f2-aaa4-4243-a87e-bb08980b51a8 objects representing all the constructors (public, private, and 
protected) for a given class. 


Example 


// class_getdeclaredconstructors.jsl 
import java.lang.reflect.Constructor; 


public class Program 


4 
public static void main(String[] args) 
{ 
// Get the Class object associated with this class. 
Program program = new Program(); 
Class progClass = program.getClass(); 
// Get all the constructors for ths class. 
Constructor[] ctors = progClass.getDeclaredConstructors(); 
for (int i = @; i < ctors.length; i++) 
{ 
System.out.println("Constructor found: " + 
ctors[i].toString()); 
} 
} 
public Program() 
{ 
} 
public Program(String str) 
i 
this.str = str; 
} 
private Program(String str, Integer i) 
{ 
this.str = str; 
this.i = i; 
} 
private String str = "Hello"; 
private Integer i = new Integer(@); 
} 
/* 
Output: 


Constructor found: public Program() 
Constructor found: public Program(java.lang.String) 
Constructor found: private Program(java.lang.String, java. lang. Integer) 


or 


See Also 
Reference 


java.lang.Class 


Visual J# Reference 


java.lang.Class.getDeclaredField(String fieldName) 


Gets the field (public, private, or protected) with the given name. 


J# 


public java.lang.reflect.Field getDeclaredField(java.lang.String fieldName) 





Parameters 
Paramete |Description 









fieldName |The name of the field. A abfe0115-00b8-44a6-b2f8-927aa2a8cbcc is thrown if there is no field with the given nam 





Property Value/Return Value 
A 3d033269-e08f-4bd9-b84e-9d75a0cddd44 object representing the field of the given name. 


Example 
// class_getdeclaredfield.jsl 





import java.lang.reflect.Field; 
import java.util.Date; 


public class Program 


{ 
public static void main(String[] args) 
1 
try 
{ 
// Get the Class object associated with this class. 
Program program = new Program(); 
Class progClass = program.getClass(); 
// Get the field named str. 
Field strField = progClass.getDeclaredField("str"); 
System.out.println("Field found: " + strField.toString()); 
// Get the field named date. 
Field dateField = progClass.getDeclaredField("date"); 
System.out.println("Field found: " + dateField.toString()); 
// Get the field named i. 
Field iField = progClass.getDeclaredField("i"); 
System.out.println("Field found: " + iField.toString()); 
catch (NoSuchFieldException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 
public Program() 
{ 
} 


public Program(String str, Date date, int i) 
{ 

this.str = str; 

this.date = date; 

this.i = i; 











public String str 
private Date date 
protected int i = @; 


"Hello"; 
new Date(); 


} 


/* 

Output: 

Field found: public java.lang.String Program.str 
Field found: private java.util.Date Program.date 
Field found: protected int Program.i 


ni 











See Also 
Reference 
java.lang.Class 


Visual J# Reference 


java.lang.Class.getDeclaredFields() 


Gets all the fields (public, private, and protected) in the current class. 


J# 
public java.lang.reflect.Field[ ] getDeclaredFields() 


Property Value/Return Value 


An array of 3d033269-e08f-4bd9-b84e-9d75a0cddd44 objects representing all the fields (public, private, and protected) for a 
given class. 


Example 


// class_getdeclaredfields.jsl 


import java.lang.reflect.Field; 
import java.util.Date; 


public class Program 


public static void main(String[] args) 


{ 
// Get the Class object associated with this class. 
Program program = new Program(); 
Class progClass = program.getClass(); 
// Get all the fields associated with this class. 
Field[] fields = progClass.getDeclaredFields(); 
for (int i = @; i < fields.length; i++) 
{ 
System.out.println("Field found: " + 
fields[i].toString()); 
} 
} 
public Program() 
{ 
} 
public Program(String str, Date date, int i) 
si 
this.str = str; 
this.date = date; 
this.i = i; 
} 


public String str = "Hello"; 
private Date date = new Date(); 
protected int i = @; 


} 


/* 

Output: 

Field found: public java.lang.String Program.str 
Field found: private java.util.Date Program.date 
Field found: protected int Program.i 


*/ 


See Also 
Reference 


java.lang.Class 


Visual J# Reference 


java.lang.Class.getDeclaredMethod(String methodName, 
Class[] parameterTypes) 


Gets the method (public, private, or protected) with the given name and parameter types. 


J# 


public java.lang.reflect.Method getDeclaredMethod(java.lang.String methodName, java.lang.Cl 
ass[ ] parameterTypes) 


Parameters 
Param |Description 








method |The name of the method. A 5c106966-ba6e-4e68-8ed8-e4131d1bebff is thrown if there is no method with the given 
Name_|name and parameter types. 





parame |An array of bf6c9478-b86e-41e1 -b8c9-48372912df0a objects representing the arguments to the method. A 5c10696 
terType |6-ba6e-4e68-8ed8-e4131d 1bebff is thrown if there is no method with the given name and parameter types. 
S 











Property Value/Return Value 
A c92d0bb6-52bf-4d52-8dc2-a8a093c211f0 object representing the method of the given name and parameter types. 
Example 


// class_getdeclaredmethod.js1l 


import java.lang.reflect.Method; 
import java.util.Date; 


public class Program 


{ 
public static void main(String[] args) 
{ 
try 
{ 


// Get the Class object associated with this class. 
Program program = new Program(); 
Class progClass = program.getClass(); 


// Get the method named sayHello. 

Method helloMethod = progClass.getDeclaredMethod( 
"sayHello", null); 

System.out.println("Method found: " + 
helloMethod.toString()); 


// Get the method named setStr. 
Class[] args1 = new Class[1]; 
args1[@] = String.class; 
Method strMethod = progClass.getDeclaredMethod( 
"setStr", args1); 
System.out.println("Method found: " + strMethod.toString()); 


// Get the method named setDate. 
Class[] args2 = new Class[1]; 
args2[@] = Date.class; 
Method dateMethod = progClass.getDeclaredMethod( 
"setDate", args2); 
System.out.println("Method found: " + dateMethod.toString()); 


// Get the method named setI. 


Class[] args3 = new Class[1]; 
args3[@] = Integer.TYPE; 
Method iMethod = progClass.getDeclaredMethod( 
"setI", args3); 
System.out.println("Method found: " + iMethod.toString()); 


catch (NoSuchMethodException ex) 


{ 
System.out.println(ex.toString()); 
} 
} 
public Program() 
{ 
} 
public String sayHello() 
{ 
return "Hello!"; 
} 
public void setStr(String str) 
1 
this.str = str; 
} 
private void setDate(Date date) 
{ 
this.date = date; 
} 
private void setI(int i) 
1 
this.i = i; 
} 


public String str = "Hello"; 
private Date date = new Date(); 
protected int i = @; 


} 


/* 

Output: 

Method found: public java.lang.String Program.sayHello() 
Method found: public void Program.setStr(java.lang.String) 
Method found: private void Program.setDate(java.util.Date) 
Method found: private void Program.setI(int) 


*/ 


See Also 
Reference 


java.lang.Class 


Visual J# Reference 


java.lang.Class.getDeclaredMethods() 


Gets all the methods (public, private, or protected) for the current class. 


J# 
public java.lang.reflect.Method[ ] getDeclaredMethods() 


Property Value/Return Value 


An array of c92d0bb6-52bf-4d52-8dc2-a8a093c211f0 objects representing all the methods (public, private, and protected) for 
a given class. 


Example 


// class_getdeclaredmethods.jsl 


import java.lang.reflect.Method; 
import java.util.Date; 


public class Program 


public static void main(String[] args) 


{ 
// Get the Class object associated with this class. 
Program program = new Program(); 
Class progClass = program.getClass(); 
// Get all the methods associated with this class. 
Method[] methods = progClass.getDeclaredMethods(); 
for (int i = @; i < methods.length; i++) 
{ 
System.out.println( "Method found: " + 
methods[i].toString()); 
} 
} 
public Program() 
{ 
} 
public String sayHello() 
{ 
return "Hello!"; 
} 
public void setStr(String str) 
{ 
this.str = str; 
} 
private void setDate(Date date) 
i! 
this.date = date; 
} 
private void setI(int i) 
sf 
this.i = i; 
i 


public String str = "Hello"; 
private Date date = new Date(); 
protected int i = @; 


/* 

Output: 

Method found: public static void Program.main(java.lang.String[]) 
Method found: public java.lang.String Program. sayHello() 

Method found: public void Program.setStr(java.lang.String) 

Method found: private void Program.setDate(java.util.Date) 

Method found: private void Program.setI(int) 

*/ 


See Also 
Reference 
java.lang.Class 


Visual J# Reference 


java.lang.Class.getDeclaringClass() 


Gets the class that declares an entity such as a field, method, or constructor. 


J# 
public java.lang.Class getDeclaringClass() 


Property Value/Return Value 


A bf6c9478-b86e-41e1 -b8c9-4837291 2df0a object representing the class that declares an entity such as a field, method, or 
constructor. 


Example 


// class_getdeclaringclass.jsl 
import java.lang.reflect.Method; 


public class Program 
4 
public static void main(String[] args) 
{ 
// Get the Class object associated with the class String. 
Class strClass = String.class; 


// Get all methods for class String. 
Method[] methods = strClass.getMethods(); 
for (int i = @; i < methods.length; i++) 


Class declaring = methods[i].getDeclaringClass(); 
System.out.println("Method: " + methods[i].toString() + 
" Declaring class: " + declaring.toString()); 


} 


/* 

Output: 

Method: public final java.lang.Class java.lang.Object.getClass() Declaring class: class jav 
a.lang.Object 

Method: public final void java.lang.Object.notify() Declaring class: class java.lang.Object 
Method: public final void java.lang.Object.notifyAl1() Declaring class: class java.lang.Obj 
ect 

Method: public final void java.lang.Object.wait() throws java.lang.InterruptedException Dec 
laring class: class java.lang.Object 

Method: public final void java.lang.Object.wait(long) throws java.lang.InterruptedException 
Declaring class: class java.lang.Object 

Method: public final void java.lang.Object.wait(long,int) throws java.lang.InterruptedExcep 
tion Declaring class: class java.lang.Object 

Method: public final java.lang.String java.lang.String.toString() Declaring class: class ja 
va. lang.String 

Method: public char java.lang.String.charAt(int) Declaring class: class java.lang.String 
Method: public int java.lang.String. compareTo(java.lang.String) Declaring class: class java 
. lang.String 

Method: public java.lang.String java.lang.String. concat(java.lang.String) Declaring class: 
class java.lang.String 

Method: public static java.lang.String java.lang.String. copyValueOf(char[],int,int) Declari 
ng class: class java.lang.String 

Method: public static java.lang.String java.lang.String.copyValueOf(char[]) Declaring class 
: class java.lang.String 

Method: public boolean java.lang.String. endsWith( java.lang.String) Declaring class: class j 
ava.lang.String 

Method: public boolean java.lang.String. equals(java.lang.Object) Declaring class: class jav 
a.lang.String 


Method: public boolean java.lang.String.equals(java.lang.Object) Declaring class: class jav 
a.lang.String 

Method: public boolean java.lang.String.equalsIgnoreCase(java.lang.String) Declaring class: 
class java.lang.String 

Method: public byte[] java.lang.String. getBytes() Declaring class: class java.lang.String 
Method: public byte[] java.lang.String. getBytes(java.lang.String) throws java.io.Unsupporte 
dEncodingException Declaring class: class java.lang.String 

Method: public void java.lang.String. getBytes(int,int,byte[],int) Declaring class: class ja 
va. lang.String 

Method: public void java.lang.String. getChars(int,int,char[],int) Declaring class: class ja 
va. lang.String 

Method: public int java.lang.String. hashCode() Declaring class: class java.lang.String 
Method: public int java.lang.String.indexOf(int,int) Declaring class: class java.lang.Strin 
g 

Method: public int java.lang.String.indexOf(int) Declaring class: class java.lang.String 
Method: public int java.lang.String. indexOf(java.lang.String,int) Declaring class: class ja 
va. lang.String 

Method: public int java.lang.String. indexOf(java.lang.String) Declaring class: class java.1l 
ang.String 

Method: public java.lang.String java.lang.String.intern() Declaring class: class java.lang. 
String 

Method: public int java.lang.String. lastIndexOf(int,int) Declaring class: class java.lang.S 
tring 

Method: public int java.lang.String. lastIndexOf(int) Declaring class: class java.lang.Strin 
g 

Method: public int java.lang.String. lastIndexOf(java.lang.String,int) Declaring class: clas 
S java.lang.String 

Method: public int java.lang.String. lastIndexOf( java.lang.String) Declaring class: class ja 
va. lang.String 

Method: public int java.lang.String.length() Declaring class: class java.lang.String 
Method: public boolean java.lang.String.regionMatches(int, java.lang.String,int,int) Declari 
ng class: class java.lang.String 

Method: public boolean java.lang.String. regionMatches(boolean, int, java.lang.String, int, int) 
Declaring class: class java.lang.String 

Method: public java.lang.String java.lang.String.replace(char,char) Declaring class: class 
java.lang.String 

Method: public boolean java.lang.String.startsWith(java.lang.String) Declaring class: class 
java.lang.String 

Method: public boolean java.lang.String.startsWith(java.lang.String,int) Declaring class: c 
lass java.lang.String 

Method: public java.lang.String java.lang.String.substring(int) Declaring class: class java 
. lang.String 

Method: public java.lang.String java.lang.String.substring(int,int) Declaring class: class 
java.lang.String 

Method: public char[] java.lang.String.toCharArray() Declaring class: class java.lang.Strin 


Method: public java.lang.String java.lang.String.toString() Declaring class: class java.lan 
g.String 

Method: public java.lang.String java.lang.String.toLowerCase() Declaring class: class java. 
lang.String 

Method: public java.lang.String java.lang.String. toLowerCase(java.util.Locale) Declaring cl 
ass: class java.lang.String 

Method: public java.lang.String java.lang.String.toUpperCase() Declaring class: class java. 
lang.String 

Method: public java.lang.String java.lang.String. toUpperCase(java.util.Locale) Declaring cl 
ass: class java.lang.String 

Method: public java.lang.String java.lang.String.trim() Declaring class: class java.lang.St 
ring 

Method: public static java.lang.String java.lang.String.valueOf(boolean) Declaring class: c 
lass java.lang.String 

Method: public static java.lang.String java.lang.String.valueOf(char) Declaring class: clas 
S java.lang.String 

Method: public static java.lang.String java.lang.String.valueOf(double) Declaring class: cl 
ass java.lang.String 

Method: public static java.lang.String java.lang.String.valueOf(float) Declaring class: cla 
ss java.lang.String 

Method: public static java.lang.String java.lang.String.valueOf(int) Declaring class: class 
java.lang.String 


Method: public static java.lang.String java.lang.String.valueOf(long) Declaring class: clas 
S java.lang.String 

Method: public static java.lang.String java.lang.String. valueOf( java.lang.Object) Declaring 
class: class java.lang.String 

Method: public static java.lang.String java.lang.String.valueOf(char[]) Declaring class: cl 
ass java.lang.String 

Method: public static java.lang.String java.lang.String.valueOf(char[],int,int) Declaring c 
lass: class java.lang.String 

Method: public int java.lang.String. compareTo(java.lang.Object) Declaring class: class java 
. lang.String 

Method: public int java.lang.String. compareToIgnoreCase(java.lang.String) Declaring class: 
class java.lang.String 

Method: public int java.lang.Object.hashCode() Declaring class: class java.lang.Object 

a 


See Also 
Reference 
java.lang.Class 


Visual J# Reference 


java.lang.Class.getField(String fieldName) 


Gets the public field with the given name. 


J# 


public java.lang.reflect.Field getField(java.lang.String fieldName) 





Parameters 
Paramet Description 
er 









fieldNam|The name of the field. A abfe0115-00b8-44a6-b2f8-927aa2a8cbcc is thrown if there is no field with the given name 
or if the field is not public. 








Property Value/Return Value 
A 3d033269-e08f-4bd9-b84e-9d75a0cddd44 object representing the public field of the given name. 


Example OO 
// class_getfield.jsl 


import java.lang.reflect.Field; 
import java.util.Date; 


public class Program 


{ 


public static void main(String[] args) 

1 
// Get the Class object associated with this class. 
Program program = new Program(); 
Class progClass = program.getClass(); 


// Get the field named str. 
try 


Field strField = progClass.getField("str"); 


System.out.println("Public field found: + 
strField.toString()); 


catch (NoSuchFieldException ex) 
{ 


System.out.println("Field either doesn't exist or is + 


"not public: " + ex.toString()); 
} 


// Get the field named date. 
try 


Field dateField = progClass.getField("date"); 


System.out.println("Public field found: + 
dateField.toString()); 


catch (NoSuchFieldException ex) 
{ 


System.out.println("Field either doesn't exist or is + 


"not public: " + ex.toString()); 
} 


// Get the field named i. 
try 


Field iField = progClass.getField("i"); 
System.out.print1ln("Public field found: 


+ 








iField.toString()); 


} 
catch (NoSuchFieldException ex) 
{ 
System.out.println("Field either doesn't exist or is " + 
"not public: " + ex.toString()); 
} 
} 
public Program() 
{ 
} 
public Program(String str, Date date, int i) 
si 
this.str = str; 
this.date = date; 
this.i = i; 
} 


public String str = "Hello"; 
private Date date = new Date(); 
protected int i = @; 


} 


/* 

Output: 

Public field found: public java.lang.String Program.str 

Field either doesn't exist or is not public: java.lang.NoSuchFieldException: date 
Field either doesn't exist or is not public: java.lang.NoSuchFieldException: i 


a 


See Also 
Reference 
java.lang.Class 


Visual J# Reference 


java.lang.Class.getFields() 


Gets all the public fields in the current class. 


J# 


public java.lang.reflect.Field[ ] getFields() 


Property Value/Return Value 


An array of 3d033269-e08f-4bd9-b84e-9d75a0cddd44 objects representing all the public fields for a given class. 


Example 


// class_getfields.jsl 


import java.lang.reflect.Field; 
import java.util.Date; 


public class Program 


public static void main(String[] args) 


// Get the Class object associated with this class. 
Program program = new Program(); 
Class progClass = program.getClass(); 


// Get all the public fields associated with this class. 
Field[] fields = progClass.getFields(); 

for (int i = @; i < fields.length; i++) 

{ 


System.out.println("Public field found: + 
fields[i].toString()); 


public Program() 


public Program(String str, Date date, int i) 


this.str = str; 
this.date = date; 
this.i = i; 


public String str = "Hello"; 
private Date date = new Date(); 


protected int i = 


fev) 


3 


Public field found: public java.lang.String Program.str 


{ 
{ 
i 
{ 
I 
{ 
} 
} 
/* 
Output: 
*/ 
See Also 
Reference 


java.lang.Class 


Visual J# Reference 


java.lang.Class.getInterfaces() 


Gets all the interfaces implemented by a class. 


J# 
public java.lang.Class[ ] getInterfaces() 


Property Value/Return Value 
An array of bf6c9478-b86e-41e1-b8c9-48372912df0a objects representing all the interfaces that a class implements. 
Example 


// class_getinterfaces.jsl 


public class Program implements Comparable 


{ 
public static void main(String[] args) 
if 
// Get the Class object associated with this class. 
Program program = new Program(); 
Class progClass = program.getClass(); 
// Get the interfaces associated with this class. 
Class[] interfaces = progClass.getInterfaces(); 
for (int i = @; i < interfaces.length; i++) 
{ 
System.out.println("Interface found: " + 
interfaces[i].toString()); 
} 
} 
public int compareTo(Object 0) 
if 
if (o instanceof Program) 
{ 
Program p = (Program)o; 
return this.str.compareTo(p.str); 
} 
throw new IllegalArgumentException(); 
} 
private String str = "Hello"; 
} 
/ * 
Output: 
Interface found: interface java.lang.Comparable 
*/ 
See Also 
Reference 


java.lang.Class 


Visual J# Reference 


java.lang.Class.getMethod (String methodName, Class[] 
parameterTypes) 


Gets the public method with the given name and parameter types. 


J# 


public java.lang.reflect.Method getMethod(java.lang.String methodName, java.lang.Class[ ] p 
arameterTypes ) 


Parameters 
Parame |Description 
ter 









method |The name of the method. A NoSuchMethodException is thrown if there is no method with the given name and param 
Name __|eter types or if the method is not public. 








paramet|An array of java.lang.Class objects representing the arguments to the method. A NoSuchMethodException is thro 
erTypes |wn if there is no method with the given name and parameter types or if the method is not public. 





Property Value/Return Value 
A lIllegalArgumentException Class object representing the public method of the given name and parameter types. 
Example 


// class_getmethod.jsl 


import java.lang.reflect.Method; 
import java.util.Date; 


public class Program 


{ 


public static void main(String[] args) 

if 
// Get the Class object associated with this class. 
Program program = new Program(); 
Class progClass = program.getClass(); 


try 
{ 
// Get the method named sayHello. 
Method helloMethod = progClass.getMethod( 
"sayHello", null); 
System.out.println("Public method found: 
helloMethod.toString()); 


+ 


catch (NoSuchMethodException ex) 


{ 
System.out.println("Method either doesn't exist " + 
"or is not public: " + ex.toString()); 
} 
try 
{ 


// Get the method named setStr. 

Class[] args1 = new Class[1]; 

args1[@] = String.class; 

Method strMethod = progClass.getMethod( 
"setStr", args1); 

System.out.println("Public method found: 
strMethod.toString()); 





catch (NoSuchMethodException ex) 


{ 
System.out.println("Method either doesn't exist " + 
"or is not public: " + ex.toString()); 
} 
try 
{ 
// Get the method named setDate. 
Class[] args2 = new Class[1]; 
args2[@] = Date.class; 
Method dateMethod = progClass.getMethod( 
"setDate", args2); 
System.out.println("Public method found: " + 
dateMethod.toString()); 
catch (NoSuchMethodException ex) 
{ 
System.out.println("Method either doesn't exist " + 
"or is not public: " + ex.toString()); 
} 
try 
{ 
// Get the method named setI. 
Class[] args3 = new Class[1]; 
args3[@] = Integer.TYPE; 
Method iMethod = progClass.getMethod( 
"setI", args3); 
System.out.println("Public method found: " + 
iMethod.toString()); 
catch (NoSuchMethodException ex) 
{ 
System.out.println("Method either doesn't exist " + 
"or is not public: " + ex.toString()); 
} 
} 
public Program() 
{ 
} 
public String sayHello() 
{ 
return "Hello!"; 
} 
public void setStr(String str) 
{ 
this.str = str; 
} 
private void setDate(Date date) 
{ 
this.date = date; 
} 
private void setI(int i) 
{ 
this.i = i; 
} 


public String str "Hello"; 
private Date date = new Date(); 
protected int i = @; 


Public method found: public java.lang.String Program.sayHello() 

Public method found: public void Program.setStr(java.lang.String) 

Method either doesn't exist or is not public: java.lang.NoSuchMethodException: setDate 
Method either doesn't exist or is not public: java.lang.NoSuchMethodException: setI 


See Also 
Reference 
java.lang.Class 


Visual J# Reference 


java.lang.Class.getMethods() 


Gets all the public methods for the current class. 


J# 


public java.lang.reflect.Method[ ] getMethods() 
Parameters 
Property Value/Return Value 
An array of c92d0bb6-52bf-4d52-8dc2-a8a093c211f0 objects representing all the public methods for a given class. 
Example 


// class_getmethods.jsl 


import java.lang.reflect.Method; 
import java.util.Date; 


public class Program 


{ 
public static void main(String[] args) 
{ 
// Get the Class object associated with this class. 
Program program = new Program(); 
Class progClass = program.getClass(); 
// Get the public methods associated with this class. 
Method[] methods = progClass.getMethods(); 
for (int i = @; i < methods.length; i++) 
{ 
System.out.println("Public method found: " + 
methods[i].toString()); 
} 
} 
public Program() 
{ 
} 
public String sayHello() 
{ 
return "Hello!"; 
} 
public void setStr(String str) 
i 
this.str = str; 
} 
private void setDate(Date date) 
{ 
this.date = date; 
} 
private void setI(int i) 
1 
this.i = i; 
} 


public String str = "Hello"; 
private Date date = new Date(); 
protected int i = @; 


/* 


Output: 


Public 
Public 
Public 
Public 


method 
method 
method 
method 


Exception 


Public 


method 


ptedException 


Public 


method 


found: 
found: 
found: 
found: 


found: 


found: 


erruptedException 


Public 
Public 
Public 
Public 
Public 
Public 
a 


See Also 
Reference 


method 
method 
method 
method 
method 
method 


java.lang.Class 


found: 
found: 
found: 
found: 
found: 
found: 


public 
public 
public 
public 


public 
public 


public 
public 
public 
public 
public 
public 


final java.lang.Class java.lang.Object.getClass() 

final void java.lang.Object.notify() 

final void java.lang.Object.notifyAl1() 

final void java.lang.Object.wait() throws java.lang. Interrupted 


final void java.lang.Object.wait(long) throws java.lang.Interru 
final void java.lang.Object.wait(long,int) throws java.lang.Int 


static void Program.main(java.lang.String|[ ]) 
java.lang.String Program.sayHello() 

void Program.setStr(java.lang.String) 
java.lang.String java.lang.Object.toString() 
boolean java.lang.Object.equals(java.lang.Object) 
int java.lang.Object.hashCode() 


Visual J# Reference 


java.lang.Class.getModifiers() 


Gets all the modifiers for a class declaration. 


J# 
public int getModifiers() 


Property Value/Return Value 


An integer representing the modifiers for the class declaration. Use the d408f6cd-0896-4706-a92b-5722881b88ea class to 
interpret this value. 


Example 


// class_getmodifiers.jsl 
import java.lang.reflect.Modifier; 


public class Program 


4 
public static void main(String[] args) 
{ 
// Get the Class object associated with this class. 
Program program = new Program(); 
Class progClass = program.getClass(); 
// Get the modifiers for this class. 
int i = progClass.getModifiers(); 
String mods = Modifier.toString(i); 
System.out.println("Class modifiers: " + mods); 
} 
} 
/ * 
Output: 
Class modifiers: public synchronized 
=f 
See Also 
Reference 


java.lang.Class 


Visual J# Reference 


java.lang.Class.getName() 


Gets the name of a class. 


J# 
public java.lang.String getName() 


Property Value/Return Value 
The name of the class. 
Example 


// class_getname.jsl 


public class Program 


{ 
public static void main(String[] args) 
if 
// Get the Class object associated with this class. 
Program program = new Program(); 
Class progClass = program.getClass(); 
// Get the name of this class. 
String name = progClass.getName(); 
System.out.printlin("Class name: " + name); 
} 
} 
/ * 
Output: 
Class name: Program 
a A 
See Also 
Reference 


java.lang.Class 


Visual J# Reference 


java.lang.Class.getResource(String resourceName) 


This method is not supported by J#. 
J# 


public java.net.URL getResource(java.lang.String resourceName) 











Parameters 

Parameter Description 

resourceName This parameter is not supported by J#. 
See Also 

Reference 


java.lang.Class 





Visual J# Reference 


java.lang.Class.getResourceAsStream(String resourceName) 


This method is not supported by J#. 


J# 
public java.io.InputStream getResourceAsStream(java.lang.String resourceName) 


See Also 
Reference 
java.lang.Class 


Visual J# Reference 


java.lang.Class.getSigners() 


Gets the array of signers that were set for this class, if any, by calling ClassLoader.setSigners(). A signer is an object that is used 
to sign the class for security. 


J# 


public java.lang.Object[ ] getSigners() 


Property Value/Return Value 

An array of signers that were set for this class, if any. 

Remarks 

NOTE: J# does not support custom class loaders or defineClass() methods. Hence, this method will always return a null array. 


See Also 
Reference 


java.lang.Class 


Visual J# Reference 


java.lang.Class.getSuperclass() 


Gets the super class (base class) of the current class. 


J# 





public java.lang.Class getSuperclass() 





Property Value/Return Value 
A bf6c9478-b86e-41e1 -b8c9-48372912df0a object representing the super (base) class of the current class. 








Example 
// class_getsuperclass.jsl 
public class Program 
{ 
public static void main(String[] args) 
if 
// Get the Class object associated with this class. 
Program program = new Program(); 
Class progClass = program.getClass(); 
// Get the super class of this class. 
Class superClass = progClass.getSuperclass(); 
System.out.println("Super class name: " + 
superClass.getName()); 
} 
} 
/* 
Output: 
Super class name: java.lang.Object 
ui 
See Also 
Reference 


java.lang.Class 





Visual J# Reference 


java.lang.Class.isArray() 


Determines whether a class is an array. 


J# 
public boolean isArray() 


Property Value/Return Value 
true if the class is an array; false otherwise. 
Example 


// class_isarray.jsl 


public class Program 


{ 


public static void main(String[] args) 
if 
// Create a String object and an array of String objects. 
String str = "Hello, World!"; 
String[] strArr = new String[] { 
"Hello", "World" 


}3 


// Is the String class an array? 

Class strClass = str.getClass(); 

boolean striIsArray = strClass.isArray(); 
if (strIsArray) 

{ 


System.out.printin("Class " + strClass.getName() + 
"is an array."); 
} 


else 


{ 


System.out.printin("Class " + strClass.getName() + 
"is NOT an array."); 


i 


// Is the String array class an array? 

Class strArrClass = strArr.getClass(); 

boolean strArrIsArray = strArrClass.isArray(); 
if (strArrisArray) 

i 


System.out.println("Class " + strArrClass.getName() + 
"is an array."); 
; 


else 


{ 


System.out.println("Class " + strArrClass.getName() + 


"is NOT an array."); 


} 


/* 

Output: 

Class java.lang.String is NOT an array. 
Class [Ljava.lang.String; is an array. 


*/ 


See Also 
Reference 


java.lang.Class 


Visual J# Reference 


java.lang.Class.isAssignableFrom(Class cls) 


Determines whether one class can be assigned from another class. 


J# 


public boolean isAssignableFrom(java.lang.Class cls) 





Parameters 


Paramete|Description 
r 


cls A bf6c9478-b86e-41e1 -b8c9-48372912df0a object representing the class to verify if it can be assigned to the curr 
ent class. 














Property Value/Return Value 


true if cls can be assigned to the current class; false otherwise. 


Example —E____________t_c_c__ii_i___—_= 


// class_isassignablefrom.jsl 
public class Program 


public static void main(String[] args) 


{ 
// Get the Class object associated with this class. 
Program program = new Program(); 
Class progClass = program.getClass(); 
// Get the Class object associated with BaseClass. 
Class baseClassClass = BaseClass.class; 
// Is Program assignable from BaseClass? 
boolean check1 = progClass.isAssignableFrom(baseClassClass) ; 
System.out.println("Program is assignable from BaseClass? " + 
check1) ; 
// Is BaseClass assignable from Program? 
boolean check2 = baseClassClass.isAssignableFrom(progClass) ; 
System.out.println("BaseClass is assignable from Program? " + 
check2) ; 
} 
} 
public class BaseClass extends Program 
if 
public BaseClass() 
{ 
} 
} 
/* 
Output: 


Program is assignable from BaseClass? true 
BaseClass is assignable from Program? false 


*/ 











See Also 
Reference 
java.lang.Class 


Visual J# Reference 


java.lang.Class.isinstance(Object obj) 


Determines whether an object is an instance of the current class. 


J# 


public boolean isInstance(java.lang.Object obj) 





Parameters 
Parameter Description 
obj The object to verify if it is an instance of the current class. 











Property Value/Return Value 
true if obj is an instance of the current class; false otherwise. 
Remarks 


This method is equivalent to calling obj instanceof ClassName. 


Example SS 








// class_isinstance.jsl 
import java.util.Date; 
public class Program 
{ 
public static void main(String[] args) 
{ 
// Get the Class object associated with Integer. 
Class intClass = Integer.class; 
// Create various objects. 
String str = "Hello"; 
Date date = new Date(); 
Integer i = new Integer(1@); 
// Is str an instance of class Integer? 
boolean check1 = intClass.isInstance(str); 
System.out.println("str is an Integer? " + check1); 
// Is date an instance of class Integer? 
boolean check2 = intClass.isInstance(date) ; 
System.out.println("date is an Integer? " + check2); 
// Is i an instance of class Integer? 
boolean check3 = intClass.isInstance(i); 
System.out.printin("i is an Integer? " + check3); 
} 
} 
/* 
Output: 
str is an Integer? false 
date is an Integer? false 
i is an Integer? true 
*/ 
See Also 
Reference 


java.lang.Class 


Visual J# Reference 


java.lang.Class.isInterface() 


Determines whether the current bf6c9478-b86e-41e1 -b8c9-48372912df0a object represents an interface. 


J# 
public boolean isInterface() 


Property Value/Return Value 
true if the current bf6c9478-b86e-41e1 -b8c9-48372912df0a object represents an interface; false otherwise. 
Example 


// class_isinterface.jsl 


public class Program 


{ 
public static void main(String[] args) 
if 
// Get the Class object associated with this class. 
Program program = new Program(); 
Class progClass = program.getClass(); 
// Get the Class object associated with ISayHello. 
Class iSayHelloClass = ISayHello.class; 
// Is Program an interface? 
boolean check1 = progClass.isInterface(); 
System.out.printlin("Program is an interface? " + 
check1) ; 
// Is ISayHello an interface? 
boolean check2 = iSayHelloClass.isInterface(); 
System.out.printin("ISayHello is an interface? " + 
check2) ; 
} 
} 
public interface ISayHello 
{ 
public String sayHello(); 
} 
/* 
Output: 


Program is an interface? false 
ISayHello is an interface? true 


*/ 


See Also 
Reference 
java.lang.Class 


Visual J# Reference 


java.lang.Class.isPrimitive() 


Determines whether the current bf6c9478-b86e-41e1 -b8c9-48372912df0a object represents a primitive type. 


J# 
public boolean isPrimitive() 


Property Value/Return Value 


true if the current bf6c9478-b86e-41e1-b8c9-48372912df0a object represents a primitive type (such as int, long, void); 
false otherwise. 


Example 
// class_isprimitive.jsl 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Get the Class object associated with this class. 
Program program = new Program(); 
Class progClass = program.getClass(); 


// Get the Class object associated with an integer. 
int i = @; 
Class iClass = int.class; 


// Is Program a primitive type? 

boolean check1 = progClass.isPrimitive(); 

System.out.println("program is a primitive type? " + 
check1) ; 


// Is i an primitive type? 

boolean check2 = iClass.isPrimitive(); 

System.out.printlin("i is a primitive type? " + 
check2) ; 


} 


/* 

Output: 

program is a primitive type? false 
i is a primitive type? true 


aes 


See Also 
Reference 
java.lang.Class 


Visual J# Reference 


java.lang.Class.newlInstance() 


Creates a new instance of the object represented by the current bf6c9478-b86e-41e1 -b8c9-4837291 2df0a object. 


J# 


public java. 


lang.Object newInstance() 


Property Value/Return Value 


A new instance of the object represented by the current bf6c9478-b86e-41e1 -b8c9-48372912df0a object. An 
ab3181f6-40a0-4dcd-8ddc-575e4db64b05 will be thrown if the object cannot be instantiated. An 
4dd49557-ba4e-475c-872d-6c06670d34b7 will be thrown if the caller does not have access to the object. 


Example 


// class_newinstance.jsl 


import java. 


util.Date; 


public class Program 


public static void main(String[] args) 


// Create a Date object for time now. 
Date now = new Date(); 

Class dateClass = now.getClass(); 
System.out.println("The time now is: 


+ now.toString()); 


// Create another Date object using the Class for Date. 
Object o = dateClass.newInstance(); 
if (o instanceof Date) 


{ 
Date aLittleLater = (Date)o; 
System.out.println("The time a little later is: " + 
aLittleLater.toString()); 
} 


catch (InstantiationException ex) 


System.out.println(ex.toString()); 


catch (IllegalAccessException ex) 


{ 
if 
try 
{ 
{ 
{ 
} 
} 
} 
/* 


System.out.println(ex.toString()); 


Sample Output: 
The time now is: Thu Oct 28 13:56:34 PDT 2004 
The time a little later is: Thu Oct 28 13:56:35 PDT 2004 


ad 


See Also 
Reference 
java.lang.Class 


Visual J# Reference 


java.lang.Object 


Represents the base class for all J# objects. All classes in J# inherently derive from Object and inherit all its functionality. 


J# 
public class Object extends System.Object 


Example 


// object_overview.jsl 


public class MyObject extends Object implements Runnable 
{ 
public static void main(String[] args) 
{ 
try 
{ 
// The object being used to call wait and notify on 
// must be synchronized. 
synchronized (obj) 


// Create a secondary thread used to call notify. 
Thread thr = new Thread(obj); 
thr.start(); 


// Wait for the secondary thread to call notify. 
System.out.println("waiting..."); 

obj.wait(); 

System.out.println("done waiting!"); 


// Join the secondary thread. 
thr. join(); 
} 


catch (InterruptedException ex) 


4 
} 


// Get the Class associated with MyObject. 
Class myClass = obj.getClass(); 


System.out.printin(ex.toString()); 


// Print out the type of obj. 
System.out.println("obj is of type " + 
myClass.getName()); 


// Get the hash code associated with MyObject. 
int hash = obj.hashCode(); 


// Print out the hash code for obj. 
System.out.println("The hash code for obj is " + 
hash) ; 


// Print out the string representation for obj. 
System.out.println("The string representation for obj is " + 
obj.toString()); 


// Determine if two MyObject objects are equal. 

boolean equal = obj.equals(obj2); 

System.out.println("obj equals obj2? " + equal); 
} 


// Implements Runnable.run() 
public void run() 


// The object being used to call wait and notify on 
// must be synchronized. 
synchronized (obj) 


{ 
// Call notify on the primary thread so it can 
// stop waiting. 
System.out.println("\tnotifying..."); 
obj .notify(); 
System.out.println("\tdone notifying!"); 

} 


} 


private static MyObject obj = new MyObject(); 
private static MyObject obj2 = new MyObject(); 
} 


/* 
Sample Output: 
waiting... 
notifying... 
done notifying! 
done waiting! 
obj is of type MyObject 
The hash code for obj is 18643596 
The string representation for obj is MyObject@11c7a8c 
obj equals obj2? false 
*/ 


See Also 
Concepts 
Visual J# Class Library 


Visual J# Reference 


java.lang.Object.clone() 


Creates a shallow copy of an Object. 


J# 
protected Object clone() throws CloneNotSupportedException 


Property Value/Return Value 
A new instance of an Object that is a shallow copy of the existing Object. 
Example 


// object_clone.jsl 


public class MyObject extends Object 
{ 
public static void main(String[] args) 
sf 
// Create three instance of MyObject objects. 
MyObject obj1 = new MyObject("Hello"); 
MyObject obj2 = new MyObject("World"); 
MyObject obj3 = null; 
try 


obj3 = (MyObject)obj2.clone(); 


catch (CloneNotSupportedException ex) 
{ 


} 


// Is obj1 equal to obj2? 

boolean equality = obj1.equals(obj2); 

System.out.println("obj1 equals obj2? " + 
equality); 


System.out.println(ex.toString()); 


// Is obj2 equal to obj3? 
equality = obj2.equals(obj3); 
System.out.println("obj2 equals obj3? " + 
equality); 
} 


public MyObject(String s) 
{ 


} 


aString = s; 


protected Object clone() throws CloneNotSupportedException 


if 
MyObject newObj = new MyObject(aString) ; 
return newObj; 


} 


// Two MyObject objects are equal if the aString 
// fields are equal. 
public boolean equals(Object o) 


1 
if (o instanceof MyObject) 


MyObject myO = (MyObject)o; 
if (aString == myO.aString) 
{ 


return true; 


} 
return false; 
ig 
private String aString = 
} 
/* 
Output: 


obj1 equals obj2? false 
obj2 equals obj3? true 
uf 





See Also 
Reference 
java.lang.Object 
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java.lang.Object.equals(Object obj) 


Determines whether two objects are equal. 


J# 


public boolean equals(Object obj) 





Parameters 
Parameter Description 
obj An instance of an Object to compare against the current Object for equality. 











Property Value/Return Value 


true if the two objects are equal; false otherwise. 


Example 
// object_equals.jsl 


public class MyObject extends Object 
{ 


public static void main(String[] args) 

{ 
// Create three instance of MyObject objects. 
MyObject obj1 = new MyObject("Hello"); 
MyObject obj2 = new MyObject("World"); 
MyObject obj3 = new MyObject("World"); 


// Is obj1 equal to obj2? 

boolean equality = obj1.equals(obj2); 

System.out.println("obj1 equals obj2? " + 
equality); 


// Is obj2 equal to obj3? 
equality = obj2.equals(obj3); 
System.out.println("obj2 equals obj3? " + 
equality); 
} 


public MyObject(String s) 
1 


} 


aString = s; 


// Two MyObject objects are equal if the aString 
// fields are equal. 
public boolean equals(Object o) 


1 
if (o instanceof MyObject) 
MyObject myO = (MyObject)o; 
if (aString == myO.aString) 
return true; 
} 
} 
return false; 
} 


private String aString = 








/* 

Output: 

obj1 equals obj2? false 
obj2 equals obj3? true 
a 





See Also 
Reference 
java.lang.Object 
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java.lang.Object.finalize() 


Represents the method that is called once the garbage collector has determined that the Object is no longer being accessed by 
any thread. 


J# 





protected void finalize() throws Throwable 


Example a ___________________— 


// There is no code example for this method. 








See Also 
Reference 
java.lang.Object 
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java.lang.Object.getClass() 


Gets the java.lang.Class object representing the type of the current Object. 


J# 
public final Class getClass() 


Property Value/Return Value 
A Class object that represents the type of the current Object. 
Example 


// object_getclass.jsl 


public class MyObject extends Object 


{ 
public static void main(String[] args) 
sf 
// Create a new instance of MyObject. 
MyObject obj = new MyObject(); 
// Get the Class associated with MyObject. 
Class myClass = obj.getClass(); 
// Print out the type of obj. 
System.out.println("obj is of type " + 
myClass.getName()); 
} 
/ * 
Output: 
obj is of type MyObject 
*/ 
See Also 
Reference 


java.lang.Object 
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java.lang.Object.hashCode() 


Generates a hash value that can be used to uniquely identify a particular Object. 


J# 
public int hashCode() 


Property Value/Return Value 

A hash value that uniquely identifies an Object. 

Remarks 

Subsequent calls to this method must consistently produce the same hash value. 
Example 


// object_hashcode.jsl 


public class MyObject extends Object 
{ 


public static void main(String[] args) 


{ 


// Create a new instance of MyObject. 
MyObject obj = new MyObject(); 


// Get the hash code associated with MyObject. 
int hash = obj.hashCode(); 


// Print out the hash code for obj. 
System.out.println("The hash code for obj is " + 
hash) ; 


} 


/* 

Sample Output: 

The hash code for obj is 54267293 
*/ 


See Also 
Reference 


java.lang.Object 


Visual J# Reference 


java.lang.Object.notify() 


Causes any thread that is currently waiting to be awakened. 


J# 
public final void notify() 


Remarks 
If more than one thread is waiting, the choice for which thread is to be woken is random. 
Example 

// object_notify.jsl 


public class MyObject extends Object implements Runnable 
{ 


public static void main(String[] args) 


af 
try 
{ 
// The object being used to call wait and notify on 
// must be synchronized. 
synchronized (obj) 
{ 
// Create a secondary thread used to call notify. 
Thread thr = new Thread(obj); 
thr.start(); 
// Wait for the secondary thread to call notify. 
System.out.println("waiting..."); 
obj.wait(); 
System.out.println("done waiting!"); 
// Join the secondary thread. 
thr. join(); 
} 
} 
catch (InterruptedException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 


// Implements Runnable.run() 
public void run() 


{ 
// The object being used to call wait and notify on 
// must be synchronized. 
synchronized (obj) 
// Call notify on the primary thread so it can 
// stop waiting. 
System.out.println("\tnotifying..."); 
obj.notify(); 
System.out.println("\tdone notifying!"); 
} 
} 
private static MyObject obj = new MyObject(); 
} 
/* 


Output: 


waiting... 
notifying... 
done notifying! 
done waiting! 


| 





See Also 
Reference 


java.lang.Object 
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java.lang.Object.notifyAll() 


Causes all threads that are currently waiting to be awakened. 


J# 


public final void notifyAl11() 


Example 


// object_notifyall.jsl 


public class MyObject extends Object implements Runnable 


{ 


public static void main(String[] args) 


{ 


} 


try 


{ 
// The object being used to call wait and notifyAll on 


// must be synchronized. 
synchronized (obj) 


// Create a secondary thread used to call notifyAll. 
Thread thr = new Thread(obj); 
thr.start(); 


// Wait for the secondary thread to call notifyAll. 
System.out.println("waiting..."); 

obj.wait(); 

System.out.println("done waiting!"); 


// Join the secondary thread. 
thr. join(); 


} 
catch (InterruptedException ex) 
{ 

System.out.printin(ex.toString()); 
} 


// Implements Runnable.run() 
public void run() 


{ 


} 


// The object being used to call wait and notifyAll on 
// must be synchronized. 
synchronized (obj) 


{ 
// Call notifyAll on the primary thread so it can 
// stop waiting. 
System.out.printin("\tnotifying..."); 
obj.notifyAl11(); 
System.out.printin("\tdone notifying!"); 

} 


private static MyObject obj = new MyObject(); 


} 


/* 
Output: 


waiting... 


notifying... 
done notifying! 


done waiting! 


a 





See Also 
Reference 


java.lang.Object 
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java.lang.Object.toString() 


Displays a human-readable representation of an Object. 


J# 
public String toString() 


Property Value/Return Value 
A human-readable representation of an Object. 
Example 

// object_tostring.jsl 


public class MyObject extends Object 


{ 
public static void main(String[] args) 
sf 
// Create a new instance of MyObject. 
MyObject obj = new MyObject(); 
// Print out the string representation for obj. 
System.out.println("The string representation for obj is " + 
obj.toString()); 
} 
} 
/* 


Sample Output: 
The string representation for obj is MyObject@33c@d9d 


oy 


See Also 
Reference 
java.lang.Object 
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java.lang.Object.wait() 


Causes the currently executing thread to wait until another thread calls the notify method. 


J# 
public final void wait() throws InterruptedException 


Example 
// object_wait.jsl 


public class MyObject extends Object implements Runnable 
{ 
public static void main(String[] args) 
{ 
try 


{ 
// The object being used to call wait and notify on 


// must be synchronized. 
synchronized (obj) 


// Create a secondary thread used to call notify. 
Thread thr = new Thread(obj); 
thr.start(); 


// Wait for the secondary thread to call notify. 
System.out.println("waiting..."); 

obj.wait(); 

System.out.println("done waiting!"); 


// Join the secondary thread. 
thr. join(); 
} 


catch (InterruptedException ex) 


4 
} 


System.out.printin(ex.toString()); 


} 


// Implements Runnable.run() 
public void run() 


{ 
// The object being used to call wait and notify on 
// must be synchronized. 
synchronized (obj) 
{ 
// Call notify on the primary thread so it can 
// stop waiting. 
System.out.printin("\tnotifying..."); 
obj .notify(); 
System.out.println("\tdone notifying!"); 
} 
} 
private static MyObject obj = new MyObject(); 
} 
/* 
Output: 
waiting... 


notifying... 
done notifying! 
done waiting! 


a 





See Also 
Reference 


java.lang.Object 
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java.lang.Object.wait(long millis) 


Causes the currently executing thread to wait until another thread calls the notify method or for the specified duration. 


J# 


public final void wait(long millis) throws InterruptedException 


Parameters 





mils Th number of milliseconds to wait. 


Example 


// object_wait_2.jsl 


public class MyObject extends Object implements Runnable 


{ 
public static void main(String[] args) 
{ 
try 
{ 
// The object being used to call wait and notify on 
// must be synchronized. 
synchronized (obj) 
{ 
// Create a secondary thread used to call notify. 
Thread thr = new Thread(obj); 
thr.start(); 
// Wait either for the secondary thread to call 
// notify or for 500@ milliseconds. 
System.out.println("waiting..."); 
obj .wait (5000) ; 
System.out.println("done waiting!"); 
// Join the secondary thread. 
thr. join(); 
} 
} 
catch (InterruptedException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 


// Implements Runnable.run() 
public void run() 


{ 
// The object being used to call wait and notify on 
// must be synchronized. 
synchronized (obj) 
{ 
// Call notify on the primary thread so it can 
// stop waiting. 
System.out.println("\tnotifying..."); 
obj.notify(); 
System.out.println("\tdone notifying!"); 
} 
} 


private static MyObject obj = new MyObject(); 


f® 
Output: 
waiting... 
notifying... 
done notifying! 
done waiting! 


*/ 











See Also 
Reference 


java.lang.Object 
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java.lang.Object.wait(long millis, int nanos) 


Causes the currently executing thread to wait until another thread calls the notify method or for the specified duration. 


J# 


public final void wait(long millis, int nanos) throws InterruptedException 














Parameters 

Parameter Description 

millis The number of milliseconds to wait. 
nanos This parameter is ignored in J#. 
Example 





// object_wait_3.jsl 


public class MyObject extends Object implements Runnable 


{ 
public static void main(String[] args) 
{ 
try 
{ 
// The object being used to call wait and notify on 
// must be synchronized. 
synchronized (obj) 
{ 
// Create a secondary thread used to call notify. 
Thread thr = new Thread(obj); 
thr.start(); 
// Wait either for the secondary thread to call 
// notify or for 10000 milliseconds. 
System.out.println("waiting..."); 
obj.wait(10e0e0, @); 
System.out.println("done waiting!"); 
// Join the secondary thread. 
thr. join(); 
} 
} 
catch (InterruptedException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 


// Implements Runnable.run() 

public void run() 

{ 
// The object being used to call wait and notify on 
// must be synchronized. 
synchronized (obj) 


{ 
// Call notify on the primary thread so it can 
// stop waiting. 
System.out.printin("\tnotifying..."); 
obj.notify(); 
System.out.println("\tdone notifying!"); 

} 


private static MyObject obj = new MyObject(); 
} 


/* 
Output: 
waiting... 
notifying... 
done notifying! 
done waiting! 


ay 





See Also 
Reference 
java.lang.Object 
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java.lang.reflect 


Contains the classes and interfaces used to retrieve information on classes and objects. 


Classes 
Class |Description 
Field 






Provides access to the metadata and attributes of a field declared on a class. In addition, this class provides ways to ge 
t and set the value of a field dynamically. 





Method|Contains methods to obtain reflection information on method names, parameters, modifiers, and return values. It also 
provides a way to dynamically invoke methods. 








Interfaces 
Interfac |Description 








Member |An interface that contains methods to retrieve information about members, such as fields or methods, and construct 
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Array Class 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public final class java.lang.reflect.Array 
extends java.lang.Object 





Inheritance Hierarchy 
java.lang.Object 
java.lang.reflect.Array 


See Also 

Concepts 

Array Members 
java.lang.reflect Package 
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Array Members 


The following tables list the members exposed by the Array type. 


Public Constructors 


Name Description 


Array 





Public Methods 





Name Description 





equals (inherited from Object ) 





get 

getBoolean 

getByte 

getChar 

getDouble 

getFloat 

hashCode (inherited from Object ) 
getint 

getLength 

getLong 

getShort 

getClass (inherited from Object ) 
newlnstance Overloaded. 

set 

setBoolean 


setByte 





setChar 





setDouble 





setFloat 





setint 














setLong 





setShort 





toString Overridden. 











Protected Methods 
MemberwiseClone 


Performs a shallow copy of all members of the array. 


See Also 

Reference 

Array Class 

Concepts 
java.lang.reflect Package 
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Array Constructor 


Constructs an Arrays object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.util.Arrays(); 


Example ——________________céct___§_~" 


// Construct an arrays object: 
Arrays myArray = new Arrays(); 











Remarks 
The default constructor initializes any fields to their default values. 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 
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Array Methods 


Public Methods 





Name Description 





equals (inherited from Object) 





get 





getBoolean 





getByte 





getChar 
getDouble 
getFloat 
hashCode (inherited from Object) 
getint 
getLength 
getLong 
getShort 
getClass (inherited from Object) 
newlnstance Overloaded. 

set 
setBoolean 
setByte 
setChar 
setDouble 


setFloat 





setint 





setLong 





setShort 





toString Overridden. 














See Also 

Reference 

Array Class 

Concepts 
java.lang.reflect Package 
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Array.get Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.Object get( 

java.lang.Object ar, 

int ix) throws java.lang.IllegalArgumentException, java.lang.ArrayIndexOutOfBoundsExcep 
tion; 





Parameters 
ar 


See Also 

Reference 

Array Class 

Concepts 

Array Members 
java.lang.reflect Package 
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Array.getBoolean Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static boolean getBoolean( 

java.lang.Object ar, 

int ix) throws java.lang.IllegalArgumentException, java.lang.ArrayIndexOutOfBoundsExcep 
tion; 


Parameters 
ar 


See Also 

Reference 

Array Class 

Concepts 

Array Members 
java.lang.reflect Package 
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Array.getByte Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static byte getByte( 

java.lang.Object ar, 

int ix) throws java.lang.IllegalArgumentException, java.lang.ArrayIndexOutOfBoundsExcep 
tion; 


Parameters 
ar 


See Also 

Reference 

Array Class 

Concepts 

Array Members 
java.lang.reflect Package 
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Array.getChar Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static char getChar( 

java.lang.Object ar, 

int ix) throws java.lang.IllegalArgumentException, java.lang.ArrayIndexOutOfBoundsExcep 
tion; 


Parameters 
ar 


See Also 

Reference 

Array Class 

Concepts 

Array Members 
java.lang.reflect Package 
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Array.getDouble Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static double getDouble( 

java.lang.Object ar, 

int ix) throws java.lang.IllegalArgumentException, java.lang.ArrayIndexOutOfBoundsExcep 
tion; 


Parameters 
ar 


See Also 

Reference 

Array Class 

Concepts 

Array Members 
java.lang.reflect Package 


Visual J# Reference 


Array.getFloat Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static float getFloat( 

java.lang.Object ar, 

int ix) throws java.lang.IllegalArgumentException, java.lang.ArrayIndexOutOfBoundsExcep 
tion; 


Parameters 
ar 


See Also 

Reference 

Array Class 

Concepts 

Array Members 
java.lang.reflect Package 
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Array.getInt Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static int getInt( 

java.lang.Object ar, 

int ix) throws java.lang.IllegalArgumentException, java.lang.ArrayIndexOutOfBoundsExcep 
tion; 


Parameters 
ar 


See Also 

Reference 

Array Class 

Concepts 

Array Members 
java.lang.reflect Package 
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Array.getLength Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static int getLength( 
java.lang.Object ar) throws java.lang.IllegalArgumentException; 


Parameters 
ar 


See Also 

Reference 

Array Class 

Concepts 

Array Members 
java.lang.reflect Package 
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Array.getLong Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static long getLong( 

java.lang.Object ar, 

int ix) throws java.lang.IllegalArgumentException, java.lang.ArrayIndexOutOfBoundsExcep 
tion; 


Parameters 
ar 


See Also 

Reference 

Array Class 

Concepts 

Array Members 
java.lang.reflect Package 
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Array.getShort Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static short getShort( 

java.lang.Object ar, 

int ix) throws java.lang.IllegalArgumentException, java.lang.ArrayIndexOutOfBoundsExcep 
tion; 


Parameters 
ar 


See Also 

Reference 

Array Class 

Concepts 

Array Members 
java.lang.reflect Package 
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Array.newlnstance Method 


Overload List 





Name Description 





Array.newlnstance (Class, int) 





Array.newlnstance (Class, int[]) 











See Also 

Reference 

Array Class 

Concepts 

Array Members 
java.lang.reflect Package 
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Array.newlInstance Method (Class, Int32) 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.Object newInstance( 
java.lang.Class componentType, 
int len) throws java. lang.NegativeArraySizeException; 


Parameters 
componentType 


len 


See Also 

Reference 

Array Class 

Concepts 

Array Members 
java.lang.reflect Package 
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Array.newlInstance Method (Class, Int32[ ]) 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.Object newInstance( 
java.lang.Class componentType, 
int len) throws java. lang.NegativeArraySizeException; 


Parameters 
componentType 


len 


See Also 

Reference 

Array Class 

Concepts 

Array Members 
java.lang.reflect Package 
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Array.set Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static void set( 

java.lang.Object ar, 

int ix, 

java.lang.Object val) throws java.lang.IllegalArgumentException, java.lang.ArrayIndexOu 
toOfBoundsException; 


Parameters 
ar 


val 


See Also 

Reference 

Array Class 

Concepts 

Array Members 
java.lang.reflect Package 
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Array.setBoolean Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static void setBoolean( 

java.lang.Object ar, 

int ix, 

boolean bval) throws java.lang.IllegalArgumentException, java.lang.ArrayIndexOutOfBound 
sException; 


Parameters 
ar 


bval 


See Also 

Reference 

Array Class 

Concepts 

Array Members 
java.lang.reflect Package 
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Array.setByte Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static void setByte( 

java.lang.Object ar, 

int ix, 

byte bval) throws java.lang.IllegalArgumentException, java.lang.ArrayIndexOutOfBoundsEx 
ception; 


Parameters 
ar 


bval 


See Also 

Reference 

Array Class 

Concepts 

Array Members 
java.lang.reflect Package 
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Array.setChar Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static void setChar( 

java.lang.Object ar, 

int ix, 

char ch) throws java.lang.IllegalArgumentException, java.lang.ArrayIndexOutOfBoundsExce 
ption; 


Parameters 
ar 


ch 


See Also 

Reference 

Array Class 

Concepts 

Array Members 
java.lang.reflect Package 
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Array.setDouble Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static void setDouble( 

java.lang.Object ar, 

int ix, 

double dval) throws java.lang.IllegalArgumentException, java.lang.ArrayIndexOutOfBounds 
Exception; 


Parameters 
ar 


dval 


See Also 

Reference 

Array Class 

Concepts 

Array Members 
java.lang.reflect Package 
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Array.setFloat Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static void setFloat( 

java.lang.Object ar, 

int ix, 

float fval) throws java.lang.IllegalArgumentException, java.lang.ArrayIndexOutOfBoundsE 
xception; 


Parameters 
ar 


fval 


See Also 

Reference 

Array Class 

Concepts 

Array Members 
java.lang.reflect Package 
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Array.setint Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static void setInt( 

java.lang.Object ar, 

int ix, 

int ival) throws java.lang.IllegalArgumentException, java.lang.ArrayIndexOutOfBoundsExc 
eption; 


Parameters 
ar 


ival 


See Also 

Reference 

Array Class 

Concepts 

Array Members 
java.lang.reflect Package 
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Array.setLong Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static void setLong( 

java.lang.Object ar, 

int ix, 

long lval) throws java.lang.IllegalArgumentException, java.lang.ArrayIndexOutOfBoundsEx 
ception; 


Parameters 
ar 


lval 


See Also 

Reference 

Array Class 

Concepts 

Array Members 
java.lang.reflect Package 
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Array.setShort Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static void setShort( 

java.lang.Object ar, 

int ix, 

short sval) throws java.lang.IllegalArgumentException, java.lang.ArrayIndexOutOfBoundsE 
xception; 


Parameters 
ar 


sval 


See Also 

Reference 

Array Class 

Concepts 

Array Members 
java.lang.reflect Package 
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Constructor Class 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 





public final class java.lang.reflect.Constructor 
extends java.lang.Object 
implements java.lang.reflect.Member 





Inheritance Hierarchy 
java.lang.Object 
java.lang.reflect.Constructor 


See Also 

Concepts 

Constructor Members 
java.lang.reflect Package 
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Constructor Members 


The following tables list the members exposed by the Constructor type. 


Public Methods 
Name 


equals 


getDeclaringClass 


getExceptionTypes 


hashCode 


Description 


Overridden. 


Overridden. 





getModifiers 





getName 





getParameterTypes 





getClass 


(inherited from Object ) 





newlnstance 





toString 


Overridden. 








Name 


MemberwiseClone 





See Also 
Reference 
Constructor Class 
Concepts 


java.lang.reflect Package 


Protected Members 





Performs a shallow copy of the members. 
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Constructor Methods 


Public Methods 





Name Description 





equals Overridden. 





getDeclaringClass 





getExceptionTypes 





hashCode Overridden. 





getModifiers 
getName 
getParameterTypes 
getClass (inherited from Object ) 
newlnstance 


toString Overridden. 








Protected Methods 








Name Description 





MemberwiseClone Performs a shallow copy of the members. 











See Also 

Reference 

Constructor Class 
Concepts 
java.lang.reflect Package 


Visual J# Reference 


Constructor.equals Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public boolean equals( 
java.lang.Object obj); 





Parameters 


obj 


See Also 

Reference 

Constructor Class 
Concepts 

Constructor Members 
java.lang.reflect Package 


Visual J# Reference 


Constructor.getDeclaringClass Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Class getDeclaringClass(); 


See Also 

Reference 

Constructor Class 
Concepts 

Constructor Members 
java.lang.reflect Package 


Visual J# Reference 


Constructor.getExceptionTypes Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Class[] getExceptionTypes(); 


See Also 

Reference 

Constructor Class 
Concepts 

Constructor Members 
java.lang.reflect Package 


Visual J# Reference 


Constructor.hashCode Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public int hashCode(); 


See Also 

Reference 

Constructor Class 
Concepts 

Constructor Members 
java.lang.reflect Package 


Visual J# Reference 


Constructor.getModifiers Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public int getModifiers(); 


See Also 

Reference 

Constructor Class 
Concepts 

Constructor Members 
java.lang.reflect Package 


Visual J# Reference 


Constructor.getName Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getName(); 


See Also 

Reference 

Constructor Class 
Concepts 

Constructor Members 
java.lang.reflect Package 


Visual J# Reference 


Constructor.getParameterTypes Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Class[] getParameterTypes(); 


See Also 

Reference 

Constructor Class 
Concepts 

Constructor Members 
java.lang.reflect Package 


Visual J# Reference 


Constructor.newlnstance Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object newInstance( 

java.lang.Object[] initargs) throws java.lang.InstantiationException, java.lang.Illegal 
AccessException, java.lang.IllegalArgumentException, java.lang.reflect.InvocationTargetExce 
ption; 


Parameters 
initargs 


See Also 

Reference 

Constructor Class 
Concepts 

Constructor Members 
java.lang.reflect Package 


Visual J# Reference 


Constructor.toString Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toString(); 


See Also 

Reference 

Constructor Class 
Concepts 

Constructor Members 
java.lang.reflect Package 


Visual J# Reference 


Field Class 


Provides access to the metadata and attributes of a field declared on a class. In addition, this class provides ways to get and set 
the value of a field dynamically. 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public final class java.lang.reflect.Field 


extends java.lang.Object 
implements java.lang.reflect.Member 








Example 


This example covers many of the Field class methods and uses some of the methods explained in the java.lang.Class class. 














// Fid-General-example.jsl 
// Field gGeneral example 
import java.lang.reflect.*; 
public class MyClass 
{ 
private int myIntField; 
private float myFloatField; 
private Object myObjectField; 
public static void main(String[] args) throws SecurityException 
if 
// Declare and initialize a Class object: 
Class mc = MyClass.class; 
// Declare the array of fields: 
Field[] fields = mc.getDeclaredFields(); 
// Get the class name 
String name = mc.getName(); 
// Display the class name: 
System.out.println("The class name: " + name); 
// Dipslay all the declared fields: 
System.out.println("The fields are:"); 
for (int i = @; i<fields.length; i++) 
System.out.println(fields[i]); 
} 
} 
/* 
Output: 
The class name: MyClass 
The fields are: 
private int MyClass.myIntField 
private float MyClass.myFloatField 
private java.lang.Object MyClass.myObjectField 
af 
Remarks 


Various methods of the java.lang.Class class, such as java.lang.Class.getField(String fieldName), java.lang.Class.getFields(), 
java.lang.Class.getDeclaredField(String fieldName), and java.lang.Class.getDeclaredFields() return instances of Field objects 
corresponding to the fields of a class. 


Inheritance Hierarchy 
java.lang.Object 
java.lang.reflect.Field 


See Also 

Concepts 

Field Members 
java.lang.reflect Package 


Visual J# Reference 


Field Members 


Provides access to the metadata and attributes of a field declared on a class. In addition, this class provides ways to get and set 


the value of a field dynamically. 


The following tables list the members exposed by the Field type. 


Public Methods 








getDouble 


getFloat 


hashCode 


getint 


getLong 


getModifiers 


Name Description 

equals Overridden. Compares the current Field to a specified object. 

get Returns the value of a specific Field in the current object. 

getBoolean Retrieves the value of a static or instance field of the type boolean. 

getByte Retrieves the value of a static or instance field of the type byte. 

getChar Retrieves the value of a static or instance field of the type char or of another type that can be converted to c 


har. 


getDeclaringClass|Returns the name of the class that declares the current field object. 


Returns the value of a double field object or of another primitive type that can be converted to double. 


Returns the value of a float field object or of another primitive type that can be converted to float. 
Overridden. Returns the hash code of a Field object. 

Returns the value of a int field object or of another primitive type that can be converted to int. 
Returns the value of a long field object or of another primitive type that can be converted to long. 


Returns an int that represents the modifiers for the field in the current Field object. 

















getName Returns the name of the field of the current Field object. 

getShort Returns the value of a short field object or of another primitive type that can be converted to short. 
getType Returns the field type of the current field object. 

getClass (inherited from Object ) 

set Sets the value of the current field of the specified object to a specified value. 

setBoolean Sets the value of a boolean field on the current object. 

setByte Sets the value of a byte field on the current object. 

setChar Sets the value of a char field on the current object. 

setDouble Sets the value of a double field on the current object. 

setFloat Sets the value of a float field on the current object. 











setint Sets the value of an int field on the current object. 











setLong Sets the value of a long field on the current object. 
setShort Sets the value of a short field on the current object. 
toString Overridden. Returns the string description of the current Field object. 





Protected Methods 


Name Description 


MemberwiseClone Performs a shallow copy of the members. 








See Also 

Reference 

Field Class 

Concepts 
java.lang.reflect Package 





Visual J# Reference 


Field Methods 


Public Methods 




















Name Description 

equals Overridden. Compares the current Field to a specified object. 

get Returns the value of a specific Field in the current object. 

getBoolean Retrieves the value of a static or instance field of the type boolean. 

getByte Retrieves the value of a static or instance field of the type byte. 

getChar Retrieves the value of a static or instance field of the type char or of another type that can be converted to c 


har. 





getDeclaringClass/Returns the name of the class that declares the current field object. 

















getDouble Returns the value of a double field object or of another primitive type that can be converted to double. 
getFloat Returns the value of a float field object or of another primitive type that can be converted to float. 
hashCode Overridden. Returns the hash code of a Field object. 

getint Returns the value of a int field object or of another primitive type that can be converted to int. 
getLong Returns the value of a long field object or of another primitive type that can be converted to long. 





getModifiers 


Returns an int that represents the modifiers for the field in the current Field object. 





























getName Returns the name of the field of the current Field object. 

getShort Returns the value of a short field object or of another primitive type that can be converted to short. 
getType Returns the field type of the current field object. 

getClass (inherited from Object ) 

set Sets the value of the current field of the specified object to a specified value. 
setBoolean Sets the value of a boolean field on the current object. 

setByte Sets the value of a byte field on the current object. 

setChar Sets the value of a char field on the current object. 

setDouble Sets the value of a double field on the current object. 

setFloat Sets the value of a float field on the current object. 

setint Sets the value of an int field on the current object. 








setLong Sets the value of a long field on the current object. 





setShort Sets the value of a short field on the current object. 


toString Overridden. Returns the string description of the current Field object. 








Protected Methods 








Name Description 





MemberwiseClone Performs a shallow copy of the members. 











See Also 

Reference 

Field Class 

Concepts 
java.lang.reflect Package 


Visual J# Reference 


Field.equals Method 


Compares the current Field to a specified object. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public boolean equals( 
java.lang.Object obj); 


Parameters 


obj 
The object to compare to. 
Return Value 
true if the two objects are identical; false otherwise. 
Example 


// Fld-eqi.jsl 
// Field.Equals example 


import java.lang.reflect.*; 
public class MyClass 
public static void main(String[] args) 
throws java.lang.IllegalAccessException, 


java. lang.IllegalArgumentException, 
java. lang.NoSuchFieldException 


1 
// Declare and initialize a Class object: 
Class cls = java.awt.Point.class; 
// Declare and initialize a field object: 
Field field = cls.getField("x"); 
// Declare and initialize two Point objects: 
Object pl = new java.awt.Point(10, 20); 
Object p2 = new java.awt.Point(10, 30); 
// Declare and initialize two field objects: 
Object x1 = field.get(p1); 
Object x2 = field.get(p2); 
// Check if the two "x" fields are identical: 
System.out.printin(x1.Equals(x2)); 
} 
} 
/* 
Output 
true 
*/ 
See Also 
Reference 
Field Class 
Concepts 


Field Members 
java.lang.reflect Package 


Visual J# Reference 


Field.get Method 


Returns the value of a specific Field in the current object. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object get( 
java.lang.Object obj) throws java.lang.IllegalArgumentException, java.lang.IllegalAcces 
sException; 


Parameters 
obj 
The object that contains the specified field. 
Return Value 
The value of the specific Field in the current object. 
Example 
In this example, you retrieve the value of the field "x" on the current instance of the class java.awt.Point. 


// Fld-get1.jsl 
// Field.get example 


import java.lang.reflect.*; 
public class MyClass 
public static void main(String[] args) 
throws java.lang.IllegalAccessException, 


java. lang.IllegalArgumentException, 
java. lang.NoSuchFieldException 


1 
// Declare and initialize a Class object: 
Class mc = java.awt.Point.class; 
// Declare and initialize a field object: 
Field field = mc.getField("x"); 
// Declare and initialize a Point object: 
Object pl = new java.awt.Point(10, 20); 
// Display the value of the field represented by "field": 
System.out.println("The value of the 'x' field is: " + 
field.get(p1)); 
} 
i 
/* 
Output: 
The value of the 'x' field is: 10 
sir 
See Also 
Reference 
Field Class 
Concepts 


Field Members 
java.lang.reflect Package 


Visual J# Reference 


Field.getBoolean Method 


Retrieves the value of a static or instance field of the type boolean. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public boolean getBoolean( 
java.lang.Object obj) throws java.lang.IllegalArgumentException, java.lang.IllegalAcces 
sException; 


Parameters 


obj 
The object that contains the boolean value. 
Return Value 
The boolean value of the field. 
Example 
See the example on getByte. 


See Also 

Reference 

Field Class 

Concepts 

Field Members 
java.lang.reflect Package 


Visual J# Reference 


Field.getByte Method 


Retrieves the value of a static or instance field of the type byte. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public byte getByte( 
java.lang.Object obj) throws java.lang.IllegalArgumentException, java.lang.IllegalAcces 
sException; 


Parameters 
obj 
The object that contains the byte value. 
Return Value 
The byte value of the field. 
Example 


// Fld-getBy1.jsl 
// Field.getByte example 


import java.lang.reflect.*; 


public class MyClass 


{ 
public static void main(String[] args) 
throws java.lang.IllegalAccessException, 
java. lang.IllegalArgumentException, 
java. lang.NoSuchFieldException 
if 
// Declare a Class object: 
Class mc = java.lang.Byte.class; 
// Get a field: 
Field field = mc.getField("MIN_VALUE"); 
// Declare a Point object: 
Byte p1 = new Byte((byte)88); 
// Display the value of MIN VALUE represented by "field": 
System.out.println("The value of the 'MIN_VALUE' field is: " + 
field.getByte(p1)); 
} 
z 
/* 
Output: 
The value of the 'MIN_VALUE' field is: -128 
*/ 
See Also 
Reference 
Field Class 
Concepts 


Field Members 
java.lang.reflect Package 


Visual J# Reference 


Field.getChar Method 


Retrieves the value of a static or instance field of the type char or of another type that can be converted to char. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public char getChar( 
java.lang.Object obj) throws java.lang.IllegalArgumentException, java.lang.IllegalAcces 
sException; 


Parameters 


obj 
The object that contains the char value. 
Return Value 
The char value of the field. 
Example 
See the example on getByte. 


See Also 

Reference 

Field Class 

Concepts 

Field Members 
java.lang.reflect Package 


Visual J# Reference 


Field.getDeclaringClass Method 


Returns the name of the class that declares the current field object. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Class getDeclaringClass(); 


Return Value 
The name of the class that declares the current field object. 
Example 


// Fld-getDclass1.jsl 
// Field.getDeclaringClass example 


import java.lang.reflect.*; 
public class MyClass 
public static void main(String[] args) 


throws java.lang.NoSuchFieldException, 
java. lang.NoSuchFieldException 


{ 
// Declare and initialize a Class object: 
Class mc = java.lang.Integer.class; 
// Declare and initialize a field object: 
Field field = mc.getField("MAX_VALUE"); 
// Get and display the declaring class name: 
Class dc = field.getDeclaringClass(); 
System.out.println("The declaring class is: " + dc); 
} 
} 
/* 
Output: 
The declaring class is: class java.lang.Integer 
m/e 
See Also 
Reference 
Field Class 
Concepts 


Field Members 
java.lang.reflect Package 


Visual J# Reference 


Field.getDouble Method 


Returns the value of a double field object or of another primitive type that can be converted to double. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public double getDouble( 
java.lang.Object obj) throws java.lang.IllegalArgumentException, java.lang.IllegalAcces 
sException; 


Parameters 


obj 
The object that contains the double value. 
Return Value 
The double value of the field. 
Example 
See the example on getByte. 


See Also 

Reference 

Field Class 

Concepts 

Field Members 
java.lang.reflect Package 


Visual J# Reference 


Field.getFloat Method 


Returns the value of a float field object or of another primitive type that can be converted to float. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public float getFloat( 
java.lang.Object obj) throws java.lang.IllegalArgumentException, java.lang.IllegalAcces 
sException; 


Parameters 


obj 
The object that contains the float value. 
Return Value 
The float value of the field. 
Example 
See the example on getByte. 


See Also 

Reference 

Field Class 

Concepts 

Field Members 
java.lang.reflect Package 


Visual J# Reference 


Field.hashCode Method 


Returns the hash code of a Field object. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public int hashCode(); 


Return Value 
The hash code of the Field object. 
Example 


// Fld-getHcode1.jsl 
// Field.GetHashCode example 


import java.lang.reflect.*; 
public class MyClass 
public static void main(String[] args) 
throws java.lang.IllegalAccessException, 


java. lang.IllegalArgumentException, 
java. lang.NoSuchFieldException 


1 
// Declare and initialize a Class object: 
Class mc = java.lang.Byte.class; 
// Declare and initialize a field object: 
Field field = mc.getField("MIN_VALUE"); 
// Display hash code of the field: 
System.out.println("The hash code of the field is: 
field.GetHashCode()); 
} 
} 
/* 
Output: 
The hash code of the field is: 1704215444 
*/ 
See Also 
Reference 
Field Class 
Concepts 


Field Members 
java.lang.reflect Package 


Visual J# Reference 


Field.getint Method 


Returns the value of a int field object or of another primitive type that can be converted to int. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public int getInt( 
java.lang.Object obj) throws java.lang.IllegalArgumentException, java.lang.IllegalAcces 
sException; 


Parameters 


obj 
The object that contains the int value 
Return Value 
The int value of the field. 
Example 
See the example on getByte. 


See Also 

Reference 

Field Class 

Concepts 

Field Members 
java.lang.reflect Package 


Visual J# Reference 


Field.getLong Method 


Returns the value of a long field object or of another primitive type that can be converted to long. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public long getLong( 
java.lang.Object obj) throws java.lang.IllegalArgumentException, java.lang.IllegalAcces 
sException; 


Parameters 


obj 
The object that contains the long value. 
Return Value 
The long value of the field. 
Example 
See the example on getByte. 


See Also 

Reference 

Field Class 

Concepts 

Field Members 
java.lang.reflect Package 


Visual J# Reference 


Field.getModifiers Method 


Returns an int that represents the modifiers for the field in the current Field object. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public int getModifiers(); 


Return Value 


The modifiers for the field in the current Field object. This is a bitset representing a combination of modifiers defined in the 
Modifier class. 


Example 


// Fld-getmod1.jsl 
// Field.getModifiers example 


import java.lang.reflect.*; 


public class MyClass 


if 
public static void main(String[] args) 
throws java.lang.IllegalAccessException, 
java. lang.IllegalArgumentException, 
java. lang.NoSuchFieldException 
1 
// Declare and initialize a Class object: 
Class mc = java.lang.Byte.class; 
// Declare and initialize a field object: 
Field field = mc.getField("MIN_VALUE"); 
// Get the integer value of the modifiers: 
int mod = field. getModifiers(); 
// Get the string value of the modifiers: 
System.out.printin("The modifiers are: " + 
Modifier.toString(mod) ); 
} 
} 
LF 
Output: 
The modifiers are: public static final 
*/ 
See Also 
Reference 
Field Class 
Concepts 


Field Members 
java.lang.reflect Package 


Visual J# Reference 


Field.getName Method 


Returns the name of the field of the current Field object. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getName(); 


Return Value 
The name of the field of the current Field object. 
Example 


// Fld-getName1.jsl 
// Field.getName example 


import java.lang.reflect.*; 
public class MyClass 
public static void main(String[] args) 


throws java.lang.NoSuchFieldException , 
java. lang.NoSuchFieldException 


{ 
// Declare and initialize a Class object: 
Class mc = java.lang.Integer.class; 
// Declare and initialize a field object: 
Field field = mc.getField("MAX_VALUE"); 
// Get and display the field's name: 
String name = field.getName() ; 
System.out.println("The field name is: " + field.getName()); 
} 
} 
/* 
Output: 
The field name is: MAX_VALUE 
*/ 
See Also 
Reference 
Field Class 
Concepts 


Field Members 
java.lang.reflect Package 


Visual J# Reference 


Field.getShort Method 


Returns the value of a short field object or of another primitive type that can be converted to short. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public short getShort( 
java.lang.Object obj) throws java.lang.IllegalArgumentException, java.lang.IllegalAcces 
sException; 


Parameters 


obj 
The object that contains the short value. 
Return Value 
The short value of the field. 
Example 
See the example on getByte. 


See Also 

Reference 

Field Class 

Concepts 

Field Members 
java.lang.reflect Package 


Visual J# Reference 


Field.getType Method 


Returns the field type of the current field object. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Class getType(); 


Return Value 
The field type of the current field object. 
Example 


// Flid-getTyp1.jsl 
// Field.getType example 


import java.lang.reflect.*; 
public class MyClass 
public static void main(String[] args) 


throws java.lang.NoSuchFieldException, 
java. lang.NoSuchFieldException 


{ 
// Declare and initialize a Class object: 
Class mc = java.lang.Integer.class; 
// Declare and initialize a field object: 
Field field = mc.getField("MAX_VALUE"); 
// Get and display the type of the field: 
Class ft = field.getType(); 
System.out.println("The type of the field is: " + ft); 
} 
} 
/* 
Output: 
The type of the field is: int 
*/ 
See Also 
Reference 
Field Class 
Concepts 


Field Members 
java.lang.reflect Package 


Visual J# Reference 


Field.set Method 


Sets the value of the current field of the specified object to a specified value. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public void set( 

java.lang.Object obj, 

java.lang.Object value) throws java.lang.IllegalArgumentException, java.lang.IllegalAcc 
essException; 


Parameters 


obj 

The object that contains the field to be modified. 
value 

The new value of the field to be set. 
Example 


// Fld-set1.jsl 
// Field.set example 


import java.lang.reflect.*; 


public class MyClass 
{ 
public static void main(String[] args) 
throws java.lang.IllegalAccessException, 
java. lang.IllegalArgumentException, 
java. lang.NoSuchFieldException 


// Declare and initialize a Class object: 
Class mc = java.awt.Point.class; 


// Declare and initialize a field object: 
Field field = mc.getField("x"); 


// Declare and initialize a Point object: 
Object pl = new java.awt.Point(10, 20); 


// Display the value of the field represented by "field": 

System.out.println("The current value of the 'x' field is: " + 
field.get(p1)); 

// Set the value of the field to 25: 

field.set(p1,new Integer(25)); 


// Display the new value of the field represented by "field": 


System.out.println("The new value of the 'x' field is: + 
field.get(p1)); 


} 


/* 

Output: 

The current value of the 'x' field is: 10 
The new value of the 'x' field is: 25 

*/ 


See Also 
Reference 


Field Class 

Concepts 

Field Members 
java.lang.reflect Package 


Visual J# Reference 


Field.setBoolean Method 


Sets the value of a boolean field on the current object. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public void setBoolean( 
java.lang.Object obj, 
boolean z) throws java.lang.IllegalArgumentException, java.lang.IllegalAccessException; 


Parameters 


obj 


The object that contains the field to be set. 


The new value of the field. 
Example 
See the example on setint. 


See Also 

Reference 

Field Class 

Concepts 

Field Members 
java.lang.reflect Package 


Visual J# Reference 


Field.setByte Method 


Sets the value of a byte field on the current object. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public void setByte( 
java.lang.Object obj, 
byte b) throws java.lang.IllegalArgumentException, java.lang.IllegalAccessException; 


Parameters 


obj 
The object that contains the field to be set. 
b 
The new value of the field. 
Example 
See the example on setint. 


See Also 

Reference 

Field Class 

Concepts 

Field Members 
java.lang.reflect Package 


Visual J# Reference 


Field.setChar Method 


Sets the value of a char field on the current object. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public void setChar( 
java.lang.Object obj, 
char c) throws java.lang.IllegalArgumentException, java.lang.IllegalAccessException; 


Parameters 


obj 


The object that contains the field to be set. 


The new value of the field. 
Example 
See the example on setint. 


See Also 

Reference 

Field Class 

Concepts 

Field Members 
java.lang.reflect Package 


Visual J# Reference 


Field.setDouble Method 


Sets the value of a double field on the current object. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public void setDouble( 
java.lang.Object obj, 
double d) throws java.lang.IllegalArgumentException, java. lang.IllegalAccessException; 


Parameters 


obj 
The object that contains the field to be set. 
d 
The new value of the field. 
Example 
See the example on setint. 


See Also 

Reference 

Field Class 

Concepts 

Field Members 
java.lang.reflect Package 


Visual J# Reference 


Field.setFloat Method 


Sets the value of a float field on the current object. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public void setFloat( 
java.lang.Object obj, 
float f) throws java.lang.IllegalArgumentException, java.lang.IllegalAccessException; 


Parameters 


obj 


The object that contains the field to be set. 


The new value of the field. 
Example 
See the example on setint. 


See Also 

Reference 

Field Class 

Concepts 

Field Members 
java.lang.reflect Package 


Visual J# Reference 


Field.setint Method 


Sets the value of an int field on the current object. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public void setInt( 
java.lang.Object obj, 
int i) throws java.lang.IllegalArgumentException, java.lang.IllegalAccessException; 


Parameters 


obj 


The object that contains the field to be set. 


The new value of the field. 
Example 


// Fid-setInt1.jsl 
// Field.setInt example 


import java.lang.reflect.*; 


public class MyClass 
{ 
public static void main(String[] args) 
throws java.lang.IllegalAccessException, 
java. lang.IllegalArgumentException, 
java. lang.NoSuchFieldException 


// Declare and initialize a Class object: 
Class mc = java.awt.Point.class; 


// Declare and initialize a field object: 
Field field = mc.getField("x"); 


// Declare and initialize a Point object: 
Object pl = new java.awt.Point(10, 20); 


// Display the value of the field represented by "field": 

System.out.printlin("The current value of the 'x' field is: " + 
field.get(p1)); 

// Set the value of the field to 22: 

field.setInt(p1, 22); 


// Display the new value of the field represented by "field": 


System.out.println("The new value of the 'x' field is: + 
field.get(p1)); 


} 


/* 

Output: 

The current value of the 'x' field is: 10 
The new value of the 'x' field is: 22 


*/ 


See Also 
Reference 
Field Class 


Concepts 
Field Members 
java.lang.reflect Package 


Visual J# Reference 


Field.setLong Method 


Sets the value of a long field on the current object. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public void setLong( 
java.lang.Object obj, 
long 1) throws java.lang.IllegalArgumentException, java.lang.IllegalAccessException; 


Parameters 


obj 


The object that contains the field to be set. 


The new value of the field. 
Example 
See the example on setint. 


See Also 

Reference 

Field Class 

Concepts 

Field Members 
java.lang.reflect Package 


Visual J# Reference 


Field.setShort Method 


Sets the value of a short field on the current object. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public void setShort( 
java.lang.Object obj, 
short s) throws java.lang.IllegalArgumentException, java.lang.IllegalAccessException; 


Parameters 


obj 


The object that contains the field to be set. 


The new value of the field. 
Example 
See the example on setint. 


See Also 

Reference 

Field Class 

Concepts 

Field Members 
java.lang.reflect Package 


Visual J# Reference 


Field.toString Method 


Returns the string description of the current Field object. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toString(); 


Return Value 
The string description of the current Field object. 
Example 


// Fld-toStr1.jsl 
// Field.toString example 


import java.lang.reflect.*; 
public class MyClass 


public static void main(String[] args) 
throws java.lang.NoSuchFieldException, 
java. lang.NoSuchFieldException 


// Declare and initialize a Class object: 
Class mc = java.lang.Integer.class; 


// Declare and initialize a field object: 
Field field = mc.getField("MAX_VALUE"); 


// Display the description of the field: 
System.out.println( 
"The description of the field is:\n" + 
field.toString()); 


} 


/* 

Output: 

The description of the field is: 

public static final int java.lang.Integer.MAX_VALUE 
*/ 


See Also 

Reference 

Field Class 

Concepts 

Field Members 
java.lang.reflect Package 


Visual J# Reference 


InvocationTargetException Class 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public class java.lang.reflect.InvocationTargetException 
extends java.lang.Exception 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.lang.reflect.InvocationTargetException 


See Also 

Concepts 

InvocationTargetException Members 
java.lang.reflect Package 


Visual J# Reference 


InvocationTargetException Members 


The following tables list the members exposed by the InvocationTargetException type. 


Public Constructors 
Name 


InvocationTargetException 





Public Properties (see also Protected Properties ) 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 
Message 
Source 
StackTrace 


TargetSite 


Protected Properties 


(inherited from Exception ) 
(inherited from Exception ) 
(inherited from Exception ) 
(inherited from Exception ) 


(inherited from Exception ) 





Name 


Description 





HResult 





(inherited from Exception ) 





Public Methods 
Name 


equals 


filllnStackTrace 


GetBaseException 


hashCode 


getLocalizedMessage 


Description 


(inherited from Object ) 
(inherited from Throwable ) 
(inherited from Exception ) 
(inherited from Object ) 


(inherited from Throwable ) 











getMessage (inherited from Throwable ) 
GetObjectData Overridden. 
getTargetException 

getClass (inherited from Object ) 
clone (inherited from Throwable ) 





printStackTrace 





Overloaded. (inherited from Throwable ) 











toString (inherited from Throwable ) 





Protected Methods 
Name 


finalize (inherited from Object ) 








See Also 

Reference 
InvocationTargetException Class 
Concepts 

java.lang.reflect Package 





Visual J# Reference 


InvocationTargetException Constructor 


Overload List 





Name Description 





InvocationTargetException () 





InvocationTargetException (Throwable) 





InvocationTargetException (SerializationInfo, StreamingContext) 





InvocationTargetException (String, Exception) 





InvocationTargetException (Throwable, String) 








See Also 

Reference 
InvocationTargetException Class 
Concepts 

InvocationTargetException Members 
java.lang.reflect Package 
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InvocationTargetException Constructor () 


Initializes a new instance of the InvocationTargetException Class . 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


protected java.lang.reflect.InvocationTargetException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
InvocationTargetException Class 
Concepts 

InvocationTargetException Members 
java.lang.reflect Package 
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InvocationTargetException Constructor (Throwable) 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public java.lang.reflect.InvocationTargetException( 
java.lang.Throwable exc); 


Parameters 
EXC 


See Also 

Reference 
InvocationTargetException Class 
Concepts 

InvocationTargetException Members 
java.lang.reflect Package 
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InvocationTargetException Constructor (Serialization|nfo, 
StreamingContext) 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


protected java.lang.reflect.InvocationTargetException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


context 


See Also 

Reference 
InvocationTargetException Class 
Concepts 

InvocationTargetException Members 
java.lang.reflect Package 
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InvocationTargetException Constructor (String, Exception) 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public java.lang.reflect.InvocationTargetException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
S 


inner 


See Also 

Reference 
InvocationTargetException Class 
Concepts 

InvocationTargetException Members 
java.lang.reflect Package 


Visual J# Reference 


InvocationTargetException Constructor (Throwable, String) 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public java.lang.reflect.InvocationTargetException( 
java.lang.Throwable exc, 
java.lang.String msg); 


Parameters 
exc 


msg 


See Also 

Reference 
InvocationTargetException Class 
Concepts 

InvocationTargetException Members 
java.lang.reflect Package 
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InvocationTargetException Methods 


Public Methods 






































Name Description 

equals (inherited from Object ) 
filllnStackTrace (inherited from Throwable ) 
GetBaseException (inherited from Exception ) 
hashCode (inherited from Object ) 
getLocalizedMessage (inherited from Throwable ) 
getMessage (inherited from Throwable ) 
GetObjectData Overridden. 
getTargetException 

getClass (inherited from Object ) 
clone (inherited from Throwable ) 
printStackTrace Overloaded. (inherited from Throwable ) 
toString (inherited from Throwable ) 
Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 

InvocationTargetException Class 

Concepts 


java.lang.reflect Package 


Visual J# Reference 


InvocationTargetException.GetObjectData Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public void GetObjectData( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


context 


See Also 

Reference 
InvocationTargetException Class 
Concepts 

InvocationTargetException Members 
java.lang.reflect Package 


Visual J# Reference 


InvocationTargetException.getTargetException Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Throwable getTargetException(); 


See Also 

Reference 
InvocationTargetException Class 
Concepts 

InvocationTargetException Members 
java.lang.reflect Package 


Visual J# Reference 


InvocationTargetException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 


InvocationTargetException Class 


Concepts 
java.lang.reflect Package 
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Member Interface 


An interface that contains methods to retrieve information about members, such as fields or methods, and constructors. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 





public interface java.lang.reflect.Member 





See Also 

Concepts 

Member Members 
java.lang.reflect Package 
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Member Members 


An interface that contains methods to retrieve information about members, such as fields or methods, and constructors. 


The following tables list the members exposed by the Member type. 


Public Fields 
Name Description 








DECLARED  |Aconstant that represents declared members such as fields, constructors, and methods. 











PUBLIC A constant that represents all public members such as fields, constructors, and methods. 








Public Methods 





Name Description 





getDeclaringClass Returns the declaring class of the current Member object. 





getModifiers Returns an int that represents the modifiers for the member or constructor in the current Member object. 





getName Returns the name of the current Member object. 











See Also 

Reference 

Member Interface 
Concepts 
java.lang.reflect Package 


Visual J# Reference 


Member Fields 


Public Fields 





Name Description 





DECLARED |Aconstant that represents declared members such as fields, constructors, and methods. 

















PUBLIC A constant that represents all public members such as fields, constructors, and methods. 
See Also 

Reference 

Member Interface 

Concepts 


java.lang.reflect Package 


Visual J# Reference 


Member.DECLARED Field 


A constant that represents declared members such as fields, constructors, and methods. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 





public static final int DECLARED; 


Example OOOO 


// Mor-dec1.jsl 
// Member.DECLARED example 


import java.lang.reflect.*; 


public class MyClass 











{ 
public static void main(String[] args) 
, 
// Get and display the Member fields: 
int d1 = Member.DECLARED; 
int d2 = Member.PUBLIC; 
System.out.println(d1+"\n"+ d2); 
} 
} 
/* 
Output: 
1 
4) 
*/ 
See Also 
Reference 
Member Interface 
Concepts 


Member Members 
java.lang.reflect Package 


Visual J# Reference 


Member.PUBLIC Field 


A constant that represents all public members such as fields, constructors, and methods. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 





public static final int PUBLIC; 





Example 
See the example on DECLARED. 


See Also 

Reference 

Member Interface 
Concepts 

Member Members 
java.lang.reflect Package 


Visual J# Reference 


Member Methods 


Public Methods 





Name Description 





getDeclaringClass |Returns the declaring class of the current Member object. 





getModifiers Returns an int that represents the modifiers for the member or constructor in the current Member object. 





getName Returns the name of the current Member object. 











See Also 

Reference 

Member Interface 
Concepts 
java.lang.reflect Package 
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Member.getDeclaringClass Method 


Returns the declaring class of the current Member object. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.Class getDeclaringClass(); 


Return Value 
The declaring class of the current Member object. 
Example 


// Mbr-getdc1.jsl 
// Member.getDeclaringClass example 


import java.lang.reflect.*; 
public class MyClass 


public static void main(String[] args) 
throws java.lang.NoSuchFieldException, 
java. lang.NoSuchFieldException 


// Declare and initialize a Class object: 
Class mc = java.lang.Integer.class; 


// Declare and initialize a field object: 
Field field = mc.getField("MAX_VALUE"); 


// Get and display the field's declaring class: 
Class dc = field.getDeclaringClass(); 
System.out.println("The declaring class is:\n" + dc); 


} 


/* 

Output: 

The declaring class is: 
class java.lang.Integer 


ai 


See Also 

Reference 

Member Interface 
Concepts 

Member Members 
java.lang.reflect Package 
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Member.getModifiers Method 


Returns an int that represents the modifiers for the member or constructor in the current Member object. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public abstract int getModifiers(); 


Return Value 
The modifiers for the member or constructor in the current Member object. 
Example 


// Mbr-getmod1.jsl 
// Member.getModifiers example 


import java.lang.reflect.*; 
public class MyClass 


public static void main(String[] args) 
throws java.lang.NoSuchFieldException, 
java. lang.NoSuchFieldException 


// Declare and initialize a Class object: 
Class mc = java.lang.Integer.class; 


// Declare and initialize a field object: 
Field field = mc.getField("MAX_VALUE"); 


// Display the field: 
System.out.printlin("The field is:\n" + field); 


// Get the value of the modifiers: 
int mod = field. getModifiers(); 


// Display the description of the modifiers: 
System.out.print1n( 
"The modifiers of the field are:\n" + 
Modifier.toString(mod) ) ; 


} 


/* 

Output: 

The field is: 

public static final int java.lang.Integer.MAX_VALUE 
The modifiers of the field are: 

public static final 

*/ 


See Also 

Reference 

Member Interface 
Concepts 

Member Members 
java.lang.reflect Package 
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Member.getName Method 


Returns the name of the current Member object. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String getName(); 


Return Value 
The name of the current Member object. 
Example 


// Mbr-getname1.jsl 
// Member.getName example 


import java.lang.reflect.*; 
public class MyClass 


public static void main(String[] args) 
throws java.lang.NoSuchFieldException, 
java. lang.NoSuchFieldException 


// Declare and initialize a Class object: 
Class mc = java.lang.Integer.class; 


// Declare and initialize a field object: 
Field field = mc.getField("MAX_VALUE"); 


// Get and display the field's name: 
String name = mc.getName()+"."+field.getName() ; 
System.out.println("The name of the field is:\n" + name); 


} 


/* 

Output: 

The name of the field is: 
java. lang. Integer .MAX_VALUE 
*/ 


See Also 

Reference 

Member Interface 
Concepts 

Member Members 
java.lang.reflect Package 
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Method Class 


Contains methods to obtain reflection information on method names, parameters, modifiers, and return values. It also provides 
a way to dynamically invoke methods. 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public final class java.lang.reflect.Method 


extends java.lang.Object 
implements java.lang.reflect.Member 








Inheritance Hierarchy 
java.lang.Object 
java.lang.reflect.Method 


See Also 

Concepts 

Method Members 
java.lang.reflect Package 
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Method Members 


Contains methods to obtain reflection information on method names, parameters, modifiers, and return values. It also provides 


a way to dynamically invoke methods. 


The following tables list the members exposed by the Method type. 


Public Methods 


Name 


equals 


getDeclaringClass 


getExceptionTypes 


Description 


Overridden. Checks the equality between the current Method object and a specified object. 


Gets the class in which this method is declared. 


Returns a class object array that contains the exceptions to be thrown by the current Method object. 





hashCode 


Overridden. Retrieves the hash code for the current Method object. 





getModifiers 


Returns the modifiers defined on the current Method object. 























getName Returns the method name of the current Method object. 

getParameterTypes |Returns the parameter types of a Method object. 

getReturnType Returns the return type for a Method object. 

getClass (inherited from Object ) 

invoke Invokes the current Method object on the specified object with the specified parameters. 
toString Overridden. Returns the string representation of a Method object. 





Protected Methods 


MemberwiseClone 


Performs a shallow copy of the object. 


See Also 
Reference 
Method Class 
Concepts 


java.lang.reflect Package 
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Method Methods 


Public Methods 





Name Description 





equals Overridden. Checks the equality between the current Method object and a specified object. 





getDeclaringClass |Gets the class in which this method is declared. 





getExceptionTypes |Returns a class object array that contains the exceptions to be thrown by the current Method object. 








hashCode Overridden. Retrieves the hash code for the current Method object. 
getModifiers Returns the modifiers defined on the current Method object. 
getName Returns the method name of the current Method object. 


getParameterTypes |Returns the parameter types of a Method object. 


getReturnType Returns the return type for a Method object. 

getClass (inherited from Object ) 

invoke Invokes the current Method object on the specified object with the specified parameters. 
toString Overridden. Returns the string representation of a Method object. 





Protected Methods 
MemberwiseClone 


Performs a shallow copy of the object. 


See Also 

Reference 

Method Class 

Concepts 
java.lang.reflect Package 
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Method.equals Method 


Checks the equality between the current Method object and a specified object. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public boolean equals( 
java.lang.Object obj); 


Parameters 
obj 
The object to compare to. 
Return Value 
true if the two objects are equal; false otherwise. 
Example 


// meth-eq1.jsl 
// Method.Equals example 


import java.lang.reflect.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Declare a Class object: 
Class mc = MyClass.class; 
// Declare the an array of methods: 
Method[] methArr = mc.getMethods(); 
// Get the parameter types: 
System.out.println("The method is:"); 
for (int i=0; i<methArr.length; i++) 
{ 
if("sample".Equals(methArr[i].getName())) 
System.out.println(methArr[i]); 
} 
} 
public void sample (byte b, short s, int i, float f, double d) 
L2 
} 
/* 
Output: 


The method is: 
public void MyClass.sample(byte, short, int, float, double) 
“af 


See Also 

Reference 

Method Class 

Concepts 

Method Members 
java.lang.reflect Package 
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Method.getDeclaringClass Method 


Gets the class in which this method is declared. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Class getDeclaringClass(); 


Return Value 

The name of the class in which the method is declared. 

Example 

In this example, you retrieve and display the declaring class for the method "sample," which is declared in the same class 


(MyClass). 


// meth-getDecCl11.jsl 
// Method.getDeclaringClass example 


import java.lang.reflect.*; 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Declare a Class object: 
Class mc = MyClass.class; 
// Declare the an array of methods: 
Method[] methArr = mc.getMethods(); 
// Get the declaring class: 
System.out.println("The declaring class is:"); 
for (int i=0; i<methArr.length; i++) 
{ 
// Get the declaring class for sample() only: 
if("sample".Equals(methArr[i].getName())) 
System.out.println(methArr[i].getDeclaringClass()); 
} 
} 
// Declare a "Sample" method just for testing: 
public void sample (byte b, short s, int i, float f, double d) 
1.2 
z 
/* 
Output: 


The declaring class is: 
class MyClass 
e/ 


See Also 

Reference 

Method Class 

Concepts 

Method Members 
java.lang.reflect Package 
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Method.getExceptionTypes Method 


Returns a class object array that contains the exceptions to be thrown by the current Method object. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Class[] getExceptionTypes(); 


Return Value 
The exceptions to be thrown by the current Method object. 
Example 


In this example, you list all the exceptions associated with the methods in the class java.io.BufferedinputStream. You can also 
display the method names by removing the comment from the line indicated in the code. 


// meth-getEx1.jsl 
// Method.getExceptionTypes example 


import java.lang.reflect.*; 


public class MyClass 
{ 


public static void main(String[] args) 
if 
// Declare a Class object: 
Class mc = java.io.BufferedInputStream.class; 


// Declare the an array of methods: 
Method[] methArr = mc.getMethods(); 


// Display methods and exceptions: 
for (int i=@; i<methArr.length; i++) 
{ 

// Uncomment the following line to get method names as well: 

// System.out.println("Method: " + methArr[i]); 

Class[] ex = methArr[i].getExceptionTypes(); 

for (int j=0; j<ex.length; j++) 

System.out.println("Exception: 


+ ex[Jj]); 


} 


/* 

Output: 

Exception: class java.lang.InterruptedException 
Exception: class java.lang.InterruptedException 
Exception: class java.lang.InterruptedException 
Exception: class java.io. IOException 

Exception: class java.io. IOException 

Exception: class java.io. IOException 

Exception: class java.io.IOException 

Exception: class java.io.IOException 

Exception: class java.io.IOException 

Exception: class java.io. IOException 


*/ 


See Also 
Reference 
Method Class 
Concepts 


Method Members 
java.lang.reflect Package 


Visual J# Reference 


Method.hashCode Method 


Retrieves the hash code for the current Method object. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public int hashCode(); 


Return Value 
The hash code for the current Method object. 
Example 


This example lists the hash code values for all the methods on the class java.io.BufferedinputStream. 


// meth-getHCode1.jsl 
// Method.GetHashCode example 


import java.lang.reflect.*; 


public class MyClass 
{ 
public static void main(String[] args) 
{ 
// Declare a Class object: 
Class mc = java.io.BufferedInputStream.class; 


// Declare the an array of methods: 
Method[] methArr = mc.getMethods(); 


// Display hash code for the methods: 
for (int i=0; i<methArr.length; i++) 
System.out.println(methArr[i].GetHashCode()); 


/* 

Output: 
1434567118 
1555087625 
1818432310 
- 1886973443 
- 1886973443 
- 1886973443 
676000111 
-1861917916 
- 1707723623 
185017471 

- 1707465506 
- 1707465506 
-1754479707 
- 1707389895 
1505445493 
678854254 
564763867 
523916199 
*/ 


See Also 
Reference 
Method Class 


Concepts 
Method Members 
java.lang.reflect Package 
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Method.getModifiers Method 


Returns the modifiers defined on the current Method object. 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public 


Return Value 


int getModifiers(); 


The modifiers of the current Method object. Modifiers are returned as an integer that is a combination of bits defined in the 
Modifier class. 


Example 


This example lists the modifiers of all the methods on the class java.io.BufferedinputStream. 


// meth-getMod1.jsl 
// Method.getModifiers example 


import 


public 
{ 


java.lang.reflect.*; 


class MyClass 


public static void main(String[] args) 


d 


} 
/* 


Output: 


public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 


// Declare a Class object: 
Class mc = java.io.BufferedInputStream.class; 


// Declare the method array: 
Method[] methArr = mc.getMethods(); 


// Get the modifiers of the methods: 
System.out.println("The modifiers are:"); 
for (int i=@; i<methArr.length; i++) 
{ 
// Get the modifier integer: 
int mod = methArr[i].getModifiers(); 
// Convert the integer to a description string: 
System.out.println(Modifier.toString(mod) ) ; 


final 
final 
final 
final 
final 
final 
synchronized 
synchronized 
synchronized 


synchronized 
synchronized 
synchronized 
synchronized 





See Also 

Reference 

Method Class 

Concepts 

Method Members 
java.lang.reflect Package 
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Method.getName Method 


Returns the method name of the current Method object. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getName(); 


Return Value 
The method name of the current Method object. 
Example 


This example lists the method names of the methods on the class java.io.BufferedinputStream. 


// meth-getName.jsl 
// Method.getName example 


import java.lang.reflect.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Declare a Class object: 
Class cls = MyClass.class; 
// Get declared methods: 
Method[] meth = cls.getDeclaredMethods(); 
// Display the names of the declared methods: 
System.out.println("The declared methods are:"); 
for (int i=@; i<meth.length; i++) 
System.out.println(meth[i].getName()); 
} 
} 
/* 
Output: 
The declared methods are: 
main 
uf: 
See Also 
Reference 
Method Class 
Concepts 


Method Members 
java.lang.reflect Package 
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Method.getParameterTypes Method 


Returns the parameter types of a Method object. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Class[] getParameterTypes(); 


Return Value 
The parameter types of the Method object. 
Example 


// meth-getparTyp1.jsl 
// Method.getParameterTypes example 


import java.lang.reflect.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Declare a Class object: 
Class mc = MyClass.class; 
// Declare the an array of methods: 
Method[] methArr = mc.getMethods(); 
// Get the parameter types: 
for (int i=@; i<methArr.length; i++) 
{ 
if(! "sample" .equals(methArr[i].getName())) 
continue; 
System.out.println(methArr[i]); 
System.out.println("The parameter types are:"); 
// Declare the array of parameter types: 
Class[] paramTyArr = methArr[i].getParameterTypes() ; 
for (int j=0; j<paramTyArr.length; j++) 
System.out.printin(" " + j +". " +paramTyArr[j]); 
} 
} 


// Declare the "sample" method - just for testing: 
public void sample 
(byte b, short s, int i, float f, double d, String str, byte[] ba) 


{ } 
} 
f* 
Output: 


public void MyClass.sample(byte, short, int, float, double, java.lang.String, byte[ ]) 
The parameter types are: 
@ byte 
short 
int 
float 
double 
class java.lang.String 
class [B*/ 


Nu BWNP 


See Also 

Reference 

Method Class 

Concepts 

Method Members 
java.lang.reflect Package 


Visual J# Reference 


Method.getReturnType Method 


Returns the return type for a Method object. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Class getReturnType(); 


Return Value 
The return type for the Method object. 
Example 


The following example returns the return types for the method "test" declared in the same class. 


// meth-getretTy1.jsl 
// Method.getReturnType example 


import java.lang.reflect.*; 


public class MyClass 
{ 


public static void main(String[] args) 


{ 


// Declare and initialize a Class object: 
Class mc = MyClass.class; 


// Declare the an array of methods: 
Method[] methArr = mc.getMethods(); 


// Display return types for the methods: 
System.out.println("The return type(s):"); 
for (int i=0; i<methArr.length; i++) 


if(!"test".equals(methArr[i].getName())) 
continue; 
System.out.println(methArr[i].getReturnType()); 


} 


// Declare a test method - just for testing: 
public void test(byte b, short s, int i, float f, double d) { } 


} 


/* 

Output: 

The return type(s): 
void 


*/ 


See Also 

Reference 

Method Class 

Concepts 

Method Members 
java.lang.reflect Package 
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Method.invoke Method 


Invokes the current Method object on the specified object with the specified parameters. 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object invoke( 

java.lang.Object obj, 

java.lang.Object[] args) throws java.lang.IllegalAccessException, java.lang.IllegalArgu 
mentException, java.lang.reflect.InvocationTargetException; 


Parameters 


obj 
The object from which the method is invoked. 
args 
The arguments used to invoke the method. 
Return Value 
The object that represents the result of invoking the method. 
Example 


// meth-invo1.jsl 
// Method.invoke example 


import java.lang.reflect.*; 
public class MyClass 


public static void main(String[] args) 
throws java.lang.IllegalAccessException, 
java. lang.IllegalArgumentException, 
java. lang.reflect.InvocationTargetException, 
java. lang .NoSuchMethodException 


// Declare and initialize a Class object: 
Class mc = MyClass.class; 


// Declare a method object: 

/* Using getMethod will return a method object for an accessibl 
public method. Note that the second param to getMethod() is the 
set of non-null Class objects, one for each param on the 
method. Also note that the specified parameter types must 
exactly match. */ 


Method meth = mc.getMethod("test", new Class[] {int.class}); 


// Invoke the method "test": 

/* Note that the second parameter to invoke() is the set of 
arguments to be passed as params to the method that is invoked. 
If the parameter is a primitive type, the corresponding value 
in the argument array must be the appropriate wrapper object. */ 


Integer i = new Integer("50"); 
System.out.println(meth.invoke(mc, new Object[] {i})); 


i 


// Declare "test" method - just for testing: 
public static int test(int i) 


{ 


return 5*i; 


} 


/* 
Output: 
250 

*/ 





See Also 

Reference 

Method Class 

Concepts 

Method Members 
java.lang.reflect Package 
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Method.toString Method 


Returns the string representation of a Method object. 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toString(); 


Return Value 


The string representation of the Method object. 


Example 


// meth-ToString.jsl 
// Method.ToString example 


import java.lang.reflect.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Declare a Class object: 
Class mc = MyClass.class; 
// Declare the an array of methods: 
Method[] methArr = mc.getMethods(); 
// Display the method "test": 
System.out.println("The methods of MyClass are:"); 
for (int i=0; i<methArr.length; i++) 
if("test".equals(methArr[i].getName())) 
System.out.println(methArr[i].ToString()) ; 
} 
} 
// Declare a test method - just for testing: 
public static void test(int x, String s) { } 
} 
/* 
Output: 


The methods of MyClass are: 
public static void MyClass.test(int, java.lang.String) 


xf 


See Also 


Reference 
Method Class 


Concepts 


Method Members 
java.lang.reflect Package 
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Modifier Class 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public class java.lang.reflect.Modifier 
extends java.lang.Object 





Inheritance Hierarchy 
java.lang.Object 
java.lang.reflect.Modifier 


See Also 

Concepts 

Modifier Members 
java.lang.reflect Package 


Visual J# Reference 


Modifier Members 


The following tables list the members exposed by the Modifier type. 


Public Constructors 
Name 


Modifier 





Public Fields 





Name Description 





ABSTRACT 





FINAL 


INTERFACE 


NATIVE 


PRIVATE 


PROTECTED 


PUBLIC 


STATIC 


SYNCHRONIZED 


TRANSIENT 


VOLATILE 





Public Methods 





Name Description 





equals (inherited from Object ) 





hashCode (inherited from Object ) 





getClass (inherited from Object ) 





isAbstract 





isFinal 


isInterface 


isNative 


isPrivate 














isProtected 





isPublic 


isStatic 


isSynchronized 


isTransient 


isVolatile 


toString 


Protected Methods 
Name 


finalize 


MemberwiseClone 





See Also 

Reference 

Modifier Class 

Concepts 
java.lang.reflect Package 


Overridden. 





Description 


(inherited from Object ) 


Performs a shallow copy of the object. 





Visual J# Reference 


Modifier Fields 


Public Fields 





Name 


Description 





ABSTRACT 





FINAL 





INTERFACE 





NATIVE 





PRIVATE 


PROTECTED 


PUBLIC 


STATIC 


SYNCHRONIZED 


TRANSIENT 


VOLATILE 





See Also 

Reference 

Modifier Class 

Concepts 
java.lang.reflect Package 
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Modifier.ABSTRACT Field 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static final int ABSTRACT; 


See Also 

Reference 

Modifier Class 

Concepts 

Modifier Members 
java.lang.reflect Package 


Visual J# Reference 


Modifier.FINAL Field 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 





public static final int FINAL; 





See Also 

Reference 

Modifier Class 

Concepts 

Modifier Members 
java.lang.reflect Package 


Visual J# Reference 


Modifier.INTERFACE Field 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static final int INTERFACE; 


See Also 

Reference 

Modifier Class 

Concepts 

Modifier Members 
java.lang.reflect Package 


Visual J# Reference 


Modifier.NATIVE Field 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 





public static final int NATIVE; 





See Also 

Reference 

Modifier Class 

Concepts 

Modifier Members 
java.lang.reflect Package 
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Modifier.PRIVATE Field 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 





public static final int PRIVATE; 





See Also 

Reference 

Modifier Class 

Concepts 

Modifier Members 
java.lang.reflect Package 
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Modifier.PROTECTED Field 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static final int PROTECTED; 


See Also 

Reference 

Modifier Class 

Concepts 

Modifier Members 
java.lang.reflect Package 


Visual J# Reference 


Modifier.PUBLIC Field 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 





public static final int PUBLIC; 





See Also 

Reference 

Modifier Class 

Concepts 

Modifier Members 
java.lang.reflect Package 


Visual J# Reference 


Modifier.STATIC Field 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 





public static final int STATIC; 





See Also 

Reference 

Modifier Class 

Concepts 

Modifier Members 
java.lang.reflect Package 


Visual J# Reference 


Modifier.SYNCHRONIZED Field 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static final int SYNCHRONIZED; 


See Also 

Reference 

Modifier Class 

Concepts 

Modifier Members 
java.lang.reflect Package 


Visual J# Reference 


Modifier. TRANSIENT Field 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static final int TRANSIENT; 


See Also 

Reference 

Modifier Class 

Concepts 

Modifier Members 
java.lang.reflect Package 


Visual J# Reference 


Modifier. VOLATILE Field 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 





public static final int VOLATILE; 





See Also 

Reference 

Modifier Class 

Concepts 

Modifier Members 
java.lang.reflect Package 
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Modifier Constructor 


Initializes a new instance of the Modifier Class . 
Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 





public java.lang.reflect.Modifier(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 

Modifier Class 

Concepts 

Modifier Members 
java.lang.reflect Package 
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Modifier Methods 


Public Methods 





Name Description 





equals (inherited from Object ) 





hashCode (inherited from Object ) 





getClass (inherited from Object ) 





isAbstract 





isFinal 
isInterface 
isNative 
isPrivate 
isProtected 
isPublic 
isStatic 
isSynchronized 
isTransient 
isVolatile 


toString Overridden. 








Protected Methods 








Name Description 





finalize (inherited from Object ) 





MemberwiseClone Performs a shallow copy of the object. 











See Also 

Reference 

Modifier Class 

Concepts 
java.lang.reflect Package 
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Modifier.isAbstract Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static boolean isAbstract( 
int mod); 





Parameters 
mod 


See Also 

Reference 

Modifier Class 

Concepts 

Modifier Members 
java.lang.reflect Package 


Visual J# Reference 


Modifier.isFinal Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static boolean isFinal( 
int mod); 





Parameters 
mod 


See Also 

Reference 

Modifier Class 

Concepts 

Modifier Members 
java.lang.reflect Package 
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Modifier.isInterface Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static boolean isInterface( 
int mod); 


Parameters 
mod 


See Also 

Reference 

Modifier Class 

Concepts 

Modifier Members 
java.lang.reflect Package 


Visual J# Reference 


Modifier.isNative Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static boolean isNative( 
int mod); 





Parameters 
mod 


See Also 

Reference 

Modifier Class 

Concepts 

Modifier Members 
java.lang.reflect Package 


Visual J# Reference 


Modifier.isPrivate Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static boolean isPrivate( 
int mod); 





Parameters 
mod 


See Also 

Reference 

Modifier Class 

Concepts 

Modifier Members 
java.lang.reflect Package 
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Modifier.isProtected Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static boolean isProtected( 
int mod); 


Parameters 
mod 


See Also 

Reference 

Modifier Class 

Concepts 

Modifier Members 
java.lang.reflect Package 


Visual J# Reference 


Modifier.isPublic Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static boolean isPublic( 
int mod); 





Parameters 
mod 


See Also 

Reference 

Modifier Class 

Concepts 

Modifier Members 
java.lang.reflect Package 
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Modifier.isStatic Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static boolean isStatic( 
int mod); 





Parameters 
mod 


See Also 

Reference 

Modifier Class 

Concepts 

Modifier Members 
java.lang.reflect Package 
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Modifier.isSynchronized Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static boolean isSynchronized( 
int mod); 


Parameters 
mod 


See Also 

Reference 

Modifier Class 

Concepts 

Modifier Members 
java.lang.reflect Package 
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Modifier.isTransient Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static boolean isTransient( 
int mod); 


Parameters 
mod 


See Also 

Reference 

Modifier Class 

Concepts 

Modifier Members 
java.lang.reflect Package 


Visual J# Reference 


Modifier.isVolatile Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 


public static boolean isVolatile( 
int mod); 





Parameters 
mod 


See Also 

Reference 

Modifier Class 

Concepts 

Modifier Members 
java.lang.reflect Package 


Visual J# Reference 


Modifier.toString Method 


Package: java.lang.reflect 


Assembly: vjslib (in vjslib.dll) 





See Also 

Reference 

Modifier Class 

Concepts 

Modifier Members 
java.lang.reflect Package 
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java.lang.String 


Represents an immutable sequence of Unicode characters. 


J# 
public final class String implements Serializable 


Example 


// string _overview.jsl 
import java.util.Locale; 


public class Program 


{ 
public static void main(String[] args) 
{ 
// charAt 
// SSS 5222525552525 2525255552522 2525555525255 5552525255555 5252555555555 5SES>=> 


String stri = "Hello, World!"; 


// Get the character at positions @ and 12. 
int index1 = stri.charAt(@); 
int index2 = stri.charAt(12); 


// Print out the results. 

System.out.println("charAt") ; 

System.out.printin("The character at position @ is " + 
(char) index1) ; 

System.out.println("The character at position 12 is " + 
(char) index2) ; 


// concat 

// sessessssssssssssssssssssssssssssssssssssssssssssssssssss= 
String str2 = "This is the beginning "; 
String str3 = "of the new String."; 


// Concatenate the two strings together. 
String str4 = str2.concat(str3); 


// Display the new String. 
System.out.println("\nconcat") ; 
System.out.println("The concatenated string: " + str4); 


// copyValueOf 


// Populate a character array with data. 
char[] arr1 = new char[] { 
Pr ee ee? i 
}3 
// Create a String containig the contents of arr 


// starting at index 1 for length 2. 
String str5 = String.copyValueOf(arr1, 1, 2); 


// Display the results of the new String. 
System.out.println("\ncopyValueOFf") ; 


System.out.println("The new String contains \"" + str5 + 
baad " )3 
// endsWith 
// SSS 2525255252522 2555525252525 2555255252555 5525252555525 2525255555255 5S2ES>=> 
String str6 = "My name is Fred"; 


String str7 = "My name is Xiao Mei"; 


// The String to check the above two Strings to see 
// if they end with this value (ei). 


String endStr = "ei"; 


// Do either of the first two Strings end with endStr? 
boolean ends1 = str6.endswWith(endStr) ; 
boolean ends2 = str7.endswWith(endStr) ; 


// Display the results of the endsWith calls. 

System.out.println("\nendswWith") ; 

System.out.printin("\"" + str6 + "\" ends with " + 
"\"" +4 endStr + "\"P " + ends1); 

System.out.printin("\"" + str7 + "\" ends with " + 
"\"" +4 endStr + "\"P " + ends2); 


// regionMatches 

// sessessesssssssssssssssssssssssssssssssssssssssssssssssss= 
String str8 = "Missouri Florida Colorado Washington"; 

String str9 "Washington Colorado Florida Missouri"; 


// Determine whether characters @ through 7 in str8 
// match characters 28 through 35 in str9. 
boolean match1 = str8.regionMatches(@, str9, 28, 8); 


// Determine whether characters 9 through 15 in str8 
// match characters 9 through 15 in str9. 
boolean match2 = str8.regionMatches(9, str9, 9, 8); 


// Display the results of the regionMatches method calls. 
System.out.println("\nregionMatches") ; 
System.out.printin("str8[@ - 7] == str9[28 - 35]? " + match1); 
System.out.printin("str8[9 - 15] == str9[9 - 15]? " + match2); 


// replace 
// SSS 5222525255525 2525255552525 2525255525252 2525555252525 2555255252555 5525252555 2S>> 
String stri@ = "The quick brown fox jumps over the lazy dog."; 


// Replace all the ‘'d' characters with '1l' characters. 
String stri1 = stri1@.replace('d', ‘1'); 


// Display the strings for comparison. 
System.out.printin("\nreplace") ; 

System.out.println("old = " + str10); 
System.out.println("new = " + str11); 


// substring 
// sessessessssssssssssssssssssssssssssssssssssssssssssssssss 


String stri2 = "Navy blue is my favorite color."; 


// Get a substring of the above string starting from 
// index 5. 
String stri3 = stri2.substring(5); 


// Display the two strings for comparison. 
System.out.printin("\nsubstring") ; 
System.out.println("old = " + str12); 
System.out.println("new = " + str13); 


// toLowerCase 
// SSS 2525225252555 2525252555525 2525252555522 2525555252555 552525225555 E5555 55S ES>=> 
String stri4 = "ThIs Is HaRd To ReAd."; 


// Convert the above string to all lowercase. 
String lowerStr = str14.toLowerCase(); 


// Display the two strings for comparison. 
System.out.println("\ntoLowerCase") ; 


System.out.println("old = " + str14); 
System.out.println("lowercase = " + lowerStr); 


// toUpperCase 
// SSS 2522225255255 2525255552522 2525555525255 5552252555525 2522555552525 55> 
String stri5 = "ThIs Is HaRd To ReAd."; 


// Convert the above string to all uppercase 
// using the default system Locale. 

Locale loc = Locale.getDefault(); 

String upperStr = stri15.toUpperCase(loc); 


// Display the two strings for comparison. 
System.out.println("\ntoUpperCase") ; 
System.out.println("old = " + str15); 
System.out.println("uppercase = " + upperStr); 


// ValueOf 


String hundredStr = String.valueOf(10@) ; 
String minStr = String.valueOf(Integer.MIN_VALUE) ; 


// Display the string representations of the above 
// int values. 

System.out.printlin("\nvalueOf") ; 
System.out.println(hundredStr) ; 
System.out.println(minStr) ; 


} 


/* 

Output: 

charAt 

The character at position @ is H 
The character at position 12 is ! 


concat 
The concatenated string: This is the beginning of the new String. 


copyValueOf 
The new String contains "23" 


endswWith 
"My name is Fred" ends with "ei"? false 
"My name is Xiao Mei" ends with "ei"? true 


regionMatches 
str8[@ - 7] == str9[28 - 35]? true 
str8[9 - 15] == str9[9 - 15]? false 


replace 
old = The quick brown fox jumps over the lazy dog. 
new = The quick brown fox jumps over the lazy log. 


substring 
old = Navy blue is my favorite color. 
new = blue is my favorite color. 


toLowerCase 
old = ThIs Is HaRd To ReAd. 
lowercase = this is hard to read. 


toUpperCase 
old = ThIs Is HaRd To ReAd. 
uppercase = THIS IS HARD TO READ. 


valueOf 
100 


- 2147483648 
*/ 


See Also 
Concepts 
Visual J# Class Library 
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java.lang.String.String() 


Initializes a new instance of a String object. 


J# 





public String() 





See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.String(String src) 


Initializes a new instance of a String object with the contents of an existing String object. 


J# 


public String(String src) 











Parameters 

Parameter Description 

src An existing String whose contents will be used to populate the String. 
See Also 

Reference 


java.lang.String 





Visual J# Reference 


java.lang.String.String (StringBuffer buffer) 


Initializes a new instance of a String object with the contents of a StringBuffer object. 


J# 


public String(StringBuffer buffer) 











Parameters 

Parameter Description 

buffer A StringBuffer object whose contents will be used to populate the String. 
See Also 

Reference 


java.lang.String 
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java.lang.String.String(char[] charArray) 


Initializes a new instance of a String object with the contents of a character array. 


J# 


public String(char[] charArray) 











Parameters 

Parameter Description 

charArray A character array whose contents will be used to populate the String. 
See Also 

Reference 


java.lang.String 
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java.lang.String.String(char[] charArray, int offset, int count) 


Initializes a new instance of a String object with the contents of a character array. 


J# 


public String(char[] charArray, int offset, int count) 





Parameters 
Para |Description 
met 


char jA character array whose contents will be used to populate the String. 





offse The first character in the character array to be written to the String. This value must be greater than zero and less than th 
t e length of the character array. 


coun |The number of characters within the character array, after the offset, to be written to the String. If this value is greater tha 
t n the number of characters in the character array after the offset, then only the remaining characters are copied into the 
String. 








See Also 
Reference 
java.lang.String 
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java.lang.String.String(byte[] byteArray) 


Initializes a new instance of a java.lang.String object with the contents of a byte array. 


J# 


public String(byte[] byteArray) 











Parameters 

Parameter Description 

byteArray A byte array whose contents will be used to populate the String. 
See Also 

Reference 


java.lang.String 
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java.lang.String.String(byte[] byteArray, int offset, int count) 


Initializes a new instance of a String object with the contents of a byte array. 


J# 


public String(byte[] byteArray, int offset, int count) 





Parameters 

Para |Description 
mete 
r 


byteA|A byte array whose contents will be used to populate the String. 
rray 


offset|The first byte in the byte array to be written to the String. This value must be greater than zero and less than the length 
of the byte array. 





count|The number of bytes within the byte array, after the offset, to be written to the String. If this value is greater than the nu 
mber of bytes in the byte array after the offset, then only the remaining bytes are copied into the String. 








See Also 
Reference 
java.lang.String 
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java.lang.String.String(byte[] byteArray, String enc) 


Initializes a new instance of a String object with the contents of a byte array using the given encoding. 














J# 
public String(byte[] byteArray, String enc) throws UnsupportedEncodingException 
Parameters 
Parameter Description 
byteArray A byte array whose contents will be used to populate the String. 
enc The encoding for the newly created String object. 
See Also 
Reference 


java.lang.String 
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java.lang.String.String(byte[] byteArray, int offset, int count, 
String enc) 


Initializes a new instance of a String object with the contents of a byte array using the given encoding. 


J# 





public String(byte[] byteArray, int offset, int count, String enc) throws UnsupportedEncodi 
ngException 





Para 


r 


mete 


Parameters 


Description 





rray 


byteA|A byte array whose contents will be used to populate the String. 


offset|The first byte in the byte array to be written to the String. This value must be greater than zero and less than the length 


of the byte array. 





enc 





count|The number of bytes within the byte array, after the offset, to be written to the String. If this value is greater than the nu 


mber of bytes in the byte array after the offset, then only the remaining bytes are copied into the String. 


The encoding for the newly created String object. 





See Also 
Reference 
java.lang.String 
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java.lang.String.String(byte[] asciiArray, int hibyte) 


Initializes a new instance of a String object with the contents of an ASCII array. 

















J# 
public String(byte[] asciiArray, int hibyte) 
Parameters 
Parameter Description 
asciiArray An ASCII array whose contents will be used to populate the String. 
hibyte Set to 0 if asciiArray contains ASCII characters. 
See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.String(byte[] asciiArray, int hibyte, int offset, 
int count) 


Initializes a new instance of a String object with the contents of an ASCII array. 


J# 





public String(byte[] asciiArray, int hibyte, int offset, int count) 


Parameters 





Para |Description 





ascil |An ASCII array whose contents will be used to populate the String. 


hibyt/Set to 0 if asciiArray contains ASCII characters. 
e 





offse|The first ASCII character in the ASCII array to be written to the String. This value must be greater than zero and less than t 
t he length of the ASCII array. 


coun|The number of ASCII characters within the ASCII array, after the offset, to be written to the String. If this value is greater t 
t han the number of ASCII characters in the ASCII array after the offset, then only the remaining ASCII characters are copie 
d into the String. 








See Also 
Reference 
java.lang.String 





Visual J# Reference 


java.lang.String.charAt(int index) 


Gets the character at the given index within the String. 


J# 


public char charAt(int index) 





Parameters 
Paramet |Description 
er 





index The position within the String whose character is to be retrieved. A StringlndexOutofBoundsException will be throw 


n if the index is invalid. 











Property Value/Return Value 


The char at the given index within the String. 


Example EEO _ 








// string _charat.jsl 
public class Program 
public static void main(String[] args) 
{ 
String str = "Hello, World!"; 
// Get the character at positions @ and 12. 
int index1 = str.charAt(@); 
int index2 = str.charAt(12); 
// Print out the results. 
System.out.println("The character at position @ is " + 
(char) index1) ; 
System.out.println("The character at position 12 is " + 
(char) index2) ; 
} 
i 
/* 
Output: 
The character at position @ is H 
The character at position 12 is ! 
*/ 
See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.compareTo(String str) 


Compares two java.lang.String objects for equality. 


J# 


public int compareTo(String str) 





Parameters 
Parameter Description 
str A String object to compare with the current String object for equality. 








Property Value/Return Value 


Less than zero if the current String object is less than str, zero if the two String objects are equal, or greater than zero if str is 
greater than the current String object. 

















Example 
// string _compareto.jsl 
public class Program 
{ 
public static void main(String[] args) 
{ 
String stri = "This is string 1"; 
String str2 = "This is string 2"; 
// Compare the two strings. 
int result = str1.compareTo(str2); 
// Display the results of the comparison. 
if (result < @) 
{ 
System.out.printin("\"" + str2 + "\"" + 
"is less than " + 
i aa # str2 + ON 
else if (result == @) 
{ 
System.out.printin("\"" + strd + "\"" + 
"is equal to " + 
we " + str2 + my 3 
} 
else // if (result > @) 
System.out.printlin("\"" + str2 + "\"" + 
"is greater than " + 
we W es str2 + eS 
} 
} 
} 
/* 
Output: 
"This is string 1" is less than "This is string 2" 
* f 
See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.concat(String str) 


Concatenates two String objects. 


J# 


public String concat(String str) 





Parameters 
Parameter Description 
str A String to append to the end of the current java.lang.String object. 











Property Value/Return Value 
A new String that is a concatenation of the current String and str. 


Example _ 








// string _concat.jsl 
public class Program 
{ 
public static void main(String[] args) 
{ 
String stri = "This is the beginning "; 
String str2 = "of the new String."; 
// Concatenate the two strings together. 
String str3 = stri.concat(str2) ; 
// Display the new String. 
System.out.println("The concatenated string: " + str3); 
} 
} 
/* 
Output: 
The concatenated string: This is the beginning of the new String. 
*/ 
See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.copyValueOf(char[] data, int offset, int count) 


Creates a new String object with the contents of a character array. 


J# 


public static String copyValueOf(char[] data, int offset, int count) 





Parameters 

Para |Description 
met 
er 


data /A character array whose contents will be used to populate the String. 


offse The first character in the character array to be written to the String. This value must be greater than zero and less than th 
t e length of the character array. 


coun |The number of characters within the character array, after the offset, to be written to the String. If this value is greater tha 
t n the number of characters in the character array after the offset, then only the remaining characters are copied into the 
String. 








Property Value/Return Value 


A java.lang.String object with the contents of the character array. 














Example 
// string _copyvalueofi1.jsl 
public class Program 
{ 
public static void main(String[] args) 
{ 
// Populate a character array with data. 
char[] arr = new char[] { '1', '2', '3', '4' }; 
// Create a String containig the contents of arr 
// starting at index 1 for length 2. 
String str = String.copyValueOf(arr, 1, 2); 
// Display the results of the new String. 
System.out.println("The new String contains \"" + str + 
my ys 
} 
} 
/* 
Output: 
The new String contains "23" 
*/ 
See Also 
Reference 


java.lang.String 





Visual J# Reference 


java.lang.String.copyValueOf(char[] data) 


Creates a new String object with the contents of a character array. 


J# 


public static String copyValueOf(char[] data) 





Parameters 
Parameter Description 
data A character array whose contents will be used to populate the String. 











Property Value/Return Value 


A java.lang.String object with the contents of the character array. 


Example _ 











// string _copyvalueof2.jsl 
public class Program 
{ 
public static void main(String[] args) 
{ 
// Populate a character array with data. 
char[] arr = new char[] { '1', '2', '3', '4' }; 
// Create a String containig the contents of arr. 
String str = String.copyValueOf(arr) ; 
// Display the results of the new String. 
System.out.println("The new String contains \"" + str + 
nn iy 
} 
} 
/* 
Output: 
The new String contains "1234" 
*/ 
See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.endsWith(String str) 


Determines whether the current String ends with the contents of another String. 


C# 


public boolean endsWith(String str) 





Parameters 
Parameter Description 
str The String whose contents will be compared against the end of the current String. 











Property Value/Return Value 


true if the current String ends with the contents of str; false otherwise. 


Example _ 











// string _endswith.jsl 
public class Program 
{ 
public static void main(String[] args) 
{ 
String stri = "My name is Fred"; 
String str2 = "My name is Xiao Mei"; 
// The String to check the above two Strings to see 
// if they end with this value (ei). 
String endStr = "ei"; 
// Do either of the first two Strings end with endStr? 
boolean endsi1 = stri.endswWith(endStr) ; 
boolean ends2 = str2.endswWith(endStr) ; 
// Display the results of the endsWith calls. 
System.out.printin("\"" + str1 + "\" ends with " + 
"\"" +4 endStr + "\"P " + ends1); 
System.out.printin("\"" + str2 + "\" ends with " + 
"\"" +4 endStr + "\"P " + ends2); 
} 
} 
/* 
Output: 
"My name is Fred" ends with "ei"? false 
"My name is Xiao Mei" ends with "ei"? true 
e/ 
See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.equals(Object obj) 


Determines whether two String objects contain the same data. 


J# 


public boolean equals(Object obj) 





Parameters 
Parameter Description 
obj A java.lang.String object to compare against the current String for equality. 











Property Value/Return Value 


true if the two String objects contain the same data; false otherwise. 


Example _ 








// string equals.jsl 
public class Program 
{ 
public static void main(String[] args) 
{ 
String physicist1 = "Albert Einstein"; 
String physicist2 = "Max Planck"; 
String physicist3 = "Albert Einstein"; 
// Are any of the above Strings equal to one another? 
boolean equals1 = physicist1.equals(physicist2); 
boolean equals2 = physicist1.equals(physicist3); 
// Display the results of the equality checks. 
System.out.printin("\"" + physicist1 + "\" equals \"" + 
physicist2 + "\"? " + equals1); 
System.out.printin("\"" + physicist1 + "\" equals \"" + 
physicist3 + "\"? " + equals2); 
} 
} 
/* 
Output: 
"Albert Einstein" equals "Max Planck"? false 
"Albert Einstein" equals "Albert Einstein"? true 
+f 
See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.equalslgnoreCase(String str) 


Determines whether two String objects contain the same data, ignoring the case of the letters in the String. 


J# 


public boolean equalsIgnoreCase(String str) 





Parameters 
Parameter Description 
str A java.lang.String object to compare against the current String for equality. 











Property Value/Return Value 


true if the two String objects contain either exactly the same data or if they differ only in case; false otherwise. 


Example _ 








// string equalsignorecase.jsl 
public class Program 
{ 
public static void main(String[] args) 
{ 
String physicist1 = "Albert Einstein"; 
String physicist2 = "Max Planck"; 
String physicist3 = "albert einstein"; 
// Are any of the above Strings equal to one another? 
boolean equals1 = physicist1.equalsIgnoreCase(physicist2); 
boolean equals2 = physicist1.equalsIgnoreCase(physicist3); 
// Display the results of the equality checks. 
System.out.printin("\"" + physicist1 + "\" equals \"" + 
physicist2 + "\"? " + equals1); 
System.out.printin("\"" + physicist1 + "\" equals \"" + 
physicist3 + "\"? " + equals2); 
} 
} 
/* 
Output: 
"Albert Einstein" equals "Max Planck"? false 
"Albert Einstein" equals "albert einstein"? true 
+f 
See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.getBytes() 


Gets the contents of the String as a byte array. 


J# 
public byte[] getBytes() 


Property Value/Return Value 
The contents of the String as a byte array. 
Example 


// string getbytes1.jsl 


public class Program 


{ 
public static void main(String[] args) 
if 
String str = "This is a String."; 
// Copy the contents of the String to a byte array. 
byte[] arr = str.getBytes(); 
// Create a new String using the contents of the byte array. 
String newStr = new String(arr); 
// Display the contents of the byte array. 
System.out.println("The new String equals \"" + 
newStr + "\""); 
} 
} 
/ * 
Output: 
The new String equals "This is a String." 
ur 
See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.getBytes(String enc) 


Gets the contents of the String as a byte array using the given encoding. 


J# 


public byte[] getBytes(String enc) throws UnsupportedEncodingException 





Parameters 
Parameter Description 
enc The encoding for the contents of the newly created byte array. 











Property Value/Return Value 


A byte array containing the contents of the current String. 


Example _ 








// string getbytes2.jsl 
import java.io.UnsupportedEncodingException; 
public class Program 
{ 
public static void main(String[] args) 
1 
String str = "This is a String."; 
try 
{ 
// Copy the contents of the String to a byte array 
// using the ASCII encoding. 
byte[] arr = str.getBytes("ASCII"); 
// Create a new String using the contents of the byte array. 
String newStr = new String(arr); 
// Display the contents of the byte array. 
System.out.println("The new String equals \"" + 
newStr + "\""); 
catch (UnsupportedEncodingException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 
/* 
Output: 
The new String equals "This is a String." 
*/ 
See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.getBytes(int srcOffset, int srcEnd, byte[] dst, 
int dstOffset) 


Gets the contents of the java.lang.String as a byte array. 




































J# 
public void getBytes(int srcOffset, int srcEnd, byte[] dst, int dstOffset) 
Parameters 
Parame|Description 
ter 
srcOffse|The index of the first character in the String to copy into the byte array. An IndexOutOfBoundsException is thrown if t 
t his index is invalid. 
srcEnd |The index one greater than the last character in the String to copy into the byte array. An IndexOutOfBoundsExcepton 
is thrown if this index is invalid. 
dst A byte array that will contain the contents of the current String. 
dstOffse|The index within the byte array that will hold the first character copied from the String. An 
t ArraylndexOutOfBoundsException is thrown if this index is invalid. 
Example 
// string getbytes3.jsl 
import java.io.UnsupportedEncodingException; 
public class Program 
{ 
public static void main(String[] args) 
if 
String str = "This is a String."; 
// Copy the contents of the String to a byte array. 
// Only copy characters 5 through 10 from str. 
// Fill the source array starting at position 3. 
byte[] arr = new byte[] {''‘, '', '', ' ', 
' "y ' "5 1 "y ' ' } 
str.getBytes(5, 10, arr, 3); 
// Create a new String using the contents of the byte array. 
String newStr = new String(arr); 
// Display the contents of the byte array. 
System.out.println("The new String equals \"" + 
newStr + "\""); 
} 
} 
/* 
Output: 
The new String equals " isa" 
*/ 
See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.getChars(int srcOffset, int srcEnd, char[] dst, 
int dstOffset) 


Gets the contents of the String as a character array. 

























J# 
public void getChars(int srcOffset, int srcEnd, char[] dst, int dstOffset) 
Parameters 
Param |Description 
eter 
srcOffs |The index of the first character in the String to copy into the character array. An IndexOutOfBoundsException is throw 
et n if this index is invalid. 
srcEnd |The index of the last character in the String to copy into the character array. An IndexOutOfBoundsException is thrown 
if this index is invalid. 
dst A character array that will contain the contents of the current String. 
dstOffs |The index within the character array that will hold the first character copied from the String. An 
et ArraylndexOutOfBoundsException is thrown if this index is invalid. 
Example 
// string getchars.jsl 
import java.io.UnsupportedEncodingException; 
public class Program 
{ 
public static void main(String[] args) 
if 
String str = "This is a String."; 
// Copy the contents of the String to a byte array. 
// Only copy characters 5 through 10 from str. 
// Fill the source array starting at position 3. 
char[] arr = new char[] { '', '', '', ' ', 
' "y ' "5 1 "y ' ' } 
str.getChars(5, 10, arr, 3); 
// Display the contents of the byte array. 
System.out.println("The char array equals \"" + 
arr + sae ae) 
} 
} 
pt 
Output: 
The char array equals " isa" 
of 
See Also 
Reference 


java.lang.String 





Visual J# Reference 


java.lang.String.hashCode() 


Generates a hash value that can be used to uniquely identify a particular String. 


J# 


public int hashCode() 


Property Value/Return Value 
A hash value that uniquely identifies a String. 
Example 


// string _hashcode.jsl 


public class Program 


{ 
public static void main(String[] args) 
if 
String str = "Hello, World!"; 
// Get the hash code for the above string. 
int hash = str.hashCode(); 
// Display the hash code. 
System.out.printin("The hash for \"" + str + 
"\" is " + hash); 
} 
} 
/ * 
Output: 
The hash for "Hello, World!" is 4052569 
of 
See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.indexOf(int ch, int offset) 


Gets the first index of a character within a String after an offset. 


Ji 


public int indexOf(int ch, int offset) 


Parameters 
Paramete|Description 
r 








ch The character to search the String for. 
offset The position within the String to begin searching for the character. This value cannot be greater than the length of t 
he String. 














Property Value/Return Value 


The index of the first occurrence of ch in the String after the offset, or -1 if the character does not exist within the String or if an 
invalid offset was provided. 


Example 


// string indexof1.jsl 


public class Program 


{ 


public static void main(String[] args) 


{ 


String str = "The quick brown fox jumps over the lazy dog."; 


// Get the index of all the characters of the alphabet 
// starting from the beginning of the String. 


int 
int 


= str.indexOf('y', @); 
= str.indexOf('z', @); 


int a = str.indexOf('a', @); 
int b = str.indexOf('b', @); 
int c = str.indexOf('c', @); 
int d = str.indexOf('d', @); 
int e = str.indexOf('e', @); 
int f = str.indexOf('f', @); 
int g = str.indexOf('g', @); 
int h = str.indexOf('h', @); 
int i = str.indexOf('i', 9); 
int j = str.indexOf('j', 9); 
int k = str.indexOf('k', @); 
int 1 = str.indexOf('l', 9); 
int m = str.indexOf('m', @); 
int n = str.indexOf('n', @); 
int o = str.indexOf('o', @); 
int p = str.indexOf('p', 9); 
int q = str.indexOf('q', @); 
int r = str.indexOf('r', @); 
int s = str.indexOf('s', @); 
int t = str.indexOf('t', @); 
int u = str.indexOf('u', @); 
int v = str.indexOf('v', 9); 
int w = str.indexOf('w', @); 
int x = str.indexOf('x', @); 
y 
z 


// Display the results of all the indexOf method calls. 
System.out.printin(" a bc de f ghi j"); 
System.out.printin("============s===s========") ; 
System.out.println(a +" " 


System. 
System. 
System. 
System. 
System. 
System. 
} 

} 

/* 

Output 


out. 
out. 
out. 


out. 
out. 
out. 


5 27 13 18 38 37 


*/ 


See Also 
Reference 


java.lang.String 


ey™" far peg” @ 2h 
ie¢4quo i wr AS 

printin("k 1 nopqres t"); 

printlin("=====s==s==s=s=s=ss=s=s=s=s=========="); 

printin(k + non 1 + now +met now +n 
o+#7™" ie ae on eo 
s+" " t+ "\n"); 

printin("u v x y 2"); 

printin("================") ; 

println(u eu" ve" "4weu "4x 
y+ now z)3 

hi j 

1 6 20 

ros t 

11 24 31 


Visual J# Reference 


java.lang.String.indexOf(int ch) 


Gets the first index of a character within a String. 


J# 


public int indexOf(int ch) 





Parameters 
Parameter Description 
ch The character to search the String for. 











Property Value/Return Value 


The index of the first occurrence of ch in the String, or -1 if the character does not exist within the String. 


Example 
// string indexof2.jsl 


public class Program 


{ 


public static void main(String[] args) 


{ 


String str = "The quick brown fox jumps over the lazy dog."; 


// Get the index of all the characters of the alphabet 
// starting from the beginning of the String. 


int a = str.indexOf('a'); 
int b = str.indexOf('b'); 
int c = str.indexOf('c'); 
int d = str.indexOf('d'); 
int e = str.indexOf(‘'e'); 
int f = str.indexOf('f'); 
int g = str.indexOf('g'); 
int h = str.indexOf('h'); 
int i = str.indexOf('i'); 
int j = str.indexOf('j'); 
int k = str.indexOf('k'); 
int 1 = str.indexof('1'); 
int m = str.indexOf('m'); 
int n = str.indexOf('n'); 
int o = str.indexOf('0'); 
int p = str.indexOf('p'); 
int q = str.indexOf('q'); 
int r = str.indexOf('r'); 
int s = str.indexOf('s'); 
int t = str.indexOf('t'); 
int u = str.indexOf('u'); 
int v = str.indexOf('v'); 
int w = str.indexOf('w'); 
int x = str.indexOf('x'); 
int y = str.indexOf('y'); 
int z = str.indexOf('z'); 


// Display the results of all the indexOf method calls. 
System.out.printlIn(" a bc de f ghi j"); 
System.out.printin("============s=s=s=s======") 5 


I 
System.out.printlIn(a+""+b+" "+c4#""4d+" "+4 
et" "SF Fe" "Gee" "Ghae""G 
i+" "454 "\n"); 


System.out.printin("k 1 m n o pqres tt"); 
System.out.printin("============sss=sssss======") ; 








5 27 13 18 38 37 
*/ 





See Also 
Reference 
java.lang.String 


System.out. 
System.out. 
System.out. 
System.out. 
} 

} 

/* 

Output 


println( 


printin( 
println( 
println( 


11 24 31 


k + 
Oo + 
Ss + 


"Y 


ut 
y + 


1+ +m + 

p+" "+4+q+ 

t+ "\n"); 

X z")3 
")3 

vet" " +wt 

Z)3 





Visual J# Reference 


java.lang.String.indexOf (String str, int offset) 


Gets the first index of a String within a String after an offset. 


Ji 


public int indexOf(String str, int offset) 


Parameters 
Paramet |Description 





er 





str The String to search the current String for. 





offset The position within the current String to begin searching for the String. This value cannot be greater than the length 
of the String. 











Property Value/Return Value 


The index of the first occurrence of str in the current String after the offset, or -1 if str does not exist within the String or if an 
invalid offset was provided. 


Example 


// string _indexof3.jsl 


public class Program 


{ 


public static void main(String[] args) 


{ 


String str = "The quick brown fox jumps over the lazy dog."; 


// Get the index of all the characters of the alphabet 
// starting from the beginning of the String. 


int 
int 


= str.indexOf("y", @); 
= str.indexOf("z", @); 


int a = str.indexOf("a", @); 
int b = str.indexOf("b", @); 
int c = str.indexOf("c", @); 
int d = str.indexOf("d", 9); 
int e = str.indexOf("e", @); 
int f = str.indexOf("f", @); 
int g = str.indexOf("g", @); 
int h = str.indexOf("h", 9); 
int i = str.indexOf("i", @); 
int j = str.indexOf("j", 9); 
int k = str.indexOf("k", @); 
int 1 = str.indexOf("1", 9); 
int m = str.indexOf("m", @); 
int n = str.indexOf("n", @); 
int o = str.indexOf("o", @); 
int p = str.indexOf("p", 9); 
int q = str.indexOf("q", 9); 
int r = str.indexOf("r", @); 
int s = str.indexOf("s", @); 
int t = str.indexOf("t", @); 
int u = str.indexOf("u", @); 
int v = str.indexOf("v", @); 
int w = str.indexOf("w", @); 
int x = str.indexOf("x", @); 
y 
z 


// Display the results of all the indexOf method calls. 
System.out.printin(" a bc de f ghi j"); 
System.out.printin("============s===s========") ; 
System.out.println(a +" " 


System. 
System. 
System. 
System. 
System. 
System. 
} 

} 

/* 

Output 


out. 
out. 
out. 


out. 
out. 
out. 


5 27 13 18 38 37 


*/ 


See Also 
Reference 


java.lang.String 


ey™" far peg” @ 2h 
ie¢4quo i wr AS 

printin("k 1 nopqres t"); 

printlin("=====s==s==s=s=s=ss=s=s=s=s=========="); 

printin(k + non 1 + now +met now +n 
o+#7™" ie ae on eo 
s+" " t+ "\n"); 

printin("u v x y 2"); 

printin("================") ; 

println(u eu" ve" "4weu "4x 
y+ now z)3 

hi j 

1 6 20 

ros t 

11 24 31 


Visual J# Reference 


java.lang.String.indexOf(String str) 


Gets the first index of a String within a String. 
Jt 


public int indexOf(String str) 


Parameters 


str The String to search the current String for. 





Property Value/Return Value 
The index of the first occurrence of str in the current String, or -1 if str does not exist within the String. 


Example 
| 


// string indexof4.jsl 


public class Program 


{ 


public static void main(String[] args) 


{ 


String str = "The quick brown fox jumps over the lazy dog."; 


// Get the index of all the characters of the alphabet 
// starting from the beginning of the String. 


int a = str.indexOf("a"); 
int b = str.indexOf("b"); 
int c = str.indexOf("c"); 
int d = str.indexOf("d"); 
int e = str.indexOf("e"); 
int f = str.indexOf("f"); 
int g = str.indexOf("g"); 
int h = str.indexOf("h"); 
int i = str.indexOf("i"); 
int j = str.indexOf("j"); 
int k = str.indexOf("k"); 
int 1 = str.indexof("1"); 
int m = str.indexOf("m"); 
int n = str.indexOf("n"); 
int o = str.indexOf("o"); 
int p = str.indexOf("p"); 
int q = str.indexOf("q"); 
int r = str.indexOf("r"); 
int s = str.indexOf("s"); 
int t = str.indexOf("t"); 
int u = str.indexOf("u"); 
int v = str.indexOf("v"); 
int w = str.indexOf("w"); 
int x = str.indexOf("x"); 
int y = str.indexOf("y"); 
int z = str.indexOf("z"); 


// Display the results of all the indexOf method calls. 
System.out.printlIn(" a bc de f ghi j"); 
System.out.printin("============s=s=s=s======") 5 


I 
System.out.printlIn(a+""+b+" "+c4#""4d+" "+4 
et" "SF Fe" "Gee" "Ghae""G 
i+" "454 "\n"); 


System.out.printin("k 1 m n o pqres tt"); 
System.out.printin("============sss=sssss======") ; 


5 27 13 18 38 37 
*/ 





See Also 
Reference 
java.lang.String 


System.out. 
System.out. 
System.out. 
System.out. 
} 

} 

/* 

Output 


println( 


printin( 
println( 
println( 


11 24 31 


k + 
Oo + 
Ss + 


"Y 


ut 
y + 


1+ +m + 

p+" "+4+q+ 

t+ "\n"); 

X z")3 
")3 

vet" " +wt 

Z)3 





Visual J# Reference 


java.lang.String.intern() 


Places a String in the global string pool. This table maintains a single reference to each unique String ever created by an 
instance of the runtime in order to optimize space. 


J# 
public String intern() 


Property Value/Return Value 


An interned String, that is, one that has an entry in the global String pool. If the String is not already in the global String pool, 
then it will be added. 


Example 


// string _intern.jsl 


public class Program 


if 
public static void main(String[] args) 
J 
// Create three strings in three different ways. 
String s1 = "J# Sample"; 
String s2 = new StringBuffer("J#").append(" Sample").toString(); 
String s3 = s2.intern(); 
// Determine which strings are equivalent using the == 
// operator (as compared to calling equals(), which is 
// a more expensive operation. 
System.out.println("s1 == s2? " + (s1 == s2)); 
System.out.printin("s1 == s3? " + (s1 == s3))3 
} 
} 
/ * 
Output: 
s1 == s2? false 
s1 == s3? true 
*/ 
See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.lastIndexOf(int ch, int offset) 


Gets the last index of a character within a String after an offset. 


Ji 


public int lastIndexOf(int ch, int offset) 


Parameters 
Parameter |Description 


ch The character to search the String for. 





offset The position within the String to begin searching for the character. This value cannot be less than 0. 











Property Value/Return Value 


The index of the last occurrence of ch in the String after the offset, or -1 if the character does not exist within the String or if an 
invalid offset was provided. 


Example 


// string lastindexofi1.jsl 


public class Program 


{ 


public static void main(String[] args) 


{ 


String str = "The quick brown fox jumps over the lazy dog."; 


// Get the index of all the characters of the alphabet 
// starting from the beginning of the String. 


int 
int 


= str.lastIndexOf('y', str.length() - 1); 
= str.lastIndexOf('z', str.length() - 1); 


int a = str.lastIndexOf('a', str.length() - 1); 
int b = str.lastIndexOf('b', str.length() - 1); 
int c = str.lastIndexOf('c', str.length() - 1); 
int d = str.lastIndexOf('d', str.length() - 1); 
int e = str.lastIndexOf('e', str.length() - 1); 
int f = str.lastIndexOf('f', str.length() - 1); 
int g = str.lastIndexOf('g', str.length() - 1); 
int h = str.lastIndexOf('h', str.length() - 1); 
int i = str.lastIndexOf('i', str.length() - 1); 
int j = str.lastIndexOf('j', str.length() - 1); 
int k = str.lastIndexOf('k', str.length() - 1); 
int 1 = str.lastIndexOf('l', str.length() - 1); 
int m = str.lastIndexOf('m', str.length() - 1); 
int n = str.lastIndexOf('n', str.length() - 1); 
int o = str.lastIndexOf('o', str.length() - 1); 
int p = str.lastIndexOf('p', str.length() - 1); 
int q = str.lastIndexOf('q', str.length() - 1); 
int r = str.lastIndexOf('r', str.length() - 1); 
int s = str.lastIndexOf('s', str.length() - 1); 
int t = str.lastIndexOf('t', str.length() - 1); 
int u = str.lastIndexOf('u', str.length() - 1); 
int v = str.lastIndexOf('v', str.length() - 1); 
int w = str.lastIndexOf('w', str.length() - 1); 
int x = str.lastIndexOf('x', str.length() - 1); 
y 
z 


// Display the results of all the lastIndexOf method calls. 

System.out.printin(" a bc de fg hi j"); 

System.out.printin("============ss=ssssssss=====") 5 

System.out.println(a + + b+ 

e+ + f+ + gt +h + + 
+ jt 


System. 
System. 
System. 
System. 
System. 
System. 
} 

} 

/* 

Output 


out.printlIn("k 1 m no pqres tt"); 

out. println("============s=ssssssssss===") 5 

out.printiIn(k +" "+14" "4+4m4+""4n4" " 
ot" "+p4" "4+ q+t_"- "4r4"" 
s#+" "4 t 4+ "\n")5 

out.printin(" u v w x y Zz"); 

out. printin("=================") ; 

out.printlIn(u+ " "+v4""4we ""4xK4" " 
y+" " 42); 

fF g hi j 


21 27 13 18 38 
uri 


See Also 
Reference 
java.lang.String 


37 


Visual J# Reference 


java.lang.String.lastIndexOf(int ch) 


Gets the last index of a character within a String. 


Ji 


public int lastIndexOf(int ch) 


Parameters 





hohe character to search the String for. 


Property Value/Return Value 


The index of the last occurrence of ch in the String, or -1 if the character does not exist within the String. 


Example 
| 


// string lastindexof2.jsl 


public class Program 


{ 


public static void main(String[] args) 


{ 


String str = "The quick brown fox jumps over the lazy dog."; 


// Get the index of all the characters of the alphabet 
// starting from the beginning of the String. 


int a = str.lastIndexOf('a'); 
int b = str.lastIndexOf('b'); 
int c = str.lastIndexOf('c'); 
int d = str.lastIndexOf('d'); 
int e = str.lastIndexOf(‘'e'); 
int f = str.lastIndexOf('f'); 
int g = str.lastIndexOf('g'); 
int h = str.lastIndexOf('h'); 
int i = str.lastIndexOf('i'); 
int j = str.lastIndexOf('j'); 
int k = str.lastIndexOf('k'); 
int 1 = str.lastIndexOf('1'); 
int m = str.lastIndexOf('m'); 
int n = str.lastIndexOf('n'); 
int o = str.lastIndexOf('0'); 
int p = str.lastIndexOf('p'); 
int q = str.lastIndexOf('q'); 
int r = str.lastIndexOf('r'); 
int s = str.lastIndexOf('s'); 
int t = str.lastIndexOf('t'); 
int u = str.lastIndexOf('u'); 
int v = str.lastIndexOf('v'); 
int w = str.lastIndexOf('w'); 
int x = str.lastIndexOf('x'); 
int y = str.lastIndexOf('y'); 
int z = str.lastIndexOf('z'); 


// Display the results of all the lastIndexOf method calls. 
System.out.printin(" a bc deg hi j"); 


System. out. println( “sees es>sS55555555>55555====" )3 

System.out.printlIn(a+""+b+""+ce+4+#""4+4d+" "+4 
et" "4 F 4" "4+ p4" "4 h4" " 4 
i+4" "454+ "\n"); 


System.out.printin("k 1 m n o pqres tt"); 
System Ss out . println( “ae eseeeeS>5S>55555555555====" ) ’ 


System.out.printin(k + + 1+ +m + 
Oot" "Fpe""4 qe" 
Ss + " W + t te "\n")5 


System.out.printin(" u v w x y 2"); 


System.out.printin("=================") ; 
System.out.printlIn(u+" "+v+" "+we+"” 
y+ mM 4 z)3 
} 
} 
/* 
Output 


21 27 13 18 38 37 
*/ 





See Also 
Reference 
java.lang.String 





Visual J# Reference 


java.lang.String.lastIndexOf(String str, int offset) 


Gets the last index of a String within a String after an offset. 


J# 


public int lastIndexOf(String str, int offset) 


Parameters 





Parameter |Description 


str The String to search the current String for. 


offset The position within the current String to begin searching for the String. This value cannot be less than 0. 











Property Value/Return Value 


The index of the last occurrence of str in the String after the offset, or -1 if the character does not exist within the String or if an 
invalid offset was provided. 


Example 


// string _lastindexof3.jsl 


public class Program 


{ 


public static void main(String[] args) 


{ 


String str = "The quick brown fox jumps over the lazy dog." 


// Get the index of all the characters of the alphabet 
// etertans from the beginning of the String. 


int a = str.lastIndexOf("a", str.length() - 1); 
int b = str. last IndexOf("b", str.length() - 1); 
int c = str.lastIndexOf("c", str.length() - 1); 
int d = str. last IndexOf("d", str.length() - 1); 
int e = str.lastIndexOf("e", str.length() - 1); 
int f = str. last IndexOf("", str.length() - 1); 
int g = str.lastIndexOf("g", str.length() - 1); 
int h = str. last IndexOf("h", str.length() - 1); 
int i = str.lastIndexOf("i", str.length() - 1); 
int j = str. last Indexof("", str.length() - 1); 
int k = str.lastIndexOf("k", str.length() - 1); 
int 1 = str.lastIndexOf("1", str.length() - 1); 
int m = str.lastIndexOf("m", str.length() - 1); 
int n = str.lastIndexOf("n", str.length() - 1); 
int o = str.lastIndexOf("o", str.length() - 1); 
int p = str.lastIndexOf("p", str.length() - 1); 
int q = str.lastIndexOf("q", str.length() - 1); 
int r = str.lastIndexOf("r", str.length() - 1); 
int s = str.lastIndexOf("s", str.length() - 1); 
int t = str.lastIndexOf("t", str.length() - 1); 
int u = str.lastIndexOf("u", str.length() - 1); 
int v = str.lastIndexOf("v", str.length() - 1); 
int w = str.lastIndexOf("w", str.length() - 1); 
int x = str.lastIndexOf("x", str.length() - 1); 
int y = str.lastIndexOf("y", str.length() - 1); 
int z = str.lastIndexOf("z", str.length() - 1); 


// Display the results of all the lastIndexOf method calls. 

System.out.printin(" a bc de fg hi j"); 

System. out. println("================s==========="); 

System.out.println(a + + b+ 

e+ + f+ + gt +h + + 
+ jt 


System. 
System. 
System. 
System. 
System. 
System. 
} 

} 

/* 

Output 


out.printlIn("k 1 m no pqres tt"); 

out. println("============s=ssssssssss===") 5 

out.printiIn(k +" "+14" "4+4m4+""4n4" " 
ot" "+p4" "4+ q+t_"- "4r4"" 
s#+" "4 t 4+ "\n")5 

out.printin(" u v w x y Zz"); 

out. printin("=================") ; 

out.printlIn(u+ " "+v4""4we ""4xK4" " 
y+" " 42); 

fF g hi j 


21 27 13 18 38 
uri 


See Also 
Reference 
java.lang.String 


37 


Visual J# Reference 


java.lang.String.lastIndexOf(String str) 


Gets the last index of a String within a String. 
Jt 


public int lastIndexOf(String str) 


Parameters 


str The String to search the current String for. 





Property Value/Return Value 
The index of the last occurrence of str in the String, or -1 if the character does not exist within the String. 


Example 
// string lastindexof4.jsl 


public class Program 


{ 


public static void main(String[] args) 


{ 


String str = "The quick brown fox jumps over the lazy dog." 


// Get the index of all the characters of the alphabet 
// Starevie from the beginning of the String. 


int a = str.lastIndexOf("a"); 
int b = str.lastIndexOf("b"); 
int c = str.lastIndexOf("c"); 
int d = str.lastIndexOf("d"); 
int e = str.lastIndexOf("e"); 
int f = str.lastIndexOf("f"); 
int g = str.lastIndexOf("g"); 
int h = str.lastIndexOf("h"); 
int i = str.lastIndexOf("i"); 
int j = str.lastIndexof("j"); 
int k = str.lastIndexOf("k"); 
int 1 = str.lastIndexof("1"); 
int m = str.lastIndexOf("m"); 
int n = str.lastIndexOf("n"); 
int o = str.lastIndexOf("o"); 
int p = str.lastIndexOf("p"); 
int q = str.lastIndexOf("q"); 
int r = str.lastIndexOf("r"); 
int s = str.lastIndexOf("s"); 
int t = str.lastIndexOf("t"); 
int u = str.lastIndexOf("u"); 
int v = str.lastIndexOf("v"); 
int w = str.lastIndexOf("w"); 
int x = str.lastIndexOf("x"); 
int y = str.lastIndexOf("y"); 
int z = str.lastIndexOf("z"); 


// Display the results of all the lastIndexOf method calls. 
System.out.printin(" a bc de fg hi j"); 


System. out. println( “sees es>sS55555555>55555====" )3 

System.out.printlIn(a+""+b+""+ce+4+#""4+4d+" "+4 
et" "4 F 4" "4+ p4" "4 h4" " 4 
i+4" "454+ "\n"); 


System.out.printin("k 1 m n o pqres tt"); 
System Ss out . println( “ae eseeeeS>5S>55555555555====" ) ’ 


System.out.printin(k + + 1+ +m + 
Oot" "Fpe""4 qe" 
Ss + " W + t te "\n")5 


System.out.printin(" u v w x y 2"); 


System.out.printin("=================") ; 
System.out.printlIn(u+" "+v+" "+we+"” 
y+ mM 4 z)3 
} 
} 
/* 
Output 


21 27 13 18 38 37 
*/ 





See Also 
Reference 
java.lang.String 





Visual J# Reference 


java.lang.String.length() 


Gets the length of the String, which is the number of Unicode characters in the String. 


J# 





public int length() 





Property Value/Return Value 


The length of the String. 














Example 
// string length. jsl 
public class Program 
{ 
public static void main(String[] args) 
if 
String str = "How long is this String? "; 
// Get the length of str. 
int len = str.length(); 
// Display the results of calling length. 
System.out.println(str + len); 
} 
} 
/* 
Output: 
How long is this String? 25 
m/ 
See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.regionMatches(int offset1, String str2, int 
offset2, int count) 


Determines whether a region in the current String matches a region in another String. 














J# 
public boolean regionMatches(int offset1, String str2, int offset2, int count) 
Parameters 
Parameter Description 
offset1 The index of the first character in the current String used for comparing to str2. 
str2 The String to compare against the current String. 
offset2 The index of the first character in str2 used for comparing to the current String. 
count The number of characters within the two String objects to compare. 











Property Value/Return Value 


true if the specified regions in the two String objects match; false if the specified regions do not match or if offset7, offset2, or 
count are invalid. 


Example ee 








// string _regionmatches1.jsl 
public class Program 
{ 
public static void main(String[] args) 
1 
String stri = "Missouri Florida Colorado Washington" ; 
String str2 = "Washington Colorado Florida Missouri"; 
// Determine whether characters @ through 7 in str1 
// match characters 28 through 35 in str2. 
boolean match1 = stri.regionMatches(@, str2, 28, 8); 
// Determine whether characters 9 through 15 in str1 
// match characters 9 through 15 in str2. 
boolean match2 = stri.regionMatches(9, str2, 9, 8); 
// Display the results of the regionMatches method calls. 
System.out.printin("stri[@ - 7] == str2[28 - 35]? " + match1); 
System.out.printin("stri[9 - 15] == str2[9 - 15]? " + match2); 
} 
} 
f* 
Output: 
stri[@ - 7] == str2[28 - 35]? true 
stri[9 - 15] == str2[9 - 15]? false 
m/f 
See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.regionMatches(boolean ignoreCase, int 
offset1, String str2, int offset2, int count) 


Determines whether a region in the current String matches a region in another String, potentially ignoring the case of the 
characters. 


J# 


public boolean regionMatches(boolean ignoreCase, int offset1, String str2, int offset2, int 








count) 
Parameters 
Parameter (Description 
ignoreCase __ {true to ignore the case of the characters when doing a comparison; false otherwise. 
offset1 The index of the first character in the current String used for comparing to str2. 
str2 The String to compare against the current String. 
offset2 The index of the first character in str2 used for comparing to the current String. 
count The number of characters within the two String objects to compare. 











Property Value/Return Value 


true if the specified regions in the two String objects match according to the value of the ignoreCase flag; false if the specified 
regions do not match or if offset7, offset2, or count are invalid. 


Example a, 


// string _regionmatches2.jsl 
public class Program 
{ 
public static void main(String[] args) 
1 
String stri = "Missouri Florida Colorado Washington" ; 
String str2 = "washington colorado florida missouri"; 
// Determine whether characters @ through 7 in str1 
// match characters 28 through 35 in str2, ignoring the 
// case of the letters. 
boolean match1 = stri.regionMatches(true, @, str2, 28, 8); 
// Determine whether characters 9 through 15 in str1 
// match characters 9 through 15 in str2, ignoring the 
// case of the letters. 
boolean match2 = stri.regionMatches(true, 9, str2, 9, 8); 
// Display the results of the regionMatches method calls. 
System.out.printin("stri[@ - 7] == str2[28 - 35]? " + match1); 
System.out.printin("stri[9 - 15] == str2[9 - 15]? " + match2); 
} 
} 
/* 
Output: 
stri[@ - 7] == str2[28 - 35]? true 
stri[9 - 15] == str2[9 - 15]? false 
ar A 








See Also 
Reference 
java.lang.String 


Visual J# Reference 


java.lang.String.replace(char oldChar, char newChar) 


Replaces all existing occurrences of a character in a String with another character. 


J# 


public String replace(char oldChar, char newChar) 





Parameters 

Parameter Description 

oldChar The existing character to replace. 
newChar The character to replace oldChar with. 














Property Value/Return Value 


A new String object where all existing occurrences of oldChar have been replaced with newChar. 


Example ee 











// string _replace.jsl 
public class Program 
{ 
public static void main(String[] args) 
{ 
String str = "The quick brown fox jumps over the lazy dog."; 
// Replace all the ‘d' characters with '1l' characters. 
String newStr = str.replace('d', ‘1'); 
// Display the strings for comparison. 
System.out.println("old = " + str); 
System.out.println("new = " + newStr); 
} 
} 
f® 
Output 
old = The quick brown fox jumps over the lazy dog. 
new = The quick brown fox jumps over the lazy log. 
*/ 
See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.startsWith(String prefix) 


Determines whether the current String starts with the contents of another String. 


J# 


public boolean startsWith(String prefix) 





Parameters 
Parameter (Description 
prefix The String whose contents will be compared against the beginning of the current String. 











Property Value/Return Value 


true if the current String starts with the contents of prefix; false otherwise. 


Example 











// string startswith1.jsl 
public class Program 
{ 
public static void main(String[] args) 
{ 
String stri = "Fred is my name."; 
String str2 = "Xiao Mei is my name."; 
// The String to check the above two Strings to see 
// if they start with this value (Xi). 
String startStr = "Xi"; 
// Do either of the first two Strings start with startStr? 
boolean starts1 = stri.startsWith(startStr) ; 
boolean starts2 = str2.startsWith(startStr) ; 
// Display the results of the startsWith calls. 
System.out.printin("\"" + str1 + "\" starts with " + 
"\"" + startStr + "\"P " + starts1); 
System.out.printin("\"" + str2 + "\" starts with " + 
"\"" +4 startStr + "\"P " + starts2); 
} 
} 
/* 
Output: 
"Fred is my name." starts with "Xi"? false 
"Xiao Mei is my name." starts with "Xi"? true 
ed 
See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.startsWith(String prefix, int offset) 


Determines whether the current String starts with the contents of another String. 


J# 


public boolean startsWith (String prefix, int offset) 








Parameters 

Parameter (Description 

prefix The String whose contents will be compared against the beginning of the current String. 
offset The index of the first character within the current String to compare against prefix. 











Property Value/Return Value 


true if the current String starts with the contents of prefix after the offset; false if the current String does not start with the 
contents of prefix after the offset or if offset is invalid. 








Example 
// string startswith2.jsl 
public class Program 
{ 
public static void main(String[] args) 
{ 
String stri = "abcFred is my name."; 
String str2 = "abcXiao Mei is my name."; 
// The String to check the above two Strings to see 
// if they start with the value Xi. 
String startStr = "Xi"; 
// Do either of the first two Strings start with startStr 
// starting from index 3? 
boolean starts1 = stri.startsWith(startStr, 3); 
boolean starts2 = str2.startsWith(startStr, 3); 
// Display the results of the startsWith calls. 
System.out.printin("\"" + str1 + "\" starts with " + 
"\"" + startStr + "\" starting from index 3? " + starts1); 
System.out.printin("\"" + str2 + "\" starts with " + 
"\"" + startStr + "\" starting from index 3? " + starts2); 
} 
} 
/* 
Output: 
"abcFred is my name." starts with "Xi" starting from index 3? false 
"abcXiao Mei is my name." starts with "Xi" starting from index 3? true 
a, 
See Also 
Reference 


java.lang.String 





Visual J# Reference 


java.lang.String.substring(int offset) 


Creates a new String object containing the contents of the existing String after an offset. 


J# 


public String substring(int offset) 





Parameters 
Param |Description 
eter 





offset [The index of the first character within the current String to copy into the new java.lang.String object. An 


IndexOutOfBoundsException is thrown if this index is invalid. 











Property Value/Return Value 
A new java.lang.String object containing the contents of the existing String after an offset. 


Example OOOO 








// string substring1.jsl 
public class Program 
public static void main(String[] args) 
{ 
String str = "Navy blue is my favorite color."; 
// Get a substring of the above string starting from 
// index 5. 
String newStr = str.substring(5); 
// Display the two strings for comparison. 
System.out.println("old = " + str); 
System.out.println("new = " + newStr); 
} 
} 
fp 
Output 
old = Navy blue is my favorite color. 
new = blue is my favorite color. 
=) 
See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.substring(int offset, int endindex) 


Creates a new String object containing the contents of the existing String between two indices. 


J# 


public String substring(int offset, int endIndex) 





Parameters 
Param |Description 
eter 





offset |The index of the first character within the current String to copy into the new java.lang.String object. An 
IndexOutofBoundsException is thrown if this index is invalid. 


endind |The index of the last character within the current String to copy into the new java.lang.String object. An 
ex IndexOutofBoundsException is thrown if this index is invalid. 








Property Value/Return Value 


A new java.lang.String object containing the contents of the existing String between offset and endIndex. 

















Example 
// string substring2.jsl 
public class Program 
if 
public static void main(String[] args) 
{ 
String str = "Navy blue is my favorite color."; 
// Get a substring of the above string starting from 
// index 5 and ending at index 24. 
String newStr = str.substring(5, 24); 
// Display the two strings for comparison. 
System.out.println("old = " + str); 
System.out.println("new = " + newStr); 
} 
} 
/* 
Output: 
old = Navy blue is my favorite color. 
new = blue is my favorite 
ay | 
See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.toCharArray() 


Creates a character array containing the contents of the String. 


J# 


public char[] toCharArray() 


Property Value/Return Value 
A character array containing the contents of the String. 
Example 


// string tochararray.jsl 


public class Program 


{ 
public static void main(String[] args) 
if 
String str = "This is a String."; 
// Convert the above string to a char array. 
char[] arr = str.toCharArray(); 
// Display the contents of the char array. 
System.out.println(arr) ; 
} 
} 
/ * 
Output: 
This is a String. 
*/ 
See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.toString() 


Displays a human-readable representation of a String object. 


J# 
public String toString() 


Property Value/Return Value 


A human-readable representation of a String object. For String objects, a new String is created containing the contents of the 
current String. 


Example 


// string tostring.jsl 


public class Program 


{ 
public static void main(String[] args) 
{ 
String str = "This is a String."; 
// Convert the above string to another string. 
String str2 = str.toString(); 
// Display the contents of the new string. 
System.out.println(str2) ; 
} 
} 
/ * 
Output: 
This is a String. 
arf 
See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.toLowerCase() 


Converts all the characters in a String to lowercase. 


J# 


public String toLowerCase() 


Property Value/Return Value 
A String object containing all the characters of the current String converted to lowercase. 
Example 


// string tolowercasel1.jsl 


public class Program 


{ 
public static void main(String[] args) 
if 
String str = "ThIs Is HaRd To ReAd."; 
// Convert the above string to all lowercase. 
String lowerStr = str.toLowerCase(); 
// Display the two strings for comparison. 
System.out.println("old = " + str); 
System.out.println("lowercase = " + lowerStr); 
} 
} 
/* 
Output: 


old = ThIs Is HaRd To ReAd. 
lowercase = this is hard to read. 


*/ 


See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.toLowerCase(Locale loc) 


Converts all the characters in a java.lang.String to lowercase using the given Locale. 


J# 


public String toLowerCase(Locale loc) 





Parameters 
Parameter Description 
loc The Locale for the newly created java.lang.String object. 











Property Value/Return Value 
A String object containing all the characters of the current String converted to lowercase. 


Example OO _ 











// string tolowercase2.jsl 
import java.util.Locale; 
public class Program 
{ 
public static void main(String[] args) 
1 
String str = "ThIs Is HaRd To ReAd."; 
// Convert the above string to all lowercase 
// using the default system Locale. 
Locale loc = Locale.getDefault(); 
String lowerStr = str.toLowerCase(loc); 
// Display the two strings for comparison. 
System.out.println("old = " + str); 
System.out.println("lowercase = " + lowerStr); 
} 
} 
/* 
Output: 
old = ThIs Is HaRd To ReAd. 
lowercase = this is hard to read. 
*/ 
See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.toUpperCase() 


Converts all the characters in a String to uppercase. 


J# 
public String toUpperCase() 


Property Value/Return Value 
A String object containing all the characters of the current String converted to uppercase. 
Example 


// string touppercasel.jsl 


public class Program 


{ 
public static void main(String[] args) 
if 
String str = "ThIs Is HaRd To ReAd."; 
// Convert the above string to all uppercase. 
String upperStr = str.toUpperCase(); 
// Display the two strings for comparison. 
System.out.println("old = " + str); 
System.out.println("uppercase = " + upperStr); 
} 
} 
/* 
Output: 


old = ThIs Is HaRd To ReAd. 
uppercase = THIS IS HARD TO READ. 
Te 


See Also 
Reference 
java.lang.String 


Visual J# Reference 


java.lang.String.toUpperCase(Locale loc) 


Converts all the characters in a java.lang.String to uppercase using the given Locale. 


J# 


public String toUpperCase(Locale loc) 





Parameters 
Parameter Description 
loc The Locale for the newly created String object. 








Property Value/Return Value 
A String object containing all the characters of the current String converted to uppercase. 


Example OO _ 











// string touppercase2.jsl 
import java.util.Locale; 
public class Program 
{ 
public static void main(String[] args) 
1 
String str = "ThIs Is HaRd To ReAd."; 
// Convert the above string to all uppercase 
// using the default system Locale. 
Locale loc = Locale.getDefault(); 
String upperStr = str.toUpperCase(loc); 
// Display the two strings for comparison. 
System.out.println("old = " + str); 
System.out.println("uppercase = " + upperStr); 
} 
} 
/* 
Output: 
old = ThIs Is HaRd To ReAd. 
uppercase = THIS IS HARD TO READ. 
i] 
See Also 
Reference 


java.lang.String 





Visual J# Reference 


java.lang.String.trim() 


Creates a new String by trimming any leading or trailing whitespace from the current String. 


J# 
public String trim() 


Property Value/Return Value 
A new String containing the contents of the current String minus any leading or trailing whitespace. 
Example 


// string trim.jsl 


public class Program 


{ 
public static void main(String[] args) 
if 
String str = "\n\t This is a String.\n\n"; 
// Trim the whitespace from the front and back of the 
// String. 
String newStr = str.trim(); 
// Display the strings for comparison. 
System.out.println("old = " + str); 
System.out.printlin("new = " + newStr); 
} 
/* 
Output: 
old = 


This is a String. 


new = This is a String. 


| 


See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.valueOf(boolean bool) 


Creates a new String object containing the string representation of a boolean. 


J# 


public static String valueOf(boolean bool) 





Parameters 
Parameter Description 
bool A boolean value to be converted to a String. 











Property Value/Return Value 
A new String object containing the string representation of a boolean. 


Example OO _ 








// string valueof1.jsl 
public class Program 
{ 
public static void main(String[] args) 
{ 
String trueStr = String.valueOf(true) ; 
String falseStr = String.valueOf(false) ; 
// Display the string representations of the above 
// boolean values. 
System.out.println(trueStr) ; 
System.out.println(falseStr) ; 
} 
} 
fe 
Output 
true 
false 
*/ 
See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.valueOf(char ch) 


Creates a new String object containing the string representation of a char. 


J# 


public static String valueOf(char ch) 





Parameters 
Parameter Description 
ch A char value to be converted to a String. 











Property Value/Return Value 


A new String object containing the string representation of a char. 


Example _ 








// string valueof2.jsl 
public class Program 
{ 
public static void main(String[] args) 
{ 
String aStr = String.valueOf('a'); 
String bStr = String.valueOf('b'); 
// Display the string representations of the above 
// char values. 
System.out.println(aStr) ; 
System.out.println(bStr) ; 
} 
} 
f® 
Output: 
a 
b 
*/ 
See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.valueOf(double dnum) 


Creates a new String object containing the string representation of a double. 


C# 


public static String valueOf(double dnum) 





Parameters 
Parameter Description 
dnum A double value to be converted to a String. 











Property Value/Return Value 


A new String object containing the string representation of a double. 


Example a 








// string valueof3.jsl 
public class Program 
{ 
public static void main(String[] args) 
{ 
String piStr = String.valueOf(3.14); 
String minStr = String.valueOf(Double.MIN_VALUE) ; 
// Display the string representations of the above 
// double values. 
System.out.println(piStr) ; 
System.out.println(minStr) ; 
} 
} 
/* 
Output: 
3.14 
4.94065645841247E-324 
*/ 
See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.valueOf(float fnum) 


Creates a new String object containing the string representation of a float. 


J# 


public static String valueOf(float fnum) 





Parameters 
Parameter Description 
fnum A float value to be converted to a String. 











Property Value/Return Value 
A new String object containing the string representation of a float. 


Example _ 








// string valueof4.jsl 
public class Program 
{ 
public static void main(String[] args) 
{ 
String piStr = String.valueOf(3.14f) ; 
String minStr = String.valueOf(Float.MIN_VALUE) ; 
// Display the string representations of the above 
// float values. 
System.out.println(piStr) ; 
System.out.println(minStr) ; 
} 
} 
/* 
Output: 
3.14 
1.401298E-45 
=] 
See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.valueOf(int inum) 


Creates a new String object containing the string representation of an int. 


J# 


public static String valueOf(int inum) 





Parameters 
Parameter Description 
inum An int value to be converted to a String. 











Property Value/Return Value 
A new String object containing the string representation of an int. 


Example a _ 








// string valueof5.jsl 
public class Program 
{ 
public static void main(String[] args) 
{ 
String hundredStr = String.valueOf(10@) ; 
String minStr = String.valueOf(Integer.MIN_VALUE) ; 
// Display the string representations of the above 
// int values. 
System.out.println(hundredStr) ; 
System.out.println(minStr) ; 
} 
} 
/* 
Output: 
100 
-2147483648 
*/ 
See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.valueOf(long Inum) 


Creates a new String object containing the string representation of a long. 


J# 


public static String valueOf(long lnum) 





Parameters 
Parameter Description 
lnum A long value to be converted to a String. 











Property Value/Return Value 
A new String object containing the string representation of a long. 


Example me 








// string valueof6.jsl 
public class Program 
{ 
public static void main(String[] args) 
{ 
String hundredStr = String.valueOf(1@@L) ; 
String minStr = String.valueOf(Long.MIN_VALUE) ; 
// Display the string representations of the above 
// long values. 
System.out.println(hundredStr) ; 
System.out.println(minStr) ; 
} 
} 
/* 
Output: 
100 
-9223372036854775808 
mf 
See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.valueOf(Object obj) 


Creates a new String object containing the string representation of an Object. 


J# 


public static String valueOf(Object obj) 





Parameters 
Parameter Description 
obj An Object to be converted to a String. 








Property Value/Return Value 


A new java.lang.String object containing the string representation of an Object. This is equivalent to calling the toString 
method on the object. 











Example 
// string valueof7.jsl 
public class Program 
{ 
public static void main(String[] args) 
si 
Long hundred = new Long(1@@); 
String hundredStr = String.valueOf(hundred) ; 
Long minLong = new Long(Long.MIN VALUE); 
String minStr = String.valueOf(minLong) ; 
// Display the string representations of the above 
// Object values. 
System.out.println(hundredStr) ; 
System.out.println(minStr) ; 
} 
} 
/* 
Output: 
100 
-9223372036854775808 
me /- 
See Also 
Reference 


java.lang.String 





Visual J# Reference 


java.lang.String.valueOf(char[] data) 


Creates a new String object containing the string representation of a character array. 


J# 


public static String valueOf(char[] data) 





Parameters 
Parameter Description 
data A character array to be converted to a String. 











Property Value/Return Value 
A new String object containing the string representation of a character array. 


Example _ 











// string valueof8.jsl 
public class Program 
{ 
public static void main(String[] args) 
{ 
char[] arrl = new char[] { ‘a’, 'b', ‘c' }; 
String str1 = String.valueOf(arr1) ; 
char[] arr2 = new char[] { '1', '2', '3' };3 
String str2 = String.valueOf(arr2) ; 
// Display the string representations of the above 
// char array values. 
System.out.println(str1) ; 
System.out.println(str2) ; 
} 
} 
/* 
Output: 
abc 
123 
ar A 
See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.valueOf(char[] data, int offset, int count) 


Creates a new String object containing the string representation of a character array. 


J# 


public static String valueOf(char[] data, int offset, int count) 





Parameters 

Para |Description 
met 

er 


data |A character array to be converted to a String. 


offse|The first character in the character array to be written to the String. This value must be greater than zero and less than th 
t e length of the character array. 


coun|The number of characters within the character array, after the offset, to be written to the String. If this value is greater th 
t an the number of characters in the character array after the offset, then only the remaining characters are copied into the 
String. 





Property Value/Return Value 


A new String object containing the string representation of a character array. 














Example 
// string valueof9.jsl 
public class Program 
{ 
public static void main(String[] args) 
char[] arrl = new char[] { ‘a’, 'b', ‘c' };5 
String str1 = String.valueOf(arr1, 1, 2); 
char[] arr2 = new char[] { '1', '2', '3' };5 
String str2 = String.valueOf(arr2, 2, 1); 
// Display the string representations of the above 
// char array values. 
System.out.println(str1) ; 
System.out.println(str2) ; 
} 
} 
/* 
Output 
bc 
3 
of 
See Also 
Reference 


java.lang.String 





Visual J# Reference 


java.lang.String.compareTo(Object str) 


Compares two String objects for equality. 
J# 


public int compareTo(Object str) 





Parameters 
Parameter Description 
str A java.lang.String object to compare with the current String object for equality. 








Property Value/Return Value 


Less than zero if the current String object is less than str, zero if the two String objects are equal, or greater than zero if str is 
greater than the current String object. 

















Example 
// string _comparetoobj.jsl 
public class Program 
{ 
public static void main(String[] args) 
{ 
String stri = "This is string 1"; 
Object str2 = new String("This is string 2"); 
// Compare the two strings. 
int result = stri.compareTo(str2); 
// Display the results of the comparison. 
if (result < @) 
{ 
System.out.printin("\"" + str2 + "\"" + 
"is less than " + 
i aa # str2 + ON 
else if (result == @) 
{ 
System.out.printin("\"" + strd + "\"" + 
"is equal to " + 
we " + str2 + my 3 
} 
else // if (result > @) 
System.out.printlin("\"" + str2 + "\"" + 
"is greater than " + 
we W es str2 + eS 
} 
} 
} 
/* 
Output: 
"This is string 1" is less than "This is string 2" 
* f 
See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.compareTolgnoreCase(String str) 


Compares two String objects for equality, ignoring the case of the characters. 


J# 


public int compareTolIgnoreCase(String str) 





Parameters 
Parameter Description 
str A java.lang.String object to compare with the current String object for equality. 








Property Value/Return Value 


Less than zero if the current String object is less than str, zero if the two String objects are equal, or greater than zero if str is 
greater than the current String object. The case of the characters is ignored in all cases. 

















Example 
// string _comparetoignorecase.jsl 
public class Program 
{ 
public static void main(String[] args) 
{ 
String stri = "ThIs Is StRiNg 1"; 
String str2 = "This is string 2"; 
// Compare the two strings. 
int result = str1.compareToIgnoreCase(str2); 
// Display the results of the comparison. 
if (result < @) 
{ 
System.out.printin("\"" + str2 + "\"" + 
"is less than " + 
WAN W # str2 + ON 
else if (result == @) 
{ 
System.out.printin("\"" + strd + "\"" + 
"is equal to " + 
we " + str2 + my 3 
} 
else // if (result > @) 
System.out.printlin("\"" + str2 + "\"" + 
"is greater than " + 
we W es str2 + eS 
} 
} 
} 
/* 
Output: 
"ThIs Is StRiNg 1" is less than "This is string 2" 
+f 
See Also 
Reference 


java.lang.String 


Visual J# Reference 


java.lang.String.CASE_INSENSITIVE ORDER 


The Comparator object used when comparing String objects for equality. 


J# 


public static final Comparator CASE _INSENSITIVE_ORDER 


Example 
// There is no Code Example for this constant. 
See Also 


Reference 
java.lang.String 


Visual J# Reference 


java.lang.Thread 


Represents an independent stream of execution within a program. 


J# 


public class Thread implements Runnable 


Example 


// thread_overview.jsl 


public class Program implements Runnable 


public static void main(String[] args) 


Program p = new Program(); 
p.init(); 


public void init() 


{ 
{ 
} 
{ 
try 
{ 


// Create a second thread and start it. 
Thread thr2 = new Thread(this); 
thr2.setDaemon( false) ; 
thr2.setName("Thread 2"); 
thr2.setPriority(Thread.MAX_PRIORITY) ; 
System.out.printin("Starting " + 
thr2.getName() + "...")3 


thr2.start(); 


// Create a third thread and start it. 
Thread thr3 = new Thread(this) ; 
thr3.setDaemon(true) ; 
thr3.setName("Thread 3"); 
thr3.setPriority(Thread.NORM_PRIORITY) ; 
System.out.printin("Starting " + 

thr3.getName() + "...")3 
thr3.start(); 


// Display the number of active threads. This 

// count includes the main thread. 

System.out.printin("Active threads = " + 
Thread.activeCount()); 


// Wait some time for the child threads to start. 
try 


Thread.sleep(5@@) ; 
catch (InterruptedException ex) 
// Ignore the exception here. 
// Interrupt the two sub-threads. 
thr2.interrupt(); 
thr3.interrupt(); 
// Block until the other threads finish. 


thr2.join(); 
thr3.join(); 


catch (InterruptedException ex) 


d 


System.out.println(ex.toString()); 


} 


// Implements Runnable.run() 
public void run() 


if 
try 
{ 
Thread currentThread = Thread.currentThread() ; 
System.out.println(currentThread.getName() + 
" [daemon = " + currentThread.isDaemon() + 
", priority = " + currentThread.getPriority() + 
"] is executing."); 
while (true) 
{ 
Thread.sleep(5@@) ; 
} 
} 
catch (InterruptedException ex) 
{ 
Thread currentThread = Thread.currentThread() ; 
System.out.println(currentThread.getName() + 
"was interrupted: " + ex.toString()); 
} 
} 
; 
/* 


Sample Output: 
Starting Thread 2... 
Starting Thread 3... 
Thread 2 [daemon = false, priority = 10] is executing. 

Active threads = 3 

Thread 3 [daemon = true, priority = 5] is executing. 

Thread 3 was interrupted: java.lang.InterruptedException: Thread has been interrupted from 
a waiting state. 

Thread 2 was interrupted: java.lang.InterruptedException: Thread has been interrupted from 
a waiting state. 


*/ 


See Also 
Concepts 
Visual J# Class Library 


Visual J# Reference 


java.lang.Thread.Thread(ThreadGroup group, Runnable 
runnable, String name) 


Initializes a new instance of a named 2d622dab-0fb9-4756-8474-b94e83c9aae1 object from the given 
290ee7fa-aa87-4288-8644-5b2d5e6a3817. The thread will execute the code in the run method of the given 
30f26323-1728-4a53-a8f6-9560bcb68bf0 object. 


J# 





public Thread(java.lang.ThreadGroup group, java.lang.Runnable runnable, String name) 


Parameters 





Parameter |Description 





group The 290ee7fa-aa87-4288-8644-5b2d5e6a3817 containing the newly created thread. 
runnable — |An instance of 30f26323-1728-4a53-a8f6-9560bcb68bf0 containing the code for the thread to execute. 


name The name for the thread. 








See Also 
Reference 
java.lang.Thread 





Visual J# Reference 


java.lang.Thread.Thread(Runnable runnable, String name) 


Initializes a new instance of a named 2d622dab-0fb9-4756-8474-b94e83c9aael object. The thread will execute the code in the 


run method 


J# 


of the given 30f26323-1728-4a53-a8f6-9560bcb68bf0 object. 





public 


Parameters 


Thread(java.lang.Runnable runnable, String name) 





Parameter 


Description 





runnable 


An instance of 30f26323-1728-4a53-a8f6-9560bcb68bf0 containing the code for the thread to execute. 





name 





See Also 
Reference 


The name for the thread. 








java.lang.Thread 


Visual J# Reference 


java.lang.Thread.Thread(ThreadGroup group, String name) 


Initializes a new instance of a named 2d622dab-0fb9-4756-8474-b94e83c9aael object from the given 
290ee7 fa-aa87 -4288-8644-5b2d5e6a3817. 


J# 





public Thread(java.lang.ThreadGroup group, String name) 


Parameters 





Parameter (Description 





group The 290ee7fa-aa87-4288-8644-5b2d5e6a3817 containing the newly created thread. 








name The name for the thread. 








See Also 
Reference 


java.lang.Thread 


Visual J# Reference 


java.lang.Thread.Thread(ThreadGroup group, Runnable 
runnable) 


Initializes a new instance of a 2d622dab-0fb9-4756-8474-b94e83c9aael object from the given 
290ee7fa-aa87-4288-8644-5b2d5e6a3817. The thread will execute the code in the run method of the given 
30f26323-1728-4a53-a8f6-9560bcb68bf0 object. 


J# 





public Thread(java.lang.ThreadGroup group, java.lang.Runnable runnable) 


Parameters 





Parameter |Description 





group The 290ee7fa-aa87-4288-8644-5b2d5e6a3817 containing the newly created thread. 


runnable — |An instance of 30f26323-1728-4a53-a8f6-9560bcb68bf0 containing the code for the thread to execute. 








See Also 
Reference 
java.lang.Thread 





Visual J# Reference 


java.lang.Thread.Thread(String name) 


Initializes a new instance of a named 2d622dab-0fb9-4756-8474-b94e83c9aael object. 
J# 


public Thread(String name) 











Parameters 

Parameter Description 

name The name for the thread. 
See Also 

Reference 


java.lang.Thread 





Visual J# Reference 


java.lang.Thread.Thread(Runnable runnable) 


Initializes a new instance of a 2d622dab-0fb9-4756-8474-b94e83c9aael object. The thread will execute the code in the run 
method of the given 30f26323-1728-4a53-a8f6-9560bcb68bf0 object. 


J# 





public Thread(java.lang.Runnable runnable) 


Parameters 





Parameter |Description 





runnable — |An instance of 30f26323-1728-4a53-a8f6-9560bcb68bf0 containing the code for the thread to execute. 














See Also 
Reference 
java.lang.Thread 


Visual J# Reference 


java.lang.Thread.Thread() 


Initializes a new instance of a 2d622dab-0fb9-4756-8474-b94e83c9aael object. 


J# 





public Thread() 





See Also 
Reference 
java.lang.Thread 


Visual J# Reference 


java.lang.Thread.activeCount() 


Gets the number of active threads from the 290ee/7fa-aa87-4288-8644-5b2d5e6a3817 containing the current thread. 


J# 


public static int activeCount() 


Property Value/Return Value 
The number of active threads from the 290ee7fa-aa87-4288-8644-5b2d5e6a3817 containing the current thread. 
Example 


// thread_activecount.jsl 


public class Program implements Runnable 


{ 


public static void main(String[] args) 
if 
Program p = new Program(); 
p.init(); 
} 


public void init() 
1 
try 
{ 
// Create a second thread and start it. 
Thread thr2 = new Thread(this) ; 
System.out.printin("Starting " + 
thr2.getName() + "...")3 
thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(this) ; 

System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Display the number of active threads. This 

// count includes the main thread. 

System.out.println("Active threads = " + 
Thread.activeCount()); 


// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 


catch (InterruptedException ex) 


{ 
} 


System.out.printin(ex.toString()); 


} 


// Implements Runnable.run() 
public void run() 


1 
for (int i = @; i < 10@Q@Q0000; i++) 


// Just increment a counter. 
counter++3; 


} 


System.out.println(Thread.currentThread().getName() + 


"has finished executing."); 


} 


private int counter = @; 


} 


/* 

Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Active threads = 3 

Thread-@ has finished executing. 
Thread-1 has finished executing. 
*/ 





See Also 
Reference 
java.lang.Thread 





Visual J# Reference 


java.lang.Thread.checkAccess() 


Determines whether a thread has permission to access a resource. 


J# 
public void checkAccess() 


Remarks 


A 7dcba491 -f8ac-4c05-b593-95c5a8ecda18 is thrown if the thread does not have permission to access a resource. 
Example 


// thread_checkaccess.jsl 


public class Program implements Runnable 


{ 
public static void main(String[] args) 
if 
Program p = new Program(); 
p.init(); 
} 
public void init() 
1 
try 
{ 


// Create a second thread and start it. 

Thread thr2 = new Thread(this) ; 

System.out.printin("Starting " + 
thr2.getName() + "...")3 


thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(this) ; 

System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Check the access for these threads. 
try 


thr2.checkAccess(); 
System.out.println(thr2.getName() + 
"has access."); 


thr3.checkAccess(); 
System.out.println(thr3.getName() + 
"has access."); 


catch (SecurityException ex) 


{ 


System.out.println("Thread doesn't have access: + 
ex.toString()); 
i 
// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 


catch (InterruptedException ex) 


{ 
, 


System.out.println(ex.toString()); 


} 


// Implements Runnable.run() 
public void run() 


{ 
for (int i = @; i < 10@Q@Q00000; i++) 
{ 
// Just increment a counter. 
counter++; 
} 
System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 
} 
private int counter = @; 
} 
/* 


Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Thread-@ has access. 

Thread-1 has access. 

Thread-@ has finished executing. 
Thread-1 has finished executing. 


a 


See Also 
Reference 
java.lang.Thread 


Visual J# Reference 


java.lang.Thread.countStackFrames() 


This method is not supported by J#. 


J# 


public int countStackFrames() 


Property Value/Return Value 
This method is not supported by J#. 


See Also 
Reference 


java.lang.Thread 


Visual J# Reference 


java.lang.Thread.currentThread() 


Gets the 2d622dab-0fb9-4756-8474-b94e83c9aael object that is calling the current code block. 
J# 


public static java.lang.Thread currentThread() 


Property Value/Return Value 
The 2d622dab-0fb9-4756-8474-b94e83c9aaell object that is calling the current code block. 
Example 


// thread_currentthread.jsl 


public class Program implements Runnable 


{ 


public static void main(String[] args) 
if 
Program p = new Program(); 
p.init(); 
} 


public void init() 
1 
try 
{ 
// Create a second thread and start it. 
Thread thr2 = new Thread(this) ; 
System.out.printin("Starting " + 
thr2.getName() + "...")3 
thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(this) ; 

System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Display the number of active threads. This 

// count includes the main thread. 

System.out.println("Active threads = " + 
Thread.activeCount()); 


// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 


catch (InterruptedException ex) 


{ 
} 


System.out.printin(ex.toString()); 


} 


// Implements Runnable.run() 
public void run() 


1 
for (int i = @; i < 10@Q@Q0000; i++) 


// Just increment a counter. 
counter++3; 


} 


// Display the name of the thread executing this code. 


System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 


} 


private int counter = @; 


} 


/* 

Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Active threads = 3 

Thread-@ has finished executing. 
Thread-1 has finished executing. 


*/ 











See Also 
Reference 
java.lang.Thread 


Visual J# Reference 


java.lang.Thread.destroy() 


This method is not supported by J#. 


J# 





public void destroy() 





Remarks 
A 15d0a457-2d84-41 ff-87de-4164fcf8f559 is thrown if this method is called. 


See Also 
Reference 
java.lang.Thread 


Visual J# Reference 


java.lang.Thread.dumpStack() 


This method is not supported by J#. 
J# 


public static void dumpStack() 


Remarks 
A java.lang.MethodNotSupportedException is thrown if this method is called. 


See Also 
Reference 


java.lang.Thread 


Visual J# Reference 


java.lang.Thread.enumerate(Thread[] threads) 


Gets all the 2d622dab-0fb9-4756-8474-b94e83c9aael objects that belong to the same 
290ee7fa-aa87-4288-8644-5b2d5e6a3817 as the current thread. 


J# 


public static int enumerate(java.lang.Thread[] threads) 


Parameters 





Param |Description 


threads |An array of all the 2d622dab-0fb9-4756-8474-b94e83c9aaell objects that belong to the same 290ee7fa-aa87-428 


8-8644-5b2d5e6a3817 as the current thread 





Property Value/Return Value 
The number of threads in the same 290ee7fa-aa87-4288-8644-5b2d5e6a3817 as the current thread. 
Example 


// thread_enumerate.jsl 


public class Program implements Runnable 


x 
public static void main(String[] args) 
{ 
Program p = new Program(); 
p.init(); 
} 
public void init() 
if 
try 
{ 


// Create a second thread and start it. 

Thread thr2 = new Thread(this) ; 

System.out.printlin("Starting " + 
thr2.getName() + "...")3 


thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(this) ; 

System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Enumerate over all the threads in the same 

// ThreadGroup as this thread. 

Thread[] threads = new Thread[Thread.activeCount() ]; 

int numThreads = Thread.enumerate(threads) ; 

for (int i = @; i < numThreads; i++) 

{ 

System.out.println("Found thread " + 

threads[i].getName()); 

} 


// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 

} 


catch (InterruptedException ex) 


{ 
System.out.printlin(ex.toString()); 


} 


// Implements Runnable.run() 
public void run() 


i 
for (int i = @; i < 10@@Q00000; i++) 
{ 
// Just increment a counter. 
counter++; 
} 
System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 
} 
private int counter = @; 
} 
/* 


Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Found thread main 

Found thread Thread-@ 

Found thread Thread-1 

Thread-@ has finished executing. 
Thread-1 has finished executing. 


*/ 


See Also 
Reference 
java.lang.Thread 


Visual J# Reference 


java.lang.Thread.getName() 


Gets the name of the current thread. 


J# 


public final String getName() 


Property Value/Return Value 
The name of the current thread. 
Example 


// thread_getname.jsl 


public class Program implements Runnable 


{ 


public static void main(String[] args) 
if 
Program p = new Program(); 
p.init(); 
} 


public void init() 
{ 
try 
{ 
// Create a second thread and start it. 
Thread thr2 = new Thread(this); 
System.out.printlin("Starting " + 
thr2.getName() + "...")3 
thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(this) ; 

System.out.printlin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Display the number of active threads. This 

// count includes the main thread. 

System.out.println("Active threads = " + 
Thread.activeCount()); 


// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 


catch (InterruptedException ex) 


4 
} 


System.out.printin(ex.toString()); 


} 


// Implements Runnable.run() 
public void run() 


1 
for (int i = @; i < 10@Q@Q0000; i++) 


// Just increment a counter. 
counter++3; 


} 


// Display the name of the thread executing this code. 


System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 


} 


private int counter = @; 


} 


/* 

Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Active threads = 3 

Thread-@ has finished executing. 
Thread-1 has finished executing. 


*/ 











See Also 
Reference 
java.lang.Thread 


Visual J# Reference 


java.lang.Thread.getPriority() 


Gets the priority of the current thread. 


J# 
public final int getPriority() 


Property Value/Return Value 
The priority of the current thread. 
Remarks 


The default priority for a thread is defined by 31¢5b51c-29cd-4f46-a943 -6275f0acf0a2. The maximum priority for a thread is 
defined by 956ddc7b-7eb0-4857-a442-fd0d6d2d88b4. The minimum priority for a thread is defined by 
£8387b47-a01d-4f34-8d67-10e44c6c24e6. 


Example 
// thread_getpriority.jsl 


public class Program implements Runnable 


{ 


public static void main(String[] args) 
{ 
Program p = new Program(); 
p.init(); 


public void init() 
{ 
try 
{ 
// Create a second thread and start it. 
Thread thr2 = new Thread(this) ; 
thr2.setPriority(Thread.MAX_PRIORITY) ; 
System.out.printlin("Starting " + 
thr2.getName() + "...")3 
thr2.start(); 


// Create a third thread and start it. 
Thread thr3 = new Thread(this) ; 
thr3.setPriority(Thread.NORM_PRIORITY + 1); 
System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Display the number of active threads. This 

// count includes the main thread. 

System.out.printlin("Active threads = " + 
Thread.activeCount()); 


// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 

i 


catch (InterruptedException ex) 


{ 
} 


System.out.printin(ex.toString()); 


} 


// Implements Runnable.run() 
public void run() 


{ 


for (int i = @; i < 10@Q@Q0000; i++) 
{ 
// Just increment a counter. 
counter++; 


} 


// Display the name of the thread executing this code. 
System.out.println(Thread.currentThread().getName() + 
" [priority = " + Thread.currentThread().getPriority() + 
"] has finished executing."); 


i 


private int counter = @; 


} 


/* 

Sample Output: 
Starting Thread-@... 
Starting Thread-1... 
Active threads = 3 
Thread-@ [priority 
Thread-1 [priority 
* ff 


10] has finished executing. 
6] has finished executing. 


See Also 
Reference 
java.lang.Thread 


Visual J# Reference 


java.lang.Thread.getThreadGroup() 


Gets the 290ee7 fa-aa87-4288-8644-5b2d5e6a3817 that the current thread belongs to. 


J# 
public final java.lang.ThreadGroup getThreadGroup() 


Property Value/Return Value 
The 290ee7fa-aa87-4288-8644-5b2d5e6a3817 that the current thread belongs to. 
Example 


// thread_getthreadgroup.jsl 


public class Program implements Runnable 


{ 


public static void main(String[] args) 
if 
Program p = new Program(); 
p.init(); 
} 


public void init() 
1 
try 
{ 
// Create a second thread and start it. 
Thread thr2 = new Thread(this) ; 
thr2.setPriority(Thread.MAX_PRIORITY) ; 
System.out.printin("Starting " + 
thr2.getName() + "...")3 
thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(this) ; 

thr3.setPriority(Thread.NORM_PRIORITY + 1); 

System.out.printlin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Display the number of active threads. This 

// count includes the main thread. 

System.out.println("Active threads = " + 
Thread.activeCount()); 


// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 


catch (InterruptedException ex) 


{ 
} 


System.out.printin(ex.toString()); 


} 


// Implements Runnable.run() 
public void run() 
{ 
for (int i = @; i < 10@@Q0000; i++) 
{ 
// Just increment a counter. 
counter++; 


// Display the name of the thread executing this code. 
Thread currThread = Thread.currentThread() ; 
System.out.println(currThread.getName() + 

" [priority = " + currThread.getPriority() + 


"] belongs to ThreadGroup " + 
currThread.getThreadGroup().getName()); 


System.out.println(currThread.getName() + 
"has finished executing."); 


i 


private int counter = @; 


} 


/* 

Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Active threads = 3 

Thread-@ [priority = 10] belongs to ThreadGroup main 
Thread-@ has finished executing. 

Thread-1 [priority = 6] belongs to ThreadGroup main 
Thread-1 has finished executing. 


*/ 


See Also 
Reference 
java.lang.Thread 


Visual J# Reference 


java.lang.Thread.interrupt() 


Interrupts a thread that is in the waiting state. 


J# 





public void interrupt() 





Remarks 


An 5a482700-e124-47f0-b132-a0e034ef746f is thrown when the thread is interrupted. This exception will only be thrown if 
the thread is ever in a waiting state after the interrupt method is called. 


Note 


For Visual J# 2005, the permission sets for this method have changed. Whereas no permission was needed in earlier version 
s, now permission is demanded when calling this method. See SecurityAttribute and SecurityAction for more information. 





Example 
// thread_interrupt.jsl 


public class Program implements Runnable 


{ 
public static void main(String[] args) 
{ 
Program p = new Program(); 
p.init(); 
ii 
public void init() 
{ 
try 
{ 


// Create a second thread and start it. 
Thread thr2 = new Thread(this) ; 
thr2.setPriority(Thread.MAX_PRIORITY) ; 
System.out.printin("Starting " + 
thr2.getName() + "...")3 


thr2.start(); 


// Create a third thread and start it. 
Thread thr3 = new Thread(this) ; 
thr3.setPriority(Thread.NORM_PRIORITY + 1); 
System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 

// Display the number of active threads. This 

// count includes the main thread. 

System.out.println("Active threads = " + 
Thread.activeCount()); 


// Wait for some time for the child threads to start. 
try 


Thread.sleep(5@@) ; 


catch (InterruptedException ex) 


{ 
} 


// Interrupt the two sub-threads. 
thr2.interrupt(); 


// Ignore the exception here. 








thr3.interrupt(); 


// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 


} 
catch (InterruptedException ex) 
{ 
System.out.printin(ex.toString()); 
} 


} 


// Implements Runnable.run() 
public void run() 


si 
try 
{ 
Thread currentThread = Thread.currentThread(); 
System.out.println(currentThread.getName() + 
" [daemon = " + currentThread.isDaemon() + 
", priority = " + currentThread.getPriority() + 
"] is executing."); 
while (true) 
ii 
Thread.sleep(5@@) ; 
} 
} 
catch (InterruptedException ex) 
{ 
Thread currThread = Thread.currentThread() ; 
System.out.println(currThread.getName() + 
"was interrupted: " + ex.toString()); 
} 
} 
private int counter = @; 
} 
/* 


Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Thread-@ [daemon = false, priority = 10] is executing. 

Active threads = 3 

Thread-1 [daemon = false, priority = 6] is executing. 

Thread-1 was interrupted: java.lang.InterruptedException: Thread has been interrupted from 
a waiting state. 

Thread-@ was interrupted: java.lang.InterruptedException: Thread has been interrupted from 
a waiting state. 


*/ 


See Also 
Reference 
java.lang.Thread 


Visual J# Reference 


java.lang.Thread.interrupted() 


Determines if the current thread has been interrupted. 


J# 


public static boolean interrupted() 


Property Value/Return Value 
true if the current thread has been interrupted; false otherwise. 
Example 


// thread_interrupted.jsl 


public class Program implements Runnable 


{ 
public static void main(String[] args) 
if 
Program p = new Program(); 
p.init(); 
} 
public void init() 
{ 
try 
{ 


// Create a second thread and start it. 
Thread thr2 = new Thread(this) ; 
thr2.setPriority(Thread.MAX_PRIORITY) ; 
System.out.printin("Starting " + 
thr2.getName() + "...")3 


thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(this) ; 

thr3.setPriority(Thread.NORM_PRIORITY + 1); 

System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 

// Display the number of active threads. This 

// count includes the main thread. 

System.out.printin("Active threads = " + 
Thread. activeCount()); 


// Wait for some time for the child threads to start. 
try 


Thread.sleep(5@@) ; 


catch (InterruptedException ex) 


4 
} 


// Interrupt the two sub-threads. 
if (!thr2.interrupted()) 


// Ignore the exception here. 


thr2.interrupt(); 
} 


if (!thr3.interrupted()) 
{ 


thr3.interrupt(); 
t 


// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 


} 
catch (InterruptedException ex) 
{ 
System.out.println(ex.toString()); 
} 


} 


// Implements Runnable.run() 
public void run() 


if 
try 
{ 
Thread currentThread = Thread.currentThread() ; 
System.out.println(currentThread.getName() + 
" [daemon = " + currentThread.isDaemon() + 
", priority = " + currentThread.getPriority() + 
"] is executing."); 
while (true) 
{ 
Thread.sleep(5@@) ; 
} 
} 
catch (InterruptedException ex) 
{ 
Thread currThread = Thread.currentThread() ; 
System.out.println(currThread.getName() + 
"was interrupted: " + ex.toString()); 
} 
} 
private int counter = @; 
} 
/* 


Sample Output: 

Starting Thread-@... 

Thread-@ [daemon = false, priority = 10] is executing. 

Starting Thread-1... 

Active threads = 3 

Thread-1 [daemon = false, priority = 6] is executing. 

Thread-@ was interrupted: java.lang.InterruptedException: Thread has been interrupted from 
a waiting state. 

Thread-1 was interrupted: java.lang.InterruptedException: Thread has been interrupted from 
a waiting state. 


*/ 


See Also 
Reference 
java.lang.Thread 


Visual J# Reference 


java.lang.Thread.isAlive() 


Determines if the current thread is alive. 


J# 


public final boolean isAlive() 


Property Value/Return Value 


true if the current thread is alive; false otherwise. 


Example 


// thread_isalive.jsl 


public class Program implements Runnable 


public static void main(String[] args) 


Program p = new Program(); 
p.init(); 


public void init() 


{ 
{ 
} 
{ 
try 
{ 


// Create a second thread and start it. 

Thread thr2 = new Thread(this); 

System.out.printlin("Starting " + 
thr2.getName() + "...")3 


thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(this) ; 

System.out.printlin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Display the number of active threads. This 

// count includes the main thread. 

System.out.println("Active threads = " + 
Thread.activeCount()); 


// Determine which threads are still alive. 
if (thr2.isAlive()) 


of 
System.out.println(thr2.getName() + 
"is alive."); 
} 
else 
{ 
System.out.println(thr2.getName() + 
"is NOT alive."); 
} 
if (thr3.isAlive()) 
{ 
System.out.println(thr3.getName() + 
"is alive."); 
} 
else 
{ 
System.out.println(thr3.getName() + 


"is NOT alive."); 


// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 


// Determine again which threads are still alive. 
if (thr2.isAlive()) 


: System.out.println(thr2.getName() + 
"is alive."); 
i 
else 
{ 
System.out.println(thr2.getName() + 
"is NOT alive."); 
} 
if (thr3.isAlive()) 
: System.out.println(thr3.getName() + 
"is alive."); 
} 
else 
{ 
System.out.println(thr3.getName() + 
"is NOT alive."); 
} 
catch (InterruptedException ex) 
: System.out.printin(ex.toString()); 
} 


} 


// Implements Runnable.run() 
public void run() 


1 
for (int i = @; i < 10@Q@Q0000; i++) 
// Just increment a counter. 
counter++3; 
} 
System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 
} 
private int counter = Q; 
} 
/* 


Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Active threads = 3 

Thread-@ is alive. 

Thread-1 is alive. 

Thread-@ has finished executing. 
Thread-1 has finished executing. 
Thread-@ is NOT alive. 

Thread-1 is NOT alive. 

ty; 


See Also 
Reference 


java.lang.Thread 


Visual J# Reference 


java.lang.Thread.isDaemon() 


Determines if the current thread is a daemon (background) thread. 


J# 


public final boolean isDaemon() 


Property Value/Return Value 


true if the current thread is a daemon thread; false otherwise. 


Example 


// thread_isdaemon.jsl 


public class Program implements Runnable 


public static void main(String[] args) 


Program p = new Program(); 
p.init(); 


public void init() 


// Create a second thread and start it. 

Thread thr2 = new Thread(this); 

System.out.printlin("Starting " + 
thr2.getName() + "...")3 


thr2.start(); 


// Create a third thread as a daemon thread 

// and start it. 

Thread thr3 = new Thread(this); 

thr3.setDaemon(true) ; 

System.out.printin("Starting " + 
thr3.getName() + "...")3 

thr3.start(); 


// Display the number of active threads. This 

// count includes the main thread. 

System.out.println("Active threads = " + 
Thread.activeCount()); 


// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 


catch (InterruptedException ex) 


{ 

{ 

} 

{ 
try 
{ 
{ 
} 

} 


System.out.println(ex.toString()); 


// Implements Runnable.run() 
public void run() 


{ 


Thread currThread = Thread.currentThread() ; 
System.out.println(currThread.getName() + 


is a daemon thread? " + currThread.isDaemon()); 


for (int i = @; i < 10@Q@Q0000; i++) 


// Just increment a counter. 
counter++; 


} 


System.out.println(currThread.getName() + 
"has finished executing."); 


} 


private int counter = @; 


} 


/* 

Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Thread-@ is a daemon thread? false 
Active threads = 3 

Thread-1 is a daemon thread? true 
Thread-@ has finished executing. 
Thread-1 has finished executing. 


my, 


See Also 
Reference 


java.lang.Thread 


Visual J# Reference 


java.lang.Thread.isInterrupted() 


Determines if the current thread has been interrupted. 


J# 


public boolean isInterrupted() 


Property Value/Return Value 
true if the current thread has been interrupted; false otherwise. 
Example 


// thread_isinterrupted.jsl 


public class Program implements Runnable 


{ 
public static void main(String[] args) 
if 
Program p = new Program(); 
p.init(); 
} 
public void init() 
{ 
try 
{ 


// Create a second thread and start it. 
Thread thr2 = new Thread(this) ; 
thr2.setPriority(Thread.MAX_PRIORITY) ; 
System.out.printin("Starting " + 
thr2.getName() + "...")3 


thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(this) ; 

thr3.setPriority(Thread.NORM_PRIORITY + 1); 

System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 

// Display the number of active threads. This 

// count includes the main thread. 

System.out.printin("Active threads = " + 
Thread. activeCount()); 


// Wait for some time for the child threads to start. 
try 


Thread.sleep(5@@) ; 


catch (InterruptedException ex) 


4 
} 


// Interrupt the two sub-threads. 
if (!thr2.isInterrupted()) 


// Ignore the exception here. 


thr2.interrupt(); 
} 


if (!thr3.isInterrupted()) 
{ 


thr3.interrupt(); 
t 


// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 


} 
catch (InterruptedException ex) 
{ 
System.out.println(ex.toString()); 
} 


} 


// Implements Runnable.run() 
public void run() 


if 
try 
{ 
Thread currentThread = Thread.currentThread() ; 
System.out.println(currentThread.getName() + 
" [daemon = " + currentThread.isDaemon() + 
", priority = " + currentThread.getPriority() + 
"] is executing."); 
while (true) 
{ 
Thread.sleep(5@@) ; 
} 
} 
catch (InterruptedException ex) 
{ 
Thread currThread = Thread.currentThread() ; 
System.out.println(currThread.getName() + 
"was interrupted: " + ex.toString()); 
} 
} 
private int counter = @; 
} 
/* 


Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Thread-@ [daemon = false, priority = 10] is executing. 

Active threads = 3 

Thread-1 [daemon = false, priority = 6] is executing. 

Thread-1 was interrupted: java.lang.InterruptedException: Thread has been interrupted from 
a waiting state. 

Thread-@ was interrupted: java.lang.InterruptedException: Thread has been interrupted from 
a waiting state. 


*/ 


See Also 
Reference 
java.lang.Thread 


Visual J# Reference 


java.lang.Thread.join(long millis, int nanos) 


Blocks the calling thread until a secondary thread completes execution or until the specified time has elapsed. 


J# 


public final void join(long millis, int nanos) 














Parameters 

Parameter Description 

millis The number of milliseconds to wait until forcing a join. 

nanos The additional number of nanoseconds to wait until forcing a join. 
Example 





// thread_join1.jsl 


public class Program implements Runnable 


{ 


public static void main(String[] args) 
sf 
Program p = new Program(); 
p.init(); 


public void init() 
{ 
try 
{ 
// Create a second thread and start it. 
Thread thr2 = new Thread(this) ; 
System.out.printin("Starting " + 
thr2.getName() + "...")3 
thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(this) ; 

System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Display the number of active threads. This 

// count includes the main thread. 

System.out.printlin("Active threads = " + 
Thread.activeCount()); 


// Block until the other threads finish or for 

// 100 ms, whichever comes first. 

thr2.join(100, 0); 

System.out.println("No longer blocking on thread " + 
thr2.getName() ); 


thr3.join(100, 0); 
System.out.println("No longer blocking on thread " + 


thr3.getName()); 


catch (InterruptedException ex) 


{ 
} 


System.out.println(ex.toString()); 


// Implements Runnable.run() 
public void run() 
{ 
Thread currThread = Thread.currentThread() ; 
for (int i = 0; i < 10@Q@Q0000; i++) 
{ 
// Just increment a counter. 
counter++; 


} 


System.out.println(currThread.getName() + 
"has finished executing."); 


} 


private int counter = @; 


} 


/* 

Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Active threads = 3 

Thread-@ has finished executing. 

No longer blocking on thread Thread-@ 
Thread-1 has finished executing. 

No longer blocking on thread Thread-1 
+f 


See Also 
Reference 
java.lang.Thread 


Visual J# Reference 


java.lang.Thread.join(long millis) 


Blocks the calling thread until a secondary thread completes execution or until the specified time has elapsed. 


J# 


public final void join(long millis) 


Parameters 





mills The number of milliseconds to wait until forcing a join. 


Example 


// thread_join2.jsl 


public class Program implements Runnable 


{ 


public static void main(String[] args) 
{ 
Program p = new Program(); 
p.init(); 


public void init() 
{ 
try 
{ 
// Create a second thread and start it. 
Thread thr2 = new Thread(this) ; 
System.out.printin("Starting " + 
thr2.getName() + "...")3 
thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(this) ; 

System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Display the number of active threads. This 

// count includes the main thread. 

System.out.printin("Active threads = " + 
Thread.activeCount()); 


// Block until the other threads finish or for 

// 100 ms, whichever comes first. 

thr2.join(100); 

System.out.printin("No longer blocking on thread " + 
thr2.getName() ); 


thr3.join(100); 
System.out.println("No longer blocking on thread " + 


thr3.getName()); 


catch (InterruptedException ex) 


d 
} 


System.out.printin(ex.toString()); 


} 


// Implements Runnable.run() 
public void run() 


{ 


Thread currThread = Thread.currentThread() ; 
for (int i = @; i < 10@@QQ000; i++) 
{ 

// Just increment a counter. 

counter++; 


} 


System.out.println(currThread.getName() + 
"has finished executing."); 


i 


private int counter = @; 


i 


/* 

Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Active threads = 3 

No longer blocking on thread Thread-@ 
Thread-@ has finished executing. 
Thread-1 has finished executing. 

No longer blocking on thread Thread-1 
*/ 


See Also 
Reference 
java.lang.Thread 


Visual J# Reference 


java.lang.Thread.join() 


Blocks the calling thread until a secondary thread completes execution. 


J# 
public final void join() 


Example 


// thread_join3.jsl 


public class Program implements Runnable 


{ 


public static void main(String[] args) 
{ 
Program p = new Program(); 
p.init(); 
} 


public void init() 
{ 
try 
if 
// Create a second thread and start it. 
Thread thr2 = new Thread(this) ; 
System.out.printin("Starting " + 
thr2.getName() + "...")3 
thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(this) ; 

System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Display the number of active threads. This 

// count includes the main thread. 

System.out.println("Active threads = " + 
Thread. activeCount()); 


// Block until the other threads finish. 

thr2.join(); 

System.out.println("No longer blocking on thread " + 
thr2.getName()); 


thr3.join(); 
System.out.println("No longer blocking on thread " + 
thr3.getName()); 


catch (InterruptedException ex) 


{ 
} 


System.out.println(ex.toString()); 


} 


// Implements Runnable.run() 

public void run() 

{ 
Thread currThread = Thread.currentThread() ; 
for (int i = @; i < 10@Q@Q0000; i++) 


// Just increment a counter. 
counter++3; 


System.out.println(currThread.getName() + 
"has finished executing."); 


} 


private int counter = @; 


} 


/* 

Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Active threads = 3 

Thread-@ has finished executing. 
Thread-1 has finished executing. 

No longer blocking on thread Thread-@ 
No longer blocking on thread Thread-1 
a) 





See Also 
Reference 
java.lang.Thread 





Visual J# Reference 


java.lang.Thread.resume() 


Resumes execution of a thread that has been suspended. 


J# 
public final void resume() 


Remarks 


Note For Visual J# 2005, the permission sets for this method have changed. Whereas no permission was needed in earlier 
versions, now permission is demanded when calling this method. See SecurityAttribute and SecurityAction for more 
information. 


Example 


// thread_resume.jsl 


public class Program implements Runnable 


{ 


public static void main(String[] args) 
{ 
Program p = new Program(); 
p.init(); 


public void init() 
{ 
try 
{ 
// Create a second thread and start it. 
Thread thr2 = new Thread(this); 
System.out.printin("Starting " + 
thr2.getName() + "...")3 
thr2.start(); 


// Suspend the secondary thread. 
System.out.println("Suspending " + 
thr2.getName() + "...")3 


thr2.suspend(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(this) ; 

System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Display the number of active threads. This 

// count includes the main thread. 

System.out.println("Active threads = " + 
Thread.activeCount()); 


// Block until the other threads finish or until 
// the secondary thread executes for 1000 ms. 
thr2.join(100@0) ; 

thr3.join(); 


// Resume the secondary thread. 
System.out.println("Resuming " + thr2.getName()); 


thr2.resume(); 


catch (InterruptedException ex) 


{ 
} 


System.out.printin(ex.toString()); 


} 


// Implements Runnable.run() 
public void run() 


{ 
for (int i = @; i < 10@Q@Q00000; i++) 
{ 
// Just increment a counter. 
counter++; 
} 
System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 
} 
private int counter = @; 
} 
/* 


Sample Output: 

Starting Thread-@... 

Suspending Thread-@... 

Starting Thread-1... 

Active threads = 3 

Thread-1 has finished executing. 
Resuming Thread-@ 


uy 


See Also 
Reference 
java.lang.Thread 


Visual J# Reference 


java.lang.Thread.run() 


Runs a thread in its entirety. The calling thread is blocked until the called thread completes execution. 


J# 
public void run() 


Example 


// thread_run.jsl 


public class Program implements Runnable 


{ 
public static void main(String[] args) 
{ 
Program p = new Program(); 
p.init(); 
} 
public void init() 
{ 
// Create a second thread and run it. 
Thread thr2 = new Thread(this) ; 
System.out.println("Running " + 
thr2.getName() + "...")3 
thr2.run(); 
// Create a third thread and run it. 
Thread thr3 = new Thread(this) ; 
System.out.println("Running " + 
thr3.getName() + "...")3 
thr3.run(); 
// Display the number of active threads. This 
// count includes the main thread. 
System.out.printlin("Active threads after run = " + 
Thread. activeCount()); 
} 
// Implements Runnable.run() 
public void run() 
{ 
for (int i = @; i < 10@Q@Q0000; i++) 
// Just increment a counter. 
counter++3; 
} 
System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 
} 
private int counter = @; 
} 
/* 


Sample Output: 

Running Thread-@... 

main has finished executing. 
Running Thread-1... 

main has finished executing. 
Active threads after run = 1 


a 


See Also 
Reference 
java.lang.Thread 


Visual J# Reference 


java.lang.Thread.setDaemon(boolean daemonFlag) 


Sets a value indicating that the current thread is a daemon (background) thread. 


J# 


public final void setDaemon(boolean daemonFlag) 


Parameters 





daemonFlag true to make the current thread a daemon thread; false otherwise. 


Example 


// thread_setdaemon.jsl 


public class Program implements Runnable 
{ 
public static void main(String[] args) 
{ 
Program p = new Program(); 
p.init(); 


public void init() 
{ 
try 
{ 
// Create a second thread and start it. 
Thread thr2 = new Thread(this) ; 
System.out.printin("Starting " + 
thr2.getName() + "...")3 
thr2.start(); 


// Create a third thread as a daemon thread 

// and start it. 

Thread thr3 = new Thread(this) ; 

thr3.setDaemon(true) ; 

System.out.printin("Starting " + 
thr3.getName() + "...")3 

thr3.start(); 


// Display the number of active threads. This 

// count includes the main thread. 

System.out.printlin("Active threads = " + 
Thread.activeCount()); 


// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 


catch (InterruptedException ex) 


{ 
} 


System.out.printin(ex.toString()); 


} 


// Implements Runnable.run() 
public void run() 
1 
Thread currThread = Thread.currentThread() ; 
System.out.println(currThread.getName() + 
"is a daemon thread? " + currThread.isDaemon() ); 


for (int i = @; i < 10@Q@Q0000; i++) 
{ 
// Just increment a counter. 
counter++; 


} 


System.out.println(currThread.getName() + 
"has finished executing."); 


} 


private int counter = @; 


/* 

Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Thread-@ is a daemon thread? false 
Active threads = 3 

Thread-1 is a daemon thread? true 
Thread-@ has finished executing. 
Thread-1 has finished executing. 


*/ 


See Also 
Reference 
java.lang.Thread 


Visual J# Reference 


java.lang.Thread.setName(String name) 


Sets the name of the current thread. 


J# 


public final void setName(String name) 


Parameters 





mame Th name for the current thread. 


Example 


// thread_setname.jsl 


public class Program implements Runnable 
{ 
public static void main(String[] args) 
{ 
Program p = new Program(); 
p.init(); 


public void init() 
{ 
try 
{ 
// Create a second thread and start it. 
Thread thr2 = new Thread(this) ; 
thr2.setName("Thread 2"); 
System.out.printin("Starting " + 
thr2.getName() + "...")3 
thr2.start(); 


// Create a third thread and start it. 
Thread thr3 = new Thread(this) ; 
thr3.setName("Thread 3"); 
System.out.printin("Starting " + 

thr3.getName() + "...")3 
thr3.start(); 


// Display the number of active threads. This 

// count includes the main thread. 

System.out.printlin("Active threads = " + 
Thread.activeCount()); 


// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 


catch (InterruptedException ex) 


{ 
} 


System.out.printin(ex.toString()); 


} 


// Implements Runnable.run() 
public void run() 


1 
for (int i = @; i < 10@Q@00000; i++) 


// Just increment a counter. 
counter++; 


} 


// Display the name of the thread executing this code. 
System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 


} 


private int counter = @; 


} 


/* 

Sample Output: 

Starting Thread 2... 

Starting Thread 3... 

Active threads = 3 

Thread 2 has finished executing. 
Thread 3 has finished executing. 
aA 





See Also 
Reference 
java.lang.Thread 





Visual J# Reference 


java.lang.Thread.setPriority(int priority) 


Sets the priority of the current thread. 
J# 


public final void setPriority(int priority) 














Parameters 

Parameter Description 

priority A value indicating the priority for the current thread. 
Remarks 


The default priority for a thread is defined by 31¢5b51c-29cd-4f46-a943-6275fOacf0a2. The maximum priority for a thread is 
defined by 956ddc7b-7eb0-4857-a442-fd0d6d2d88b4. The minimum priority for a thread is defined by 
f8387b47-a01d-4f34-8d67-10e44c6c24e6. 


Example a 


// thread_setpriority.jsl 
public class Program implements Runnable 
public static void main(String[] args) 
{ 
Program p = new Program(); 
p.init(); 
} 
public void init() 
{ 
try 
{ 
// Create a second thread and start it. 
Thread thr2 = new Thread(this) ; 
thr2.setPriority(Thread.MAX_PRIORITY) ; 
System.out.printin("Starting " + 
thr2.getName() + "...")3 
thr2.start(); 
// Create a third thread and start it. 
Thread thr3 = new Thread(this) ; 
thr3.setPriority(Thread.NORM_PRIORITY + 1); 
System.out.printin("Starting " + 
thr3.getName() + "...")3 
thr3.start(); 
// Display the number of active threads. This 
// count includes the main thread. 
System.out.println("Active threads = " + 
Thread. activeCount()); 
// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 
catch (InterruptedException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
// Implements Runnable.run() 








public void run() 


{ 
for (int i = @; i < 10@@Q0000; i++) 
{ 
// Just increment a counter. 
counter++3; 
} 
// Display the name of the thread executing this code. 
System.out.println(Thread.currentThread().getName() + 
" [priority = " + Thread.currentThread().getPriority() + 
"] has finished executing."); 
} 
private int counter = @; 
} 
/* 


Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Active threads = 3 

Thread-@ [priority = 10] has finished executing. 
Thread-1 [priority = 6] has finished executing. 
*/ 


See Also 
Reference 
java.lang.Thread 


Visual J# Reference 


java.lang.Thread.sleep(long millis, int nanos) 


Pauses execution of the current thread for the specified time 


J# 


public static void sleep(long millis, int nanos) 














Parameters 

Parameter Description 

millis The number of milliseconds to sleep. 

nanos The additional number of nanoseconds to sleep. 
Example 





// thread_sleep1.jsl 


public class Program implements Runnable 


{ 


public static void main(String[] args) 


{ 


Program p = new Program(); 
p.init(); 


public void init() 


{ 
try 
{ 
// Create a second thread and start it. 
Thread thr2 = new Thread(this) ; 
System.out.printin("Starting " + 
thr2.getName() + "...")3 
thr2.start(); 
// Sleep for 5 seconds (50@@ milliseconds 
// and ® nanosecondss). 
Thread.sleep(5000, @); 
// Create a third thread and start it. 
Thread thr3 = new Thread(this) ; 
System.out.printin("Starting " + 
thr3.getName() + "...")3 
thr3.start(); 
// Display the number of active threads. This 
// count includes the main thread. 
System.out.println("Active threads = " + 
Thread.activeCount()); 
// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 
catch (InterruptedException ex) 
{ 
System. out.println(ex.toString()); 
} 
} 


// Implements Runnable.run() 
public void run() 


for (int i = @; i < 10@Q@Q0000; i++) 
{ 
// Just increment a counter. 
counter++; 


} 


System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 


i 


private int counter = @; 


i 


/* 

Sample Output: 

Starting Thread-@... 

Thread-@ has finished executing. 
Starting Thread-1... 

Active threads = 2 

Thread-1 has finished executing. 
*/ 


See Also 
Reference 
java.lang.Thread 


Visual J# Reference 


java.lang.Thread.sleep(long millis) 


Pauses execution of the current thread for the specified time 


J# 


public static void sleep(long millis) 


Parameters 





mis Th number of milliseconds to sleep. 


Example 


// thread_sleep2.jsl 


public class Program implements Runnable 


{ 


public static void main(String[] args) 


{ 


Program p = new Program(); 
p.init(); 


public void init() 


{ 
try 
{ 
// Create a second thread and start it. 
Thread thr2 = new Thread(this) ; 
System.out.printin("Starting " + 
thr2.getName() + "...")3 
thr2.start(); 
// Sleep for 5 seconds (50@@ milliseconds). 
Thread.sleep(50e@) ; 
// Create a third thread and start it. 
Thread thr3 = new Thread(this) ; 
System.out.printin("Starting " + 
thr3.getName() + "...")3 
thr3.start(); 
// Display the number of active threads. This 
// count includes the main thread. 
System.out.printin("Active threads = " + 
Thread.activeCount()); 
// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 
catch (InterruptedException ex) 
{ 
System. out.println(ex.toString()); 
} 
} 


// Implements Runnable.run() 
public void run() 


{ 
for (int i = 0; i < 10@Q@Q0Q000; i++) 


// Just increment a counter. 


counter++; 


} 


System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 


} 


private int counter = @; 


} 


/* 

Sample Output: 

Starting Thread-@... 

Thread-@ has finished executing. 
Starting Thread-1... 

Active threads = 2 

Thread-1 has finished executing. 


*f 





See Also 
Reference 
java.lang.Thread 





Visual J# Reference 


java.lang.Thread.start() 


Starts execution of a thread in the background. Control is immediately returned to the calling thread. 


J# 


public void start() 


Example 


// thread_start.jsl 


public class Program implements Runnable 
{ 
public static void main(String[] args) 
{ 
Program p = new Program(); 
p.init(); 
} 


public void init() 
{ 
try 
if 
// Create a second thread and start it. 
Thread thr2 = new Thread(this) ; 
System.out.printin("Starting " + 
thr2.getName() + "...")3 
thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(this) ; 

System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Display the number of active threads. This 

// count includes the main thread. 

System.out.println("Active threads = " + 
Thread. activeCount()); 


// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 


catch (InterruptedException ex) 


i 
} 


System.out.println(ex.toString()); 


} 


// Implements Runnable.run() 
public void run() 


{ 
for (int i = @; i < 10@Q@Q0000; i++) 
{ 
// Just increment a counter. 
counter++; 
} 
System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 
} 


private int counter = @; 


} 


/* 

Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Active threads = 3 

Thread-@ has finished executing. 
Thread-1 has finished executing. 
*/ 





See Also 
Reference 
java.lang.Thread 





Visual J# Reference 


java.lang.Thread.stop(java.lang. Throwable e) 


Stops execution of a thread. The given exception is passed to the thread before it is terminated. 


jf 
public final void stop(java.lang.Throwable e) 


Parameters 





© he exception to send to the thread before it is terminated. 


Remarks 


Note For Visual J# 2005, the permission sets for this method have changed. Whereas no permission was needed in earlier 
versions, now permission is demanded when calling this method. See SecurityAttribute and SecurityAction for more 
information. 


Example _ 


// thread_stop1.jsl 
public class Program implements Runnable 


public static void main(String[] args) 
{ 
Program p = new Program(); 
p.init(); 
} 


public void init() 
{ 
// Create a second thread and start it. 
Thread thr2 = new Thread(this) ; 
System.out.printin("Starting " + 
thr2.getName() + "...")3 


thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(this) ; 

System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Display the number of active threads. This 

// count includes the main thread. 

System.out.printlin("Active threads = " + 
Thread.activeCount()); 


// The threads are taking a long time. 
thr2.stop(new InterruptedException("Speed it up!")); 
System.out.println(thr2.getName() + 

"has been manually stopped."); 


thr3.stop(new InterruptedException("Speed it up!")); 
System.out.printin(thr3.getName() + 
"has been manually stopped."); 


} 


// Implements Runnable.run() 
public void run() 


t 
try 


{ 


for (int i = @; i < Integer.MAX_VALUE; i++) 
{ 

// Just increment a counter. 

counter++; 


} 


System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 


} 
catch (Exception ex) 
{ 
System.out.println(Thread.currentThread().getName() + 
"received an exception: " + 
ex.toString()); 
} 
} 
private int counter = Q; 
} 
/* 


Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Active threads = 3 

Thread-@ has been manually stopped. 

Thread-@ received an exception: java.lang.InterruptedException: Speed it up! 
Thread-1 received an exception: java.lang.InterruptedException: Speed it up! 
Thread-1 has been manually stopped. 

ad 


See Also 
Reference 


java.lang.Thread 


Visual J# Reference 


java.lang.Thread.stop() 


Stops execution of a thread. 


J# 
public final void stop() 


Remarks 


Note For Visual J# 2005, the permission sets for this method have changed. Whereas no permission was needed in earlier 
versions, now permission is demanded when calling this method. See SecurityAttribute and SecurityAction for more 
information. 


Example 


// thread_stop2.jsl 


public class Program implements Runnable 


{ 


public static void main(String[] args) 
{ 
Program p = new Program(); 
p.init(); 


public void init() 
{ 
// Create a second thread and start it. 
Thread thr2 = new Thread(this) ; 
System.out.printin("Starting " + 
thr2.getName() + "...")3 


thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(this) ; 

System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Display the number of active threads. This 

// count includes the main thread. 

System.out.printin("Active threads = " + 
Thread.activeCount()); 


// The threads are taking a long time. 

thr2.stop(); 

System.out.println(thr2.getName() + 
"has been manually stopped."); 


thr3.stop(); 
System.out.println(thr3.getName() + 
"has been manually stopped."); 


} 


// Implements Runnable.run() 
public void run() 


‘ 
for (int i = @; i < Integer.MAX_VALUE; i++) 
{ 
// Just increment a counter. 
counter++; 
} 


System.out.println(Thread.currentThread().getName() + 


"has finished executing."); 


} 


private int counter = @; 


} 


/* 

Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Active threads = 3 

Thread-@ has been manually stopped. 
Thread-1 has been manually stopped. 
*/ 





See Also 
Reference 
java.lang.Thread 





Visual J# Reference 


java.lang.Thread.suspend() 


Suspends execution of a thread until resume is called. 


J# 


public final void suspend() 


Remarks 


Note For Visual J# 2005, the permission sets for this method have changed. Whereas no permission was needed in earlier 
versions, now permission is demanded when calling this method. See SecurityAttribute and SecurityAction for more 
information. 


Example 


// thread_suspend.jsl 


public class Program implements Runnable 


{ 


public static void main(String[] args) 
{ 
Program p = new Program(); 
p.init(); 


public void init() 
{ 
try 
{ 
// Create a second thread and start it. 
Thread thr2 = new Thread(this); 
System.out.printin("Starting " + 
thr2.getName() + "...")3 
thr2.start(); 


// Suspend the secondary thread. 
System.out.println("Suspending " + 
thr2.getName() + "...")3 


thr2.suspend(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(this) ; 

System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Display the number of active threads. This 

// count includes the main thread. 

System.out.println("Active threads = " + 
Thread.activeCount()); 


// Block until the other threads finish or until 
// the secondary thread executes for 5000 ms. 
thr2.join(50e@6) ; 

thr3.join(); 


// Resume the secondary thread. 
System.out.println("Resuming " + thr2.getName()); 


thr2.resume(); 


catch (InterruptedException ex) 


{ 
} 


System.out.printin(ex.toString()); 


} 


// Implements Runnable.run() 
public void run() 


{ 
for (int i = @; i < 10@Q@Q00000; i++) 
{ 
// Just increment a counter. 
counter++; 
} 
System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 
} 
private int counter = @; 
} 
/* 


Sample Output: 

Starting Thread-@... 

Suspending Thread-@... 

Starting Thread-1... 

Active threads = 3 

Thread-1 has finished executing. 
Resuming Thread-@ 


uy 


See Also 
Reference 
java.lang.Thread 


Visual J# Reference 


java.lang.Thread.yield() 


Yields execution control to another thread. 


J# 
public static void yield() 


Example 


// thread_yield.jsl 


public class Program implements Runnable 


{ 


public static void main(String[] args) 
{ 
Program p = new Program(); 
p.init(); 
} 


public void init() 
{ 
try 
if 
// Create a second thread and start it. 
Thread thr2 = new Thread(this) ; 
System.out.printin("Starting " + 
thr2.getName() + "...")3 
thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(this) ; 

System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Display the number of active threads. This 

// count includes the main thread. 

System.out.println("Active threads = " + 
Thread. activeCount()); 


// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 


catch (InterruptedException ex) 


i 
} 


System.out.println(ex.toString()); 


} 


// Implements Runnable.run() 
public void run() 
{ 
for (int i = 0; i < 10000000; i++) 
{ 
// Yield control to another thread every 
// 1000000 iterations. 
if ((i % 1000000) == @) 


{ 
System.out.println(Thread.currentThread().getName() + 
"is yielding control..."); 
Thread. currentThread().yield(); 
} 


System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 


} 


private int counter = @; 


} 


/* 

Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Thread-@ is yielding control... 
Active threads = 3 

Thread-1 is yielding control... 
Thread-@ is yielding control... 
Thread-1 is yielding control... 
Thread-@ is yielding control... 
Thread-1 is yielding control... 
Thread-@ is yielding control... 
Thread-1 is yielding control... 
Thread-@ is yielding control... 
Thread-1 is yielding control... 
Thread-@ is yielding control... 
Thread-1 is yielding control... 
Thread-1 is yielding control... 
Thread-@ is yielding control... 
Thread-1 is yielding control... 
Thread-@ is yielding control... 
Thread-1 is yielding control... 
Thread-@ is yielding control... 
Thread-1 is yielding control... 
Thread-@ is yielding control... 
Thread-1 has finished executing. 
Thread-@ has finished executing. 


*/ 


See Also 
Reference 
java.lang.Thread 


Visual J# Reference 


java.lang.Thread.MAX_PRIORITY 


A constant representing the maximum priority that can be assigned to a thread. 


J# 


public static final int MAX_PRIORITY 


See Also 
Reference 


java.lang.Thread 


Visual J# Reference 


java.lang.Thread.MIN_PRIORITY 


A constant representing the minimum priority that can be assigned to a thread. 


J# 


public static final int MIN PRIORITY 


See Also 
Reference 


java.lang.Thread 


Visual J# Reference 


java.lang.Thread.NORM_PRIORITY 


A constant representing the normal priority that is assigned to newly created threads if a priority is not manually set. 


J# 


public static final int NORM_PRIORITY 


See Also 
Reference 


java.lang.Thread 


Visual J# Reference 


java.lang.ThreadGroup 


Represents a group of threads that share common traits. 


J# 


public class ThreadGroup 


Example 


// threadgroup_overview.jsl 


public class Program implements Runnable 


public static void main(String[] args) 


Program p = new Program(); 
p.init(); 


public void init() 


{ 
{ 
} 
{ 
try 
{ 


// Create a new ThreadGroup and a child for that 
// new ThreadGroup. 
ThreadGroup parentGroup = 

new ThreadGroup("Parent ThreadGroup" ); 
parentGroup.setDaemon(false) ; 
parentGroup.setMaxPriority(Thread.MAX_PRIORITY - 2); 


ThreadGroup childGroup = 

new ThreadGroup(parentGroup, "Child ThreadGroup") ; 
childGroup.setDaemon(true) ; 
childGroup.setMaxPriority(Thread.NORM_PRIORITY) ; 


// Create a second thread and start it. 

Thread thr2 = new Thread(parentGroup, this); 

System.out.printlin("Starting " + 
thr2.getName() + "...")3 


thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(childGroup, this); 

System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Enumerate over all the child groups of parentGroup. 
ThreadGroup[] groups = 

new ThreadGroup[parentGroup.activeGroupCount() ]; 
int numGroups = parentGroup.enumerate(groups, true); 
for (int i = @; i < numGroups; i++) 


x 
System.out.println("Found ThreadGroup " + 

groups[i].getName() + 
" [Max Priority = " + 
groups[i].getMaxPriority() + 
", Parent = " + 
groups[i].getParent().getName() + 
", Is Daemon = " + 
groups[i].isDaemon() + "]"); 

} 


// Block until the other threads finish. 


thr2.join(); 
thr3.join(); 


} 
catch (InterruptedException ex) 
{ 
System.out.println(ex.toString()); 
} 


} 


// Implements Runnable.run() 
public void run() 


si 
for (int i = @; i < 10@@Q0000; i++) 
// Just increment a counter. 
counter++; 
} 
System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 
} 
private int counter = @; 
} 
/* 


Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Found ThreadGroup Child ThreadGroup 
Thread-@ has finished executing. 
Thread-1 has finished executing. 


sir 


See Also 
Concepts 
Visual J# Class Library 


Visual J# Reference 


java.lang.ThreadGroup.ThreadGroup(ThreadGroup parent, 
String name) 


Initializes a new instance of a named ThreadGroup object with the given parent. 




















J# 
public ThreadGroup(java.lang.ThreadGroup parent, String name) 
Parameters 
Parameter Description 
parent The parent java.lang.ThreadGroup object for this ThreadGroup. 
name The name for the ThreadGroup. 
See Also 
Reference 


java.lang.ThreadGroup 





Visual J# Reference 


java.lang.ThreadGroup.ThreadGroup(String name) 


Initializes a new instance of a named 290ee7fa-aa87 -4288-8644-5b2d5e6a3817 object. 
J# 


public ThreadGroup(String name) 











Parameters 

Parameter Description 

name The name for the ThreadGroup. 
See Also 

Reference 


java.lang.ThreadGroup 





Visual J# Reference 


java.lang. ThreadGroup. ThreadGroup() 


Initializes a new instance of a 290ee7fa-aa87-4288-8644-5b2d5e6a3817 object. 


J# 
public ThreadGroup() 


See Also 
Reference 
java.lang.ThreadGroup 


Visual J# Reference 


java.lang.ThreadGroup.activeCount() 


Gets the number of active threads in this 290ee7fa-aa87-4288-8644-5b2d5e6a3817 and all child 290ee7fa-aa87-4288- 
8644-5b2d5e6a3817 objects. 


J# 
public int activeCount() 


Property Value/Return Value 


The number of active threads in this 290ee7fa-aa87-4288-8644-5b2d5e6a3817 and all child 290ee7fa-aa87-4288-8644- 
5b2d5e6a3817 objects. 


Example 


// threadgroup_activecount.jsl 


public class Program implements Runnable 


{ 


public static void main(String[] args) 
{ 
Program p = new Program(); 
p.init(); 


public void init() 
{ 
try 
{ 
// Create a new ThreadGroup and a child for that 
// new ThreadGroup. 
ThreadGroup parentGroup = 
new ThreadGroup("Parent ThreadGroup") ; 
ThreadGroup childGroup = 
new ThreadGroup(parentGroup, "Child ThreadGroup") ; 


// Create a second thread and start it. 

Thread thr2 = new Thread(parentGroup, this); 

System.out.printin("Starting " + 
thr2.getName() + "...")3 


thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(childGroup, this); 

System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Display the number of active threads in the 
// new ThreadGroup. 
System.out.println("Active threads in group \"" + 


parentGroup.getName() + "\"= "+ 
parentGroup.activeCount()); 


// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 


} 
catch (InterruptedException ex) 
{ 
System.out.println(ex.toString()); 
} 


// Implements Runnable.run() 
public void run() 


{ 
for (int i = @; i < 10@Q@00000; i++) 
{ 
// Just increment a counter. 
counter++3; 
} 
System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 
} 
private int counter = Q; 
} 
/* 


Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Active threads in group "Parent ThreadGroup" = 2 
Thread-@ has finished executing. 

Thread-1 has finished executing. 


*/ 


See Also 
Reference 


java.lang.ThreadGroup 


Visual J# Reference 


java.lang. ThreadGroup.activeGroupCount() 


Gets the number of active groups that are children of this 290ee7fa-aa87-4288-8644-5b2d5e6a3817 


J# 
public int activeGroupCount() 


Property Value/Return Value 
The number of active groups that are children of this 290ee7fa-aa87-4288-8644-5b2d5e6a3817. 
Example 


// threadgroup_activegroupcount.jsl 


public class Program implements Runnable 


{ 


public static void main(String[] args) 
if 
Program p = new Program(); 
p.init(); 
} 


public void init() 
1 
try 
{ 
// Create a new ThreadGroup and a child for that 
// new ThreadGroup. 
ThreadGroup parentGroup = 
new ThreadGroup("Parent ThreadGroup" ) ; 
ThreadGroup childGroup = 
new ThreadGroup(parentGroup, "Child ThreadGroup") ; 


// Create a second thread and start it. 

Thread thr2 = new Thread(parentGroup, this); 

System.out.printin("Starting " + 
thr2.getName() + "...")3 


thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(childGroup, this); 

System.out.printlin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Display the number of active threads in the 

// new ThreadGroup. 

System.out.println("Active group threads (child " + 
"groups) of group \"" + 
parentGroup.getName() + "\" = "+ 
parentGroup.activeGroupCount()); 


// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 


catch (InterruptedException ex) 


{ 
} 


System.out.println(ex.toString()); 


: 


// Implements Runnable.run() 


public void run() 


{ 
for (int i = @; i < 10@@Q00000; i++) 
{ 
// Just increment a counter. 
counter++; 
} 
System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 
} 
private int counter = @; 
} 
/* 


Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Active group threads (child groups) of group "Parent ThreadGroup" = 1 
Thread-@ has finished executing. 

Thread-1 has finished executing. 


*/ 


See Also 
Reference 
java.lang.ThreadGroup 


Visual J# Reference 


java.lang. ThreadGroup.allowThreadSuspension(boolean allow) 


This method is not supported by J#. 


J# 





public boolean allowThreadSuspension(boolean allow) 





Property Value/Return Value 


This method is not supported by J#. 





Note 





: Ajava.lang.MethodNotSupportedException is thrown if this method is called. 








See Also 
Reference 
java.lang.ThreadGroup 


Visual J# Reference 


java.lang. ThreadGroup.checkAccess() 


Determines whether a 290ee7fa-aa87-4288-8644-5b2d5e6a3817 has permission to access a resource. 
J# 


public final void checkAccess() 


Remarks 


A 7dcba491 -f8.ac-4c05-b593-95c5a8ecda18 is thrown if the 290ee7fa-aa87-4288-8644-5b2d5e6a3817 does not have 
permission to access a resource. 


Example 


// threadgroup_checkaccess.jsl 


public class Program implements Runnable 


{ 
public static void main(String[] args) 
{ 
Program p = new Program(); 
p.init(); 
} 
public void init() 
{ 
try 
{ 


// Create a new ThreadGroup and a child for that 
// new ThreadGroup. 
ThreadGroup parentGroup = 
new ThreadGroup("Parent ThreadGroup" ) ; 
ThreadGroup childGroup = 
new ThreadGroup(parentGroup, "Child ThreadGroup") ; 


// Create a second thread and start it. 

Thread thr2 = new Thread(parentGroup, this); 

System.out.printin("Starting " + 
thr2.getName() + "...")3 


thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(childGroup, this); 

System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Check the access for these ThreadGroups. 


try 
1 
parentGroup.checkAccess(); 
System.out.println(parentGroup.getName() + 
"has access."); 
childGroup.checkAccess(); 
System.out.println(childGroup.getName() + 
"has access."); 
} 
catch (SecurityException ex) 
1 
System.out.println("Thread doesn't have access: " + 
ex. toString()); 
} 


// Block until the other threads finish. 


thr2.join(); 
thr3.join(); 


} 
catch (InterruptedException ex) 
{ 
System.out.println(ex.toString()); 
} 


} 


// Implements Runnable.run() 
public void run() 


si 
for (int i = @; i < 10@@Q0000; i++) 
// Just increment a counter. 
counter++; 
} 
System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 
} 
private int counter = @; 
} 
/* 


Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Parent ThreadGroup has access. 
Child ThreadGroup has access. 
Thread-1 has finished executing. 
Thread-@ has finished executing. 


*/ 


See Also 
Reference 
java.lang.ThreadGroup 


Visual J# Reference 


java.lang.ThreadGroup.destroy() 


Destroys this 290ee7fa-aa87-4288-8644-5b2d5e6a3817 
J# 


public final void destroy() 


Remarks 


An fab94e73-821e-4c9e-8a69-b54cdecd1a3e will be thrown if there are no active threads in the 290ee7fa-aa87-4288-8644- 
5b2d5e6a3817. 


Example 


// threadgroup_destroy.jsl 


public class Program implements Runnable 


{ 
public static void main(String[] args) 
{ 
Program p = new Program(); 
p.init(); 
} 
public void init() 
{ 
try 
{ 


// Create a new ThreadGroup and a child for that 
// new ThreadGroup. 
ThreadGroup parentGroup = 
new ThreadGroup("Parent ThreadGroup" ) ; 
ThreadGroup childGroup = 
new ThreadGroup(parentGroup, "Child ThreadGroup") ; 


// Create a second thread and start it. 

Thread thr2 = new Thread(parentGroup, this); 

System.out.printin("Starting " + 
thr2.getName() + "...")3 


thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(childGroup, this); 

System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 


// Remove all threads from the ThreadGroup and 
// destroy the ThreadGroups. 
try 


childGroup.destroy(); 
System.out.println(childGroup.getName() + 
"has been destroyed."); 


catch (IllegalThreadStateException ex) 


{ 
System.out.println(childGroup.getName() + 


is already empty: + 
ex.toString()); 


} 


try 
{ 
parentGroup.destroy(); 
System.out.println(parentGroup.getName() + 
"has been destroyed."); 


catch (IllegalThreadStateException ex) 


{ 
System.out.println(parentGroup.getName() + 
"is already empty: " + 
ex.toString()); 
} 
catch (InterruptedException ex) 
{ 
System.out.println(ex.toString()); 
} 


} 


// Implements Runnable.run() 
public void run() 


1 
for (int i = @; i < 10@@Q0000; i++) 
// Just increment a counter. 
counter++3; 
H 
System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 
} 
private int counter = @; 
} 
/* 


Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Thread-@ has finished executing. 

Thread-1 has finished executing. 

Child ThreadGroup is already empty: java.lang.IllegalThreadStateException: The thread has b 
een destroyed or the group is empty 

Parent ThreadGroup is already empty: java.lang.IllegalThreadStateException: The thread has 
been destroyed or the group is empty 


oh 


See Also 
Reference 
java.lang.ThreadGroup 


Visual J# Reference 


java.lang.ThreadGroup.enumerate(ThreadGroup[] groups, 
boolean recurse) 


Gets all the child 290ee7fa-aa87-4288-8644-5b2d5e6a3817 objects of the current 290ee7fa-aa87-4288-8644- 
5b2d5e6a3817. 


J# 


public int enumerate(java.lang.ThreadGroup[] groups, boolean recurse) 


Parameters 
Param |Description 
eter 





groups |An array of all the child 290ee7fa-aa87-4288-8644-5b2d5e6a3817 objects of the current 290ee7fa-aa87-4288-864 
4-5b2d5e6a3817. 





recurse|true to include the grandchild 290ee7fa-aa87-4288-8644-5b2d5e6a3817 objects; false to include only the immedia 
te child 290ee7fa-aa87-4288-8644-5b2d5e6a3817 objects. 








Property Value/Return Value 


The number of child 290ee7fa-aa87-4288-8644-5b2d5e6a3817 objects of the current 290ee7fa-aa87-4288-8644- 
5b2d5e6a3817. 


Example 


// threadgroup_enumerate1.jsl 
public class Program implements Runnable 


public static void main(String[] args) 


: Program p = new Program(); 
p.init(); 

} 

public void init() 

if 
try 
{ 


// Create a new ThreadGroup and a child for that 
// new ThreadGroup. 
ThreadGroup parentGroup = 
new ThreadGroup("Parent ThreadGroup" ) ; 
ThreadGroup childGroup = 
new ThreadGroup(parentGroup, "Child ThreadGroup") ; 


// Create a second thread and start it. 

Thread thr2 = new Thread(parentGroup, this); 

System.out.printin("Starting " + 
thr2.getName() + "...")3 


thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(childGroup, this); 

System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Enumerate over all the child groups of parentGroup. 
ThreadGroup[] groups = 
new ThreadGroup[parentGroup.activeGroupCount() ]; 





int numGroups = parentGroup.enumerate(groups, true); 
for (int i = @; i < numGroups; i++) 


{ 


System.out.println("Found ThreadGroup " + 
groups[i].getName()); 


} 


// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 


} 
catch (InterruptedException ex) 
{ 
System.out.printin(ex.toString()); 
} 


} 


// Implements Runnable.run() 
public void run() 


{ 
for (int i = 0; i < 10@Q@Q0000; i++) 
// Just increment a counter. 
counter++; 
} 
System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 
} 
private int counter = @; 
} 
/* 


Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Found ThreadGroup Child ThreadGroup 
Thread-@ has finished executing. 
Thread-1 has finished executing. 


*/ 


See Also 
Reference 


java.lang.ThreadGroup 


Visual J# Reference 


java.lang.ThreadGroup.enumerate(ThreadGroup[] groups) 


Gets all the child 290ee7fa-aa87-4288-8644-5b2d5e6a3817 objects of the current 290ee7fa-aa87-4288-8644- 
5b2d5e6a3817. 


J# 


public int enumerate(java.lang.ThreadGroup[] groups) 


Parameters 





Paramet |Description 


An array of all the child 290ee7fa-aa87-4288-8644-5b2d5e6a3817 objects of the current 290ee7fa-aa87-4288-8 


644-5b2d5e6a3817. 





Property Value/Return Value 


The number of child 290ee7fa-aa87-4288-8644-5b2d5e6a3817 objects of the current 290ee7fa-aa87-4288-8644- 
5b2d5e6a3817. 


Example 


// threadgroup_enumerate2.jsl 


public class Program implements Runnable 


{ 
public static void main(String[] args) 
if 
Program p = new Program(); 
p.init(); 
} 
public void init() 
1 
try 
{ 


// Create a new ThreadGroup and a child for that 
// new ThreadGroup. 
ThreadGroup parentGroup = 
new ThreadGroup("Parent ThreadGroup") ; 
ThreadGroup childGroup = 
new ThreadGroup(parentGroup, "Child ThreadGroup") ; 


// Create a second thread and start it. 

Thread thr2 = new Thread(parentGroup, this); 

System.out.printin("Starting " + 
thr2.getName() + "...")3 


thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(childGroup, this); 

System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Enumerate over all the child groups of parentGroup. 
ThreadGroup[] groups = 

new ThreadGroup[parentGroup.activeGroupCount() ]; 
int numGroups = parentGroup.enumerate(groups) ; 
for (int i = @; i < numGroups; i++) 


{ 


System.out.println("Found ThreadGroup " + 
groups[i].getName()); 


// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 


catch (InterruptedException ex) 


{ 
} 


System.out.printin(ex.toString()); 


} 


// Implements Runnable.run() 
public void run() 


ui 
for (int i = @; i < 10@Q@00000; i++) 
// Just increment a counter. 
counter++; 
} 
System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 
} 
private int counter = @; 
} 
/* 


Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Found ThreadGroup Child ThreadGroup 
Thread-@ has finished executing. 
Thread-1 has finished executing. 


ef 


See Also 
Reference 
java.lang.ThreadGroup 


Visual J# Reference 


java.lang.ThreadGroup.enumerate(Thread[] threads, boolean 
recurse) 


Gets all the 2d622dab-0fb9-4756-8474-b94e83c9aael objects that belong to the current 
290¢e7fa-aa87-4288-8644-5b2d5e6a3817 and optionally the children of the current 290ee7fa-aa87-4288-8644- 
5b2d5e6a3817. 


J# 


public int enumerate(java.lang.Thread[] threads, boolean recurse) 


Parameters 





Para Description 
mete 
r 


threa /An array of all the 2d622dab-0fb9-4756-8474-b94e83c9aael objects that belong to the current 290ee7fa-aa87-428 
ds_ |8-8644-5b2d5e6a3817 and optionally the children of the current 290ee7fa-aa87-4288-8644-5b2d5e6a3817. 





recur |true to include the threads belonging to the children of the current 290ee7fa-aa87-4288-8644-5b2d5e6a3817; false 
se___jotherwise. 








Property Value/Return Value 


The number of threads in the current 290ee7fa-aa87-4288-8644-5b2d5e6a3817 and optionally the children of the current 
290ee7fa-aa87-4288-8644-5b2d5e6a3817. 


Example 


// threadgroup_enumerate3.jsl 


public class Program implements Runnable 


{ 
public static void main(String[] args) 
if 
Program p = new Program(); 
p.init(); 
} 
public void init() 
1 
try 
{ 


// Create a new ThreadGroup and a child for that 
// new ThreadGroup. 
ThreadGroup parentGroup = 
new ThreadGroup("Parent ThreadGroup" ); 
ThreadGroup childGroup = 
new ThreadGroup(parentGroup, "Child ThreadGroup") ; 


// Create a second thread and start it. 

Thread thr2 = new Thread(parentGroup, this); 

System.out.printin("Starting " + 
thr2.getName() + "...")3 


thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(childGroup, this); 

System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Enumerate over all the child threads of parentGroup. 





Thread[] threads = new Thread[parentGroup.activeCount() ]; 
int numThreads = parentGroup.enumerate(threads, true); 
for (int i = @; i < numThreads; i++) 
sf 
System.out.print1ln("Found Thread " + 
threads[i].getName()); 


} 


// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 


} 
catch (InterruptedException ex) 
{ 
System.out.println(ex.toString()); 
} 


} 


// Implements Runnable.run() 
public void run() 


{ 
for (int i = @; i < 10@@Q0000; i++) 
// Just increment a counter. 
counter++; 
} 
System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 
} 
private int counter = @; 
} 
/* 


Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Found Thread Thread-@ 

Thread-@ has finished executing. 
Found Thread Thread-1 

Thread-1 has finished executing. 


mh 


See Also 
Reference 
java.lang.ThreadGroup 


Visual J# Reference 


java.lang.ThreadGroup.enumerate(Thread[] threads) 


Gets all the 2d622dab-0fb9-4756-8474-b94e83c9aael objects that belong to the current 
290ee7fa-aa87 -4288-8644-5b62d5e6a3817 and the children of the current 290ee7fa-aa87-4288-8644-5b2d5e6a3817. 


J# 


public int enumerate(java.lang.Thread[] threads) 


Parameters 





Para 
mete 
r 


Description 





threa 
ds 








An array of all the 2d622dab-0fb9-4756-8474-b94e83c9aael objects that belong to the current 290ee7fa-aa87-428 
8-8644-5b2d5e6a3817 and the children of the current 290ee7fa-aa87-4288-8644-5b2d5e6a3817. 





Property Value/Return Value 


The number of threads in the current 290ee7fa-aa87-4288-8644-5b2d5e6a3817 and the children of the current 290ee7fa- 
aa87-4288-8644-5b2d5e6a3817. 


Example 


// threadgroup_enumerate4.jsl 


public class Program implements Runnable 


{ 


public static void main(String[] args) 


: Program p = new Program(); 
p.init(); 

} 

public void init() 

i 
try 
{ 


// Create a new ThreadGroup and a child for that 
// new ThreadGroup. 
ThreadGroup parentGroup = 
new ThreadGroup("Parent ThreadGroup" ) ; 
ThreadGroup childGroup = 
new ThreadGroup(parentGroup, "Child ThreadGroup") ; 


// Create a second thread and start it. 

Thread thr2 = new Thread(parentGroup, this); 

System.out.printin("Starting " + 
thr2.getName() + "...")3 


thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(childGroup, this); 

System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Enumerate over all the child threads of parentGroup. 
Thread[] threads = new Thread[parentGroup.activeCount() ]; 
int numThreads = parentGroup.enumerate(threads) ; 
for (int i = @; i < numThreads; i++) 
1 
System.out.print1ln("Found Thread " + 
threads[i].getName()); 





// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 


catch (InterruptedException ex) 


{ 
} 


System.out.printin(ex.toString()); 


} 


// Implements Runnable.run() 
public void run() 


ui 
for (int i = @; i < 10@Q@00000; i++) 
// Just increment a counter. 
counter++; 
} 
System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 
} 
private int counter = @; 
} 
/* 


Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Found Thread Thread-@ 

Thread-@ has finished executing. 
Found Thread Thread-1 

Thread-1 has finished executing. 
2 A 


See Also 
Reference 
java.lang.ThreadGroup 


Visual J# Reference 


java.lang.ThreadGroup.getMaxPriority() 


Gets the maximum priority that can be set for any thread in the 290ee7fa-aa87-4288-8644-5b2d5e6a3817. 


J# 
public final int getMaxPriority() 


Property Value/Return Value 
A value indicating the maximum priority that can be set for any thread in the 290ee7fa-aa87-4288-8644-5b2d5e6a3817. 
Remarks 


If an attempt is made to add a thread with a higher priority than the value set in setMaxPriority to a 290ee7fa-aa87-4288- 
8644-5b2d5e6a3817, then the priority for that thread will be lowered to the value set in setMaxPriority. 


The default priority for a thread is defined by 31¢5b51c-29cd-4f46-a943 -6275f0acf0a2. The maximum priority for a thread is 
defined by 956ddc7b-7eb0-4857-a442-fd0d6d2d88b4. The minimum priority for a thread is defined by 
£8387b47-a01d-4f34-8d67-10e44c6c24e6. 


Example 


// threadgroup_getmaxpriority.jsl 


public class Program implements Runnable 


{ 


public static void main(String[] args) 
{ 
Program p = new Program(); 
p.init(); 


public void init() 
i 
try 
{ 
// Create a new ThreadGroup and a child for that 
// new ThreadGroup. Set the maximum priority for 
// the parent to 8 and for the child to 5. 
ThreadGroup parentGroup = 
new ThreadGroup("Parent ThreadGroup" ) ; 
parentGroup.setMaxPriority(Thread.MAX_PRIORITY - 2); 


ThreadGroup childGroup = 
new ThreadGroup(parentGroup, "Child ThreadGroup"); 
childGroup.setMaxPriority(Thread.NORM_PRIORITY) ; 


// Create a second thread with maximum priority (pri 10) 
// and start it. 
Thread thr2 = new Thread(parentGroup, this); 
thr2.setPriority(Thread.MAX_PRIORITY) ; 
System.out.printin("Starting " + 

thr2.getName() + "...")3 


thr2.start(); 


// Create a third thread with maximum priority (pri 10) 
// and start it. 
Thread thr3 = new Thread(childGroup, this); 
thr3.setPriority(Thread.MAX_PRIORITY) ; 
System.out.printin("Starting " + 

thr3.getName() + "...")3 


thr3.start(); 


// Display the number of active threads in the 
// new ThreadGroup. 


System.out.println("Active threads in group \"" + 


parentGroup.getName() + "\"_= "+ 
parentGroup.activeCount()); 


// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 


catch (InterruptedException ex) 


{ 
, 


System.out.printin(ex.toString()); 


} 


// Implements Runnable.run() 
public void run() 


for (int i = @; i < 10@@Q0000; i++) 
{ 
// Just increment a counter. 
counter++; 


i: 


// Display what the priority was actually set to when the 
// thread was added to the ThreadGroup. 
System.out.println(Thread.currentThread().getName() + 
" [priority = " + Thread.currentThread().getPriority() + 
"] finished executing."); 


} 


private int counter = @; 


} 


/* 

Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Active threads in group "Parent ThreadGroup" = 2 
Thread-@ [priority = 8] finished executing. 
Thread-1 [priority = 5] finished executing. 

*/ 


See Also 
Reference 
java.lang.ThreadGroup 


Visual J# Reference 


java.lang.ThreadGroup.getName() 


Gets the name for a 290ee7fa-aa87 -4288-8644-5b2d5e6a3817. 


J# 
public final String getName() 


Property Value/Return Value 
The name of the 290ee7fa-aa87-4288-8644-5b2d5e6a3817. 
Example 


// threadgroup_getname.jsl 


public class Program implements Runnable 


{ 


public static void main(String[] args) 
if 
Program p = new Program(); 
p.init(); 
} 


public void init() 
1 
try 
{ 
// Create a new ThreadGroup and a child for that 
// new ThreadGroup. 
ThreadGroup parentGroup = 
new ThreadGroup("Parent ThreadGroup" ) ; 
ThreadGroup childGroup = 
new ThreadGroup(parentGroup, "Child ThreadGroup") ; 


// Create a second thread and start it. 

Thread thr2 = new Thread(parentGroup, this); 

System.out.printin("Starting " + 
thr2.getName() + "...")3 


thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(childGroup, this); 

System.out.printlin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Display the number of active threads in the 
// new ThreadGroup. 
System.out.println("Active threads in group \"" + 


parentGroup.getName() + "\" = "+ 
parentGroup.activeCount()); 


// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 


catch (InterruptedException ex) 


i 
} 


System.out.println(ex.toString()); 


i 


// Implements Runnable.run() 
public void run() 


for (int i = @; i < 10@Q@Q0000; i++) 
{ 
// Just increment a counter. 
counter++; 


} 


System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 


i 


private int counter = @; 


i 


/* 

Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Active threads in group "Parent ThreadGroup" = 2 
Thread-@ has finished executing. 

Thread-1 has finished executing. 

ef 


See Also 
Reference 


java.lang.ThreadGroup 


Visual J# Reference 


java.lang.ThreadGroup.getParent() 


Gets the parent 290ee7fa-aa87-4288-8644-5b2d5e6a3817 of the current 290ee7fa-aa87-4288-8644-5b2d5e6a3817. 


J# 


public final java.lang.ThreadGroup getParent() 


Property Value/Return Value 
The parent 290ee7fa-aa87-4288-8644-5b2d5e6a3817 of the current 290ee7fa-aa87-4288-8644-5b2d5e6a3817. 
Example 


// threadgroup_getparent.jsl 


public class Program implements Runnable 


{ 
public static void main(String[] args) 
if 
Program p = new Program(); 
p.init(); 
} 
public void init() 
1 
try 
{ 


// Create a new ThreadGroup and a child for that 
// new ThreadGroup. 
ThreadGroup parentGroup = 
new ThreadGroup("Parent ThreadGroup" ) ; 
ThreadGroup childGroup = 
new ThreadGroup(parentGroup, "Child ThreadGroup") ; 


// Create a second thread and start it. 

Thread thr2 = new Thread(parentGroup, this); 

System.out.printin("Starting " + 
thr2.getName() + "...")3 


thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(childGroup, this); 

System.out.printlin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Display the number of active threads in the 
// new ThreadGroup. 
System.out.println("Active threads in group \"" + 


parentGroup.getName() + "\"= "+ 
parentGroup.activeCount()); 


// Display the parent ThreadGroup of parentGroup 

// and childGroup. 

System.out.println("The parent ThreadGroup for " + 
parentGroup.getName() + "is " + 
parentGroup.getParent().getName()); 

System.out.printlin("The parent ThreadGroup for " + 
childGroup.getName() + "is " + 
childGroup.getParent().getName()); 


// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 


} 


catch (InterruptedException ex) 


d 
: 


System.out.printin(ex.toString()); 


} 


// Implements Runnable.run() 
public void run() 


{ 
for (int i = @; i < 10@Q@Q0000; i++) 
{ 
// Just increment a counter. 
counter++; 
} 
System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 
} 
private int counter = @; 
} 
/* 


Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Active threads in group "Parent ThreadGroup" = 2 

Thread-@ has finished executing. 

The parent ThreadGroup for Parent ThreadGroup is main 

The parent ThreadGroup for Child ThreadGroup is Parent ThreadGroup 
Thread-1 has finished executing. 


sr 


See Also 
Reference 
java.lang.ThreadGroup 


Visual J# Reference 


java.lang.ThreadGroup.isDaemon() 


Determines whether the current 290ee7fa-aa87-4288-8644-5b2d5e6a3817 is a daemon (background) 290ee7fa-aa87-4288- 
8644-5b2d5e6a3817 


J# 
public final boolean isDaemon() 


Property Value/Return Value 


true if the current 290ee7fa-aa87-4288-8644-5b2d5e6a3817 is a daemon (background) 290ee7fa-aa87-4288-8644- 
5b2d5e6a3817; false otherwise. 


Example 


// threadgroup_isdaemon.jsl 


public class Program implements Runnable 


{ 


public static void main(String[] args) 
{ 
Program p = new Program(); 
p.init(); 


public void init() 
{ 
try 
{ 
// Create a new ThreadGroup and a child for that 
// new ThreadGroup. 
ThreadGroup parentGroup = 
new ThreadGroup("Parent ThreadGroup" ); 
parentGroup.setDaemon(false) ; 


ThreadGroup childGroup = 
new ThreadGroup(parentGroup, "Child ThreadGroup") ; 
childGroup.setDaemon(true) ; 


// Create a second thread and start it. 

Thread thr2 = new Thread(parentGroup, this); 

System.out.printin("Starting " + 
thr2.getName() + "...")3 


thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(childGroup, this); 

System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Display the number of active threads in the 
// new ThreadGroup. 
System.out.println("Active threads in group \"" + 


parentGroup.getName() + "\" “= "+ 
parentGroup.activeCount()); 


// Display which ThreadGroups are daemon ThreadGroups. 
System.out.println(parentGroup.getName() + 
"is a daemon ThreadGroup? " + 
parentGroup.isDaemon()); 
System.out.println(childGroup.getName() + 
"is a daemon ThreadGroup? " + 
childGroup.isDaemon()); 


// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 


} 
catch (InterruptedException ex) 
{ 
System.out.printin(ex.toString()); 
} 


} 


// Implements Runnable.run() 
public void run() 


ui 
for (int i = @; i < 10@Q@00000; i++) 
{ 
// Just increment a counter. 
counter++; 
} 
System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 
} 
private int counter = @; 
} 
/* 


Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Active threads in group "Parent ThreadGroup" = 2 
Thread-@ has finished executing. 

Parent ThreadGroup is a daemon ThreadGroup? false 
Child ThreadGroup is a daemon ThreadGroup? true 
Thread-1 has finished executing. 


i 


See Also 
Reference 
java.lang.ThreadGroup 


Visual J# Reference 


java.lang. ThreadGroup.isDestroyed() 


Determines whether the current 290ee7fa-aa87-4288-8644-5b2d5e6a3817 has already been destroyed. 


J# 
public boolean isDestroyed() 


Property Value/Return Value 
true if the current 290ee7fa-aa87-4288-8644-5b2d5e6a3817 has already been destroyed; false otherwise. 
Example 


// threadgroup_isdestroyed.jsl 


public class Program implements Runnable 


{ 
public static void main(String[] args) 
if 
Program p = new Program(); 
p.init(); 
} 
public void init() 
1 
try 
{ 


// Create a new ThreadGroup and a child for that 
// new ThreadGroup. 
ThreadGroup parentGroup = 
new ThreadGroup("Parent ThreadGroup" ) ; 
ThreadGroup childGroup = 
new ThreadGroup(parentGroup, "Child ThreadGroup") ; 


// Create a second thread and start it. 

Thread thr2 = new Thread(parentGroup, this); 

System.out.printin("Starting " + 
thr2.getName() + "...")3 


thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(childGroup, this); 

System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 
// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 
// Remove all threads from the ThreadGroup and 
// destroy the ThreadGroups. 
try 
if (!childGroup.isDestroyed()) 


childGroup.destroy(); 


} 
else 
{ 
System.out.println(childGroup.getName() + 
"has been destroyed."); 
} 


catch (IllegalThreadStateException ex) 


{ 
System.out.println(childGroup.getName() + 
"is already empty: " + 
ex.toString()); 
} 
try 
if (!parentGroup.isDestroyed()) 
{ 
parentGroup.destroy(); 
} 
else 
{ 
System.out.println(parentGroup.getName() + 
"has been destroyed."); 
} 
catch (IllegalThreadStateException ex) 
1 
System.out.println(parentGroup.getName() + 
"is already empty: " + 
ex.toString()); 
} 
catch (InterruptedException ex) 
{ 
System.out.println(ex.toString()); 
; 


} 


// Implements Runnable.run() 
public void run() 


{ 
for (int i = @; i < 10@Q@Q00000; i++) 
{ 
// Just increment a counter. 
counter++; 
} 
System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 
} 
private int counter = @; 
} 
/* 


Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Thread-@ has finished executing. 

Thread-1 has finished executing. 

Child ThreadGroup is already empty: java.lang.IllegalThreadStateException: The thread has b 
een destroyed or the group is empty 

Parent ThreadGroup is already empty: java.lang.IllegalThreadStateException: The thread has 
been destroyed or the group is empty 


*/ 


See Also 
Reference 


java.lang.ThreadGroup 


Visual J# Reference 


java.lang.ThreadGroup.list() 


Displays a listing of the 290ee7fa-aa87-4288-8644-5b2d5e6a3817, including the name and maximum priority of the 
290ee7fa-aa87-4288-8644-5b2d5e6a3817, as well as the names and priorities of the threads in the 290ee7fa-aa87-4288- 
8644-5b2d5e6a3817 


J# 
public void list() 


Example 


// threadgroup_list.jsl 


public class Program implements Runnable 


{ 
public static void main(String[] args) 
{ 
Program p = new Program(); 
p.init(); 
} 
public void init() 
si 
try 
{ 


// Create a new ThreadGroup and a child for that 
// new ThreadGroup. 
ThreadGroup parentGroup = 
new ThreadGroup("Parent ThreadGroup" ) ; 
ThreadGroup childGroup = 
new ThreadGroup(parentGroup, "Child ThreadGroup") ; 


// Create a second thread and start it. 

Thread thr2 = new Thread(parentGroup, this); 

System.out.printin("Starting " + 
thr2.getName() + "...")3 

thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(childGroup, this); 

System.out.printin("Starting " + 
thr3.getName() + "...")3 

thr3.start(); 


// Display the number of active threads in the 
// new ThreadGroup. 
System.out.println("Active threads in group \"" + 


parentGroup.getName() + "\" = "+ 
parentGroup.activeCount()); 


// List the contents of the ThreadGroups. 

System.out.println("\nListing for ThreadGroup " + 
parentGroup.getName() + ":"); 

parentGroup.list(); 

System.out.println("\nListing for ThreadGroup " + 
childGroup.getName() + ":"); 

childGroup.list(); 


// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 


catch (InterruptedException ex) 


System.out.println(ex.toString()); 


} 


// Implements Runnable.run() 
public void run() 


{ 
for (int i = 0; i < 10@@eQ0000; i++) 
{ 
// Just increment a counter. 
counter++; 
} 
System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 
} 
private int counter = @; 
} 
/* 


Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Active threads in group "Parent ThreadGroup" = 2 
Thread-@ has finished executing. 

Thread-1 has finished executing. 


Listing for ThreadGroup Parent ThreadGroup: 
java.lang.ThreadGroup[name=Parent ThreadGroup, maxpri=10] 
Thread[Thread-@,5,Parent ThreadGroup] 
java.lang.ThreadGroup[name=Child ThreadGroup, maxpri=10] 
Thread[Thread-1,5,Child ThreadGroup ] 


Listing for ThreadGroup Child ThreadGroup: 

java.lang.ThreadGroup[name=Child ThreadGroup, maxpri=10] 
Thread[Thread-1,5,Child ThreadGroup ] 

* 


See Also 
Reference 
java.lang.ThreadGroup 


Visual J# Reference 


java.lang.ThreadGroup.parentOf(ThreadGroup group) 


Determines whether the current ThreadGroup is the parent of the given ThreadGroup. 


J# 


public final boolean parentOf(java.lang.ThreadGroup group) 


Parameters 





A java.lang.ThreadGroup object to determine if it is a child of the current ThreadGroup. 


Property Value/Return Value 


true if the current ThreadGroup is the parent of the given ThreadGroup; false otherwise. 


Example 
// threadgroup_parentof.jsl 


public class Program implements Runnable 


{ 


public static void main(String[] args) 
{ 
Program p = new Program(); 
p.init(); 


public void init() 
{ 
try 
{ 
// Create a new ThreadGroup and a child for that 
// new ThreadGroup. 
ThreadGroup parentGroup = 
new ThreadGroup("Parent ThreadGroup") ; 
ThreadGroup childGroup = 
new ThreadGroup(parentGroup, "Child ThreadGroup") ; 


// Create a second thread and start it. 

Thread thr2 = new Thread(parentGroup, this); 

System.out.printin("Starting " + 
thr2.getName() + "...")3 


thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(childGroup, this); 

System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Display the number of active threads in the 
// new ThreadGroup. 
System.out.println("Active threads in group \"" + 


parentGroup.getName() + "\" = "+ 
parentGroup.activeCount()); 


// Determine which ThreadGroup is the parent and 
// which is the child. 
boolean isParent = parentGroup.parentOf(childGroup) ; 
System.out.println(parentGroup.getName() + 
"is the parent of " + childGroup.getName() + 
">? " + isParent) ; 


isParent = childGroup.parentOf(parentGroup) ; 
System.out.println(childGroup.getName() + 
"is the parent of " + parentGroup.getName() + 
">? " + isParent) ; 


// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 


catch (InterruptedException ex) 


{ 
} 


System.out.println(ex.toString()); 


} 


// Implements Runnable.run() 
public void run() 


{ 
for (int i = @; i < 10@@Q0000; i++) 
{ 
// Just increment a counter. 
counter++; 
} 
System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 
} 
private int counter = @; 
/* 


Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Active threads in group "Parent ThreadGroup" = 2 

Thread-@ has finished executing. 

Parent ThreadGroup is the parent of Child ThreadGroup? true 
Thread-1 has finished executing. 

Child ThreadGroup is the parent of Parent ThreadGroup? false 
ir 


See Also 
Reference 
java.lang.ThreadGroup 


Visual J# Reference 


java.lang.ThreadGroup.resume() 


Resumes execution of all threads in the 290ee7fa-aa87-4288-8644-5b2d5e6a3817 that have been suspended 


J# 


public final void resume() 


Remarks 


Note For Visual J# 2005, the permission sets for this method have changed. Whereas no permission was needed in earlier 
versions, now permission is demanded when calling this method. See SecurityAttribute and SecurityAction for more 
information. 


Example 


// threadgroup_resume.jsl 


public class Program implements Runnable 


{ 


public static void main(String[] args) 
{ 
Program p = new Program(); 
p.init(); 


public void init() 
{ 
try 
{ 
// Create a new ThreadGroup and a child for that 
// new ThreadGroup. 
ThreadGroup parentGroup = 
new ThreadGroup("Parent ThreadGroup") ; 
ThreadGroup childGroup = 
new ThreadGroup(parentGroup, "Child ThreadGroup") ; 


// Create a second thread and start it. 

Thread thr2 = new Thread(parentGroup, this); 

System.out.printin("Starting " + 
thr2.getName() + "...")3 


thr2.start(); 


// Suspend all threads in parentGroup. 
System.out.println("Suspending all threads in " + 

parentGroup.getName() + "...")3 
parentGroup.suspend() ; 


// Create a third thread and start it. 

Thread thr3 = new Thread(childGroup, this); 

System.out.printlin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Display the number of active threads in the 
// new ThreadGroup. 
System.out.println("Active threads in group \"" + 


parentGroup.getName() + "\"= "+ 
parentGroup.activeCount()); 


// Block until the other threads finish or for 1000 ms, 
// whichever comes first. 

thr2.join(100@0) ; 

thr3.join(); 


// Resume all thread in parentGroup. 
System.out.println("Resuming all threads in 

parentGroup.getName()); 
parentGroup.resume(); 


+ 


} 
catch (InterruptedException ex) 
{ 
System.out.println(ex.toString()); 
} 


} 


// Implements Runnable.run() 
public void run() 


ui 
for (int i = @; i < 10@@Q0000; i++) 
{ 
// Just increment a counter. 
counter++; 
} 
System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 
} 
private int counter = @; 
} 
/* 


Sample Output: 

Starting Thread-@... 

Suspending all threads in Parent ThreadGroup... 
Starting Thread-1... 

Active threads in group "Parent ThreadGroup" = 2 
Thread-1 has finished executing. 

Resuming all threads in Parent ThreadGroup 


de 


See Also 
Reference 
java.lang.ThreadGroup 


Visual J# Reference 


java.lang.ThreadGroup.setDaemon(boolean b) 


Sets a value indicating whether the current 290ee7 fa-aa87-4288-8644-5b2d5e6a3817 is a daemon (background) 290ee7fa- 
aa87-4288-8644-5b2d5e6a3817 


J# 


public final void setDaemon(boolean b) 


Parameters 





Parame|Description 
ter 


true to make the current 290ee7fa-aa87-4288-8644-5b2d5e6a3817 a daemon (background) 290ee7fa-aa87-428 
8-8644-5b2d5e6a3817; false otherwise. 





Example 





// threadgroup_setdaemon.jsl 


public class Program implements Runnable 


{ 
public static void main(String[] args) 
{ 
Program p = new Program(); 
p.init(); 
} 
public void init() 
{ 
try 
{ 


// Create a new ThreadGroup and a child for that 
// new ThreadGroup. 
ThreadGroup parentGroup = 

new ThreadGroup("Parent ThreadGroup") ; 
parentGroup.setDaemon(false) ; 


ThreadGroup childGroup = 
new ThreadGroup(parentGroup, "Child ThreadGroup"); 
childGroup.setDaemon(true) ; 


// Create a second thread and start it. 

Thread thr2 = new Thread(parentGroup, this); 

System.out.printin("Starting " + 
thr2.getName() + "...")3 


thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(childGroup, this); 

System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Display the number of active threads in the 
// new ThreadGroup. 
System.out.println("Active threads in group \"" + 


parentGroup.getName() + "\"_= "+ 
parentGroup.activeCount()); 


// Display which ThreadGroups are daemon ThreadGroups. 
System.out.println(parentGroup.getName() + 
"is a daemon ThreadGroup? " + 
parentGroup.isDaemon()); 
System.out.println(childGroup.getName() + 





is a daemon ThreadGroup? " + 
childGroup.isDaemon()); 


// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 


catch (InterruptedException ex) 


{ 
} 


System.out.println(ex.toString()); 


} 


// Implements Runnable.run() 
public void run() 


if 
for (int i = @; i < 10@Q@Q0000; i++) 
{ 
// Just increment a counter. 
counter++; 
} 
System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 
} 
private int counter = @; 
} 
/* 


Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Active threads in group "Parent ThreadGroup" = 2 
Thread-@ has finished executing. 

Parent ThreadGroup is a daemon ThreadGroup? false 
Child ThreadGroup is a daemon ThreadGroup? true 
Thread-1 has finished executing. 


*/ 


See Also 
Reference 
java.lang.ThreadGroup 


Visual J# Reference 


java.lang.ThreadGroup.setMaxPriority(int pri) 


Sets the maximum priority that can be set for any thread in the 290ee7fa-aa87-4288-8644-5b2d5e6a3817. 


J# 





public final void setMaxPriority(int pri) 
Parameters 
Paramete |Description 





A value indicating the maximum priority that can be set for any thread in the 290ee7fa-aa87-4288-8644-5b2d5e 
6a3817. 





Remarks 


If an attempt is made to add a thread with a higher priority than the value set in setMaxPriority to a 290ee7fa-aa87-4288- 
8644-5b2d5e6a3817, then the priority for that thread will be lowered to the value set in setMaxPriority. 


The default priority for a thread is defined by 31¢5b51c-29cd-4f46-a943 -6275f0acf0a2. The maximum priority for a thread is 
defined by 956ddc7b-7eb0-4857-a442-fd0d6d2d88b4. The minimum priority for a thread is defined by 
£8387b47-a01d-4f34-8d67-10e44c6c24e6. 


Example 





// threadgroup_setmaxpriority.jsl 
public class Program implements Runnable 


public static void main(String[] args) 


: Program p = new Program(); 
p.init(); 

} 

public void init() 

if 
try 
1 


// Create a new ThreadGroup and a child for that 
// new ThreadGroup. Set the maximum priority for 
// the parent to 8 and for the child to 5. 
ThreadGroup parentGroup = 

new ThreadGroup("Parent ThreadGroup") ; 
parentGroup.setMaxPriority(Thread.MAX_PRIORITY - 2); 


ThreadGroup childGroup = 
new ThreadGroup(parentGroup, "Child ThreadGroup") ; 
childGroup.setMaxPriority(Thread.NORM_ PRIORITY) ; 


// Create a second thread with maximum priority (pri 10) 
// and start it. 
Thread thr2 = new Thread(parentGroup, this); 
thr2.setPriority(Thread.MAX_PRIORITY) ; 
System.out.printin("Starting " + 

thr2.getName() + "...")3 


thr2.start(); 


// Create a third thread with maximum priority (pri 10) 
// and start it. 

Thread thr3 = new Thread(childGroup, this); 
thr3.setPriority(Thread.MAX_PRIORITY) ; 


System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Display the number of active threads in the 
// new ThreadGroup. 
System.out.println("Active threads in group \"" + 


parentGroup.getName() + "\"_= "+ 
parentGroup.activeCount()); 


// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 


} 
catch (InterruptedException ex) 
{ 
System.out.println(ex.toString()); 
} 


} 


// Implements Runnable.run() 
public void run() 


{ 
for (int i = @; i < 10@@Q0000; i++) 
// Just increment a counter. 
counter++; 
} 
// Display what the priority was actually set to when the 
// thread was added to the ThreadGroup. 
System.out.println(Thread.currentThread().getName() + 
" [priority = " + Thread.currentThread().getPriority() + 
"] finished executing."); 
} 
private int counter = @; 
} 
/* 


Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Active threads in group "Parent ThreadGroup" = 2 
Thread-@ [priority = 8] finished executing. 
Thread-1 [priority = 5] finished executing. 

=f 


See Also 
Reference 
java.lang.ThreadGroup 


Visual J# Reference 


java.lang.ThreadGroup.stop() 


Stops execution of all threads in the 290ee7fa-aa87-4288-8644-5b2d5e6a3817. 


J# 


public final void stop() 


Remarks 


Note For Visual J# 2005, the permission sets for this method have changed. Whereas no permission was needed in earlier 
versions, now permission is demanded when calling this method. See SecurityAttribute and SecurityAction for more 
information. 


Example 


// threadgroup_stop.jsl 


public class Program implements Runnable 


{ 


public static void main(String[] args) 


{ 


Program p = new Program(); 
p.init(); 


public void init() 


{ 


} 


// Create a new ThreadGroup and a child for that 
// new ThreadGroup. 
ThreadGroup parentGroup = 

new ThreadGroup("Parent ThreadGroup") ; 
ThreadGroup childGroup = 


new ThreadGroup(parentGroup, "Child ThreadGroup") ; 


// Create a second thread and start it. 

Thread thr2 = new Thread(parentGroup, this); 

System.out.printin("Starting " + 
thr2.getName() + "...")3 


thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(childGroup, this); 

System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Display the number of active threads in the 
// new ThreadGroup. 
System.out.println("Active threads in group \"" + 


parentGroup.getName() + "\"= "+ 
parentGroup.activeCount()); 


// The threads are taking a long time. 

childGroup.stop(); 

System.out.println(childGroup.getName() + 
"has been manually stopped."); 


parentGroup.stop(); 
System.out.println(parentGroup.getName() + 
"has been manually stopped."); 


// Implements Runnable.run() 
public void run() 


for (int i = @; i < Integer.MAX_VALUE; i++) 
{ 

// Just increment a counter. 

counter++; 


} 


System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 


i 


private int counter = @; 


i 


/* 

Sample Output: 

Starting Thread-@... 

Starting Thread-1... 

Active threads in group "Parent ThreadGroup" = 2 
Child ThreadGroup has been manually stopped. 
Parent ThreadGroup has been manually stopped. 


i 


See Also 
Reference 
java.lang.ThreadGroup 
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java.lang. ThreadGroup.suspend() 


Suspends execution of all threads in the 290ee7fa-aa87-4288-8644-5b2d5e6a3817 until resume is called. 
J# 


public final void suspend() 


Remarks 


Note For Visual J# 2005, the permission sets for this method have changed. Whereas no permission was needed in earlier 
versions, now permission is demanded when calling this method. See SecurityAttribute and SecurityAction for more 
information. 


Example 


// threadgroup_suspend.jsl 


public class Program implements Runnable 


{ 


public static void main(String[] args) 
{ 
Program p = new Program(); 
p.init(); 


public void init() 
{ 
try 
{ 
// Create a new ThreadGroup and a child for that 
// new ThreadGroup. 
ThreadGroup parentGroup = 
new ThreadGroup("Parent ThreadGroup") ; 
ThreadGroup childGroup = 
new ThreadGroup(parentGroup, "Child ThreadGroup") ; 


// Create a second thread and start it. 

Thread thr2 = new Thread(parentGroup, this); 

System.out.printin("Starting " + 
thr2.getName() + "...")3 


thr2.start(); 


// Suspend all threads in parentGroup. 
System.out.println("Suspending all threads in " + 

parentGroup.getName() + "...")3 
parentGroup.suspend() ; 


// Create a third thread and start it. 

Thread thr3 = new Thread(childGroup, this); 

System.out.printlin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 


// Display the number of active threads in the 
// new ThreadGroup. 
System.out.println("Active threads in group \"" + 


parentGroup.getName() + "\"= "+ 
parentGroup.activeCount()); 


// Block until the other threads finish or for 1000 ms, 
// whichever comes first. 

thr2.join(100@0) ; 

thr3.join(); 


// Resume all thread in parentGroup. 
System.out.println("Resuming all threads in 

parentGroup.getName()); 
parentGroup.resume(); 


+ 


} 
catch (InterruptedException ex) 
{ 
System.out.println(ex.toString()); 
} 


} 


// Implements Runnable.run() 
public void run() 


ui 
for (int i = @; i < 10@@Q0000; i++) 
{ 
// Just increment a counter. 
counter++; 
} 
System.out.println(Thread.currentThread().getName() + 
"has finished executing."); 
} 
private int counter = @; 
} 
/* 


Sample Output: 

Starting Thread-@... 

Suspending all threads in Parent ThreadGroup... 
Starting Thread-1... 

Active threads in group "Parent ThreadGroup" = 2 
Thread-1 has finished executing. 

Resuming all threads in Parent ThreadGroup 


de 


See Also 
Reference 
java.lang.ThreadGroup 
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java.lang.ThreadGroup.uncaughtException(Thread thrd, 
Throwable e) 


Prints the stack trace for any uncaught exceptions. 


J# 


public void uncaughtException(java.lang.Thread thrd, java.lang.Throwable e) 

















Parameters 

Parameter Description 

thrd The thread where the uncaught exception was thrown. 
e The exception that was thrown and not caught. 
Remarks 


This method is used to handle any unhandled exceptions from threads in the thread group. When any thread in a thread group 
leaves an exception unhandled, this methods will be called with the thread object and the exception -- giving the thread group 
a chance to handle it. This method receives all unhandled exceptions and errors including ThreadDeath -- which is thrown 
when a thread is destroyed. 


Example 


// threadgroup_uncaughtexception.jsl 


public class Program implements Runnable 


{ 


public static void main(String[] args) 
{ 
Program p = new Program(); 
p.init(); 


public void init() 
{ 
try 
{ 
// Create a new MyThreadGroup (code below) and a child 
// for that new MyThreadGroup. 
MyThreadGroup parentGroup = 
new MyThreadGroup("Parent MyThreadGroup" ) ; 
MyThreadGroup childGroup = 
new MyThreadGroup(parentGroup, "Child MyThreadGroup") ; 


// Create a second thread and start it. 

Thread thr2 = new Thread(parentGroup, this); 

System.out.printin("Starting " + 
thr2.getName() + "...")3 


thr2.start(); 


// Create a third thread and start it. 

Thread thr3 = new Thread(childGroup, this); 

System.out.printin("Starting " + 
thr3.getName() + "...")3 


thr3.start(); 
try 


// Give some time for the child threads to start. 
Thread.sleep(5@@) ; 





catch (InterruptedException ex) 


dt 
} 


// Interrupt the two sub-threads. 
thr2.interrupt(); 
thr3.interrupt(); 


// Ignore this exception here 


// Block until the other threads finish. 
thr2.join(); 
thr3.join(); 


catch (InterruptedException ex) 


{ 
} 


System.out.printin(ex.toString()); 


} 


// Implements Runnable.run() 
public void run() 


{ 
try 
{ 
System.out.println(Thread.currentThread().getName() + 
"is executing."); 
while (true) 
{ 
Thread.sleep(5@@) ; 
i 
catch (InterruptedException ex) 
{ 
Thread currThread = Thread.currentThread() ; 
System.out.println(currThread.getName() + 
"was interrupted: " + ex.toString()); 
// Rethrow the exception as a RuntimeException. 
// This will be sent to the ThreadGroup. 
throw new RuntimeException(ex.getMessage()); 
} 
} 
; 
class MyThreadGroup extends ThreadGroup 
{ 


// Constructor requiring a name for the ThreadGroup. 
MyThreadGroup(String name) 


super (name) ; 
} 
// Constructor requiring the parent and a name for the 
// ThreadGroup. 
MyThreadGroup(ThreadGroup parent, String name) 


super(parent, name); 
public void uncaughtException(Thread th, Throwable t) 
{ 
} 


// Hide default constructor. 
private MyThreadGroup() 


System.out.printin(th + " has unhandled exception: " + t); 


/* 

Starting Thread-@... 

Starting Thread-1... 

Thread-@ is executing. 

Thread-1 is executing. 

Thread-@ was interrupted: java.lang.InterruptedException: Thread has been interrupted from 
a waiting state. 

Thread-1 was interrupted: java.lang.InterruptedException: Thread has been interrupted from 
a waiting state. 

Thread[Thread-@,5,Parent MyThreadGroup] has unhandled exception: java.lang.RuntimeException 
: Thread has been interrupted from a waiting state. 


=f 


See Also 
Reference 


java.lang.ThreadGroup 
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java.security.acl 


Contains classes and interfaces used for processing Access Control Lists to grant or deny permissions to individuals or groups 
of individuals. 


Classes 





Class Description 





AclNotFoundException|The exception that is thrown when attempting to modify or view an Access Control List that cannot be f 
ound. 


LastOwnerException |The exception that is thrown when attempting to remove the last owner from an Access Control List. 


NotOwnerException |The exception that is thrown when attempting to modify an Access Control List that is not owned by th 
e caller. 








Interfaces 








Interface |Description 





Acl Represents an Access Control List used to explicitly grant or deny permissions to a file or folder to individuals or gr 
oups of individuals. 


AclEntry /Represents an entry in an Access Control List. 


Group Represents a group of individuals within an Access Control List. All members of the group can be granted or denie 
d permission by granting or denying the permission to the group. 





Owner Represents an owner of an Access Control List. 





Permission|Represents a permission within an entry in the Access Control List. 
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Acl Interface 


Represents an Access Control List used to explicitly grant or deny permissions to a file or folder to individuals or groups of 
individuals. 


Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public interface java.security.acl.Acl 
extends java.security.acl.Owner 





See Also 

Concepts 

Acl Members 
java.security.acl Package 
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Acl Members 


Represents an Access Control List used to explicitly grant or deny permissions to a file or folder to individuals or groups of 
individuals. 


The following tables list the members exposed by the Ac! type. 


Public Methods 
Name Description 


addEntry Adds an entry to an Access Control List. 


checkPermission|Determines whether an individual has a certain permission granted in the Access Control List. 


entries Returns an Enumeration object that can be used to enumerate over the AclEntry objects in the Access Control 
List. 
getName Gets the name of the Access Control List. 


getPermissions |Returns an Enumeration object that can be used to enumerate over the Permission objects for a given user in 
the Access Control List. 





removeEntry Removes an entry from an Access Control List. 





setName Sets the name of the Access Control List. 





toString Displays a human-readable representation of an Ac! object. 











See Also 

Reference 

Acl Interface 

Concepts 
java.security.acl Package 
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Acl Methods 


Public Methods 
Name Description 








addEntry Adds an entry to an Access Control List. 





checkPermission|Determines whether an individual has a certain permission granted in the Access Control List. 





entries Returns an Enumeration object that can be used to enumerate over the AclEntry objects in the Access Control 
List. 
getName Gets the name of the Access Control List. 


getPermissions |Returns an Enumeration object that can be used to enumerate over the Permission objects for a given user in 
the Access Control List. 


removeEntry Removes an entry from an Access Control List. 
setName Sets the name of the Access Control List. 


toString Displays a human-readable representation of an Ac! object. 





See Also 

Reference 

Acl Interface 

Concepts 
java.security.acl Package 
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Acl.addEntry Method 


Adds an entry to an Access Control List. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean addEntry( 
java.security.Principal caller, 
java.security.acl.AclEntry entry) throws java.security.acl.NotOwnerException; 


Parameters 
caller 


The person, represented by a Principal object, attempting to add the entry to the Access Control List. 
entry 

The entry, in the form of an AclEntry object, to add to the Access Control List. 
Return Value 
true if the entry was successfully added to the Access Control List; false otherwise. 


See Also 

Reference 

Acl Interface 

Concepts 

Acl Members 
java.security.acl Package 
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Acl.checkPermission Method 


Determines whether an individual has a certain permission granted in the Access Control List. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean checkPermission( 
java.security.Principal principal, 
java.security.acl.Permission permission) ; 


Parameters 
principal 


The person, represented by a Principal object, whose permissions are being checked. 
permission 

The permission, in the form of a Permission object, to check. 
Return Value 
true if the principal has the given permission; false otherwise. 


See Also 

Reference 

Acl Interface 

Concepts 

Acl Members 
java.security.acl Package 
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Acl.entries Method 


Returns an Enumeration object that can be used to enumerate over the AclEntry objects in the Access Control List. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 





public abstract java.util.Enumeration entries(); 





Return Value 
An Enumeration object that can be used to enumerate over the AclEntry objects in the Access Control List. 


See Also 

Reference 

Acl Interface 

Concepts 

Acl Members 
java.security.acl Package 
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Acl.getName Method 


Gets the name of the Access Control List. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String getName(); 


Return Value 
The name of the Access Control List. 


See Also 

Reference 

Acl Interface 

Concepts 

Acl Members 
java.security.acl Package 


Visual J# Reference 


Acl.getPermissions Method 


Returns an Enumeration object that can be used to enumerate over the Permission objects for a given user in the Access 
Control List. 


Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public abstract java.util.Enumeration getPermissions( 
java.security.Principal user); 


Parameters 
user 


The person, represented by a Principal object, whose permissions are being returned. 
Return Value 
An Enumeration object that can be used to enumerate over the Permission objects for a given user in the Access Control List. 


See Also 

Reference 

Acl Interface 

Concepts 

Acl Members 
java.security.acl Package 
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Acl.removeEntry Method 


Removes an entry from an Access Control List. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean removeEntry( 
java.security.Principal caller, 
java.security.acl.AclEntry entry) throws java.security.acl.NotOwnerException; 


Parameters 
caller 


The person, represented by a Principal object, attempting to remove the entry from the Access Control List. 
entry 

The entry, in the form of an AclEntry object, to remove from the Access Control List. 
Return Value 
true if the entry was successfully removed from the Access Control List; false otherwise. 


See Also 

Reference 

Acl Interface 

Concepts 

Acl Members 
java.security.acl Package 
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Acl.setName Method 


Sets the name of the Access Control List. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public abstract void setName( 
java.security.Principal caller, 
java.lang.String name) throws java.security.acl.NotOwnerException; 


Parameters 
caller 


The person, represented by a Principal object, attempting to set the name of the Access Control List. 
name 
The name of the Access Control List. 


See Also 

Reference 

Acl Interface 

Concepts 

Acl Members 
java.security.acl Package 
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Acl.toString Method 


Displays a human-readable representation of an Ac! object. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String toString(); 


Return Value 
A human-readable representation of an Acl object. 


See Also 

Reference 

Acl Interface 

Concepts 

Acl Members 
java.security.acl Package 
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AclEntry Interface 


Represents an entry in an Access Control List. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public interface java.security.acl.AclEntry 
extends java.lang.Cloneable 


See Also 

Concepts 

AclEntry Members 
java.security.acl Package 
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AclEntry Members 


Represents an entry in an Access Control List. 


The following tables list the members exposed by the AclEntry type. 


Public Methods 

















Name Description 

addPermission Adds a permission to an entry in the Access Control List. 

checkPermission Determines whether a permissions is granted for an entry in the Access Control List. 

getPrincipal Gets the Principal object associated with an entry in the Access Control List. 

isNegative Determines whether the permissions in this entry are negative. A negative entry means that the permi 


ssions are denied rather than granted. 





clone Creates an instance of an AclEntry object that is a shallow copy of the current AclEntry object. 





permissions Returns an Enumeration object that can be used to enumerate over the Permission objects for an entr 
y in the Access Control List. 


removePermission Removes a permission from an entry in the Access Control List. 





setNegativePermissions|Sets the permissions in this entry to negative. A negative entry means that the permissions are denied 
rather than granted. 





setPrincipal Sets the Principal object associated with an entry in the Access Control List. 





toString Displays a human-readable representation of an AclEntry object. 











See Also 

Reference 

AclEntry Interface 
Concepts 
java.security.acl Package 
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AclEntry Methods 


Public Methods 

















Name Description 

addPermission Adds a permission to an entry in the Access Control List. 

checkPermission Determines whether a permissions is granted for an entry in the Access Control List. 

getPrincipal Gets the Principal object associated with an entry in the Access Control List. 

isNegative Determines whether the permissions in this entry are negative. A negative entry means that the permi 


ssions are denied rather than granted. 


clone Creates an instance of an AclEntry object that is a shallow copy of the current AclEntry object. 





Returns an Enumeration object that can be used to enumerate over the Permission objects for an entr 
y in the Access Control List. 


permissions 


removePermission Removes a permission from an entry in the Access Control List. 





setNegativePermissions|Sets the permissions in this entry to negative. A negative entry means that the permissions are denied 
rather than granted. 





setPrincipal Sets the Principal object associated with an entry in the Access Control List. 





toString Displays a human-readable representation of an AclEntry object. 











See Also 

Reference 

AclEntry Interface 
Concepts 
java.security.acl Package 
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AclEntry.addPermission Method 


Adds a permission to an entry in the Access Control List. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean addPermission( 
java.security.acl.Permission permission) ; 


Parameters 
permission 


The permission, in the form of a Permission object, to add to an entry in the Access Control List. 
Return Value 
true if the permission was successfully added; false otherwise. 


See Also 

Reference 

AclEntry Interface 
Concepts 

AclEntry Members 
java.security.acl Package 
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AclEntry.checkPermission Method 


Determines whether a permissions is granted for an entry in the Access Control List. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean checkPermission( 
java.security.acl.Permission permission) ; 


Parameters 
permission 


The permission, in the form of a Permission object, to check. 
Return Value 


true if the given permission is granted for the current entry in the Access Control List; false otherwise. 


See Also 

Reference 

AclEntry Interface 
Concepts 

AclEntry Members 
java.security.acl Package 
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AclEntry.clone Method 


Creates an instance of an AclEntry object that is a shallow copy of the current AclEntry object. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 





public abstract java.lang.Object clone(); 





Return Value 
A shallow copy of the current AclEntry object. 


See Also 

Reference 

AclEntry Interface 
Concepts 

AclEntry Members 
java.security.acl Package 
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AclEntry.getPrincipal Method 


Gets the Principal object associated with an entry in the Access Control List. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public abstract java.security.Principal getPrincipal(); 


Return Value 
The Principal object associated with an entry in the Access Control List. 


See Also 

Reference 

AclEntry Interface 
Concepts 

AclEntry Members 
java.security.acl Package 
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AclEntry.isNegative Method 


Determines whether the permissions in this entry are negative. A negative entry means that the permissions are denied rather 
than granted. 


Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean isNegative(); 


Return Value 
true if the entry is negative; false otherwise. 


See Also 

Reference 

AclEntry Interface 
Concepts 

AclEntry Members 
java.security.acl Package 
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AclEntry.permissions Method 


Returns an Enumeration object that can be used to enumerate over the Permission objects for an entry in the Access Control 
List. 


Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public abstract java.util.Enumeration permissions(); 
| 


Return Value 
An Enumeration object that can be used to enumerate over the Permission objects for an entry in the Access Control List. 


See Also 

Reference 

AclEntry Interface 
Concepts 

AclEntry Members 
java.security.acl Package 


Visual J# Reference 


AclEntry.removePermission Method 


Removes a permission from an entry in the Access Control List. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean removePermission( 
java.security.acl.Permission permission) ; 


Parameters 
permission 


The permission, in the form of a Permission object, to remove from an entry in the Access Control List. 
Return Value 
true if the permission was successfully removed; false otherwise. 


See Also 

Reference 

AclEntry Interface 
Concepts 

AclEntry Members 
java.security.acl Package 
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AclEntry.setNegativePermissions Method 


Sets the permissions in this entry to negative. A negative entry means that the permissions are denied rather than granted. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public abstract void setNegativePermissions(); 


See Also 

Reference 

AclEntry Interface 
Concepts 

AclEntry Members 
java.security.acl Package 
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AclEntry.setPrincipal Method 


Sets the Principal object associated with an entry in the Access Control List. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean setPrincipal( 
java.security.Principal user); 


Parameters 
user 


The Principal object associated with an entry in the Access Control List. 
Return Value 


true if the principal for the current entry in the Access Control List was successfully set; false otherwise. 


See Also 

Reference 

AclEntry Interface 
Concepts 

AclEntry Members 
java.security.acl Package 
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AclEntry.toString Method 


Displays a human-readable representation of an AclEntry object. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String toString(); 


Return Value 
A human-readable representation of an AclEntry object. 


See Also 

Reference 

AclEntry Interface 
Concepts 

AclEntry Members 
java.security.acl Package 
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AclINotFoundException Class 


The exception that is thrown when attempting to modify or view an Access Control List that cannot be found. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 





public class java.security.acl.AclNotFoundException 
extends java.lang.Exception 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.security.acl.AclNotFoundException 


See Also 

Concepts 

AclNotFoundException Members 
java.security.acl Package 
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AcINotFoundException Members 


The exception that is thrown when attempting to modify or view an Access Control List that cannot be found. 


The following tables list the members exposed by the AclINotFoundException type. 


Public Constructors 





Name 


Description 





AclNotFoundException 


Overloaded. Initializes a new instance of an AciNotFoundException object. 








Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 





Description 


(inherited from Exception ) 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 








printStackTrace 





getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 

clone (inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 








toString 


(inherited from Throwable ) 





Protected Methods 
Name 


finalize 





See Also 

Reference 
AclNotFoundException Class 
Concepts 

java.security.acl Package 





(inherited from Object ) 
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AclINotFoundException Constructor 


Initializes a new instance of an AciNotFoundException object. 


Overload List 
Name Description 


AclNotFoundException () Initializes a new instance of an AcINotFoundException object. 


AclNotFoundException (SerializationInfo, StreamingContext)|Initializes a new instance of an AcINotFoundException object duri 
ng deserialization. 





AclNotFoundException (String, Exception) Initializes a new instance of an AcINotFoundException with the gi 
ven message and inner exception. 





See Also 

Reference 
AclNotFoundException Class 
Concepts 

AclNotFoundException Members 
java.security.acl Package 
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AclINotFoundException Constructor () 


Initializes a new instance of an AciNotFoundException object. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public java.security.acl.AclNotFoundException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
AclNotFoundException Class 
Concepts 

AclNotFoundException Members 
java.security.acl Package 
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AclNotFoundException Constructor (SerializationInfo, 
StreamingContext) 


Initializes a new instance of an AciNotFoundException object during deserialization. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


protected java.security.acl.AclNotFoundException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
AclNotFoundException Class 
Concepts 

AclNotFoundException Members 
java.security.acl Package 
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AclINotFoundException Constructor (String, Exception) 


Initializes a new instance of an AcINotFoundException with the given message and inner exception. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public java.security.acl.AclNotFoundException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the exceptional condition. 
inner 
An inner exception that led to the AciNotFoundException being thrown. 


See Also 

Reference 
AclNotFoundException Class 
Concepts 

AclNotFoundException Members 
java.security.acl Package 
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AclINotFoundException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


AclNotFoundException Class 


Concepts 


java.security.acl Package 
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AclINotFoundException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
AclNotFoundException Class 
Concepts 

java.security.acl Package 
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Group Interface 


Represents a group of individuals within an Access Control List. All members of the group can be granted or denied 
permission by granting or denying the permission to the group. 


Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public interface java.security.acl.Group 
extends java.security.Principal 





See Also 

Concepts 

Group Members 
java.security.acl Package 
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Group Members 


Represents a group of individuals within an Access Control List. All members of the group can be granted or denied 
permission by granting or denying the permission to the group. 


The following tables list the members exposed by the Group type. 


Public Methods 





Name Description 

addMember Adds a member to the group. 

isMember Determines whether an individual is a member of the group. 

members Returns an Enumeration object that can be used to enumerate over the members of the group. 
removeMember |Removes a member from the group. 














See Also 

Reference 

Group Interface 
Concepts 
java.security.acl Package 
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Group Methods 


Public Methods 

















Name Description 

addMember Adds a member to the group. 

isMember Determines whether an individual is a member of the group. 

members Returns an Enumeration object that can be used to enumerate over the members of the group. 
removeMember |Removes a member from the group. 














See Also 

Reference 

Group Interface 
Concepts 
java.security.acl Package 
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Group.addMember Method 


Adds a member to the group. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean addMember( 
java.security.Principal user); 


Parameters 
user 


The person, represented by a Principal object, to add to the group. 
Return Value 
true if the user was successfully added to the group; false otherwise. 


See Also 

Reference 

Group Interface 
Concepts 

Group Members 
java.security.acl Package 
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Group.isMember Method 


Determines whether an individual is a member of the group. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean isMember( 
java.security.Principal member) ; 


Parameters 
member 


The person, represented by a Principal object, whose membership is being checked. 
Return Value 
true if the individual is a member of the group; false otherwise. 


See Also 

Reference 

Group Interface 
Concepts 

Group Members 
java.security.acl Package 
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Group.members Method 


Returns an Enumeration object that can be used to enumerate over the members of the group. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public abstract java.util.Enumeration members(); 


Return Value 
An Enumeration object that can be used to enumerate over the members of the group. 


See Also 

Reference 

Group Interface 
Concepts 

Group Members 
java.security.acl Package 
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Group.removeMember Method 


Removes a member from the group. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean removeMember ( 
java.security.Principal user); 


Parameters 
user 


The person, represented by a Principal object, to remove from the group. 
Return Value 
true if the user was successfully removed from the group; false otherwise. 


See Also 

Reference 

Group Interface 
Concepts 

Group Members 
java.security.acl Package 
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LastOwnerException Class 


The exception that is thrown when attempting to remove the last owner from an Access Control List. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 





public class java.security.acl.LastOwnerException 
extends java.lang.Exception 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.security.acl.LastOwnerException 


See Also 

Concepts 

LastOwnerException Members 
java.security.acl Package 
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LastOwnerException Members 


The exception that is thrown when attempting to remove the last owner from an Access Control List. 


The following tables list the members exposed by the LastOwnerException type. 


Public Constructors 





Name 


Description 





LastOwnerException 


Overloaded. Initializes a new instance of a LastOwnerException object. 








Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 


Description 


(inherited from Exception ) 








Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 








printStackTrace 





getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 

clone (inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 








toString 


(inherited from Throwable ) 





Protected Methods 
Name 


finalize 





See Also 

Reference 
LastOwnerException Class 
Concepts 

java.security.acl Package 





(inherited from Object ) 
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LastOwnerException Constructor 


Initializes a new instance of a LastOwnerException object. 


Overload List 
Name Description 


LastOwnerException () Initializes a new instance of a LastOwnerException object. 


LastOwnerException (SerializationInfo, StreamingContext)|Initializes a new instance of a LastOwnerException object during des 
erialization. 





LastOwnerException (String, Exception) Initializes a new instance of a LastOwnerException object during des 
erialization. 





See Also 

Reference 
LastOwnerException Class 
Concepts 

LastOwnerException Members 
java.security.acl Package 
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LastOwnerException Constructor () 


Initializes a new instance of a LastOwnerException object. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public java.security.acl.LastOwnerException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
LastOwnerException Class 
Concepts 

LastOwnerException Members 
java.security.acl Package 
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LastOwnerException Constructor (SerializationInfo, 
StreamingContext) 


Initializes a new instance of a LastOwnerException object during deserialization. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


protected java.security.acl.LastOwnerException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
LastOwnerException Class 
Concepts 

LastOwnerException Members 
java.security.acl Package 
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LastOwnerException Constructor (String, Exception) 


Initializes a new instance of a LastOwnerException object during deserialization. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public java.security.acl.LastOwnerException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the exceptional condition. 
inner 
An inner exception that led to the LastOwnerException object being thrown. 


See Also 

Reference 
LastOwnerException Class 
Concepts 

LastOwnerException Members 
java.security.acl Package 
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LastOwnerException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


LastOwnerException Class 


Concepts 


java.security.acl Package 
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LastOwnerException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
LastOwnerException Class 
Concepts 

java.security.acl Package 
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NotOwnerException Class 


The exception that is thrown when attempting to modify an Access Control List that is not owned by the caller. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 





public class java.security.acl.NotOwnerException 
extends java.lang.Exception 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.security.acl.NotOwnerException 


See Also 

Concepts 

NotOwnerException Members 
java.security.acl Package 
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NotOwnerException Members 


The exception that is thrown when attempting to modify an Access Control List that is not owned by the caller. 


The following tables list the members exposed by the NotOwnerException type. 


Public Constructors 





Name 


Description 





NotOwnerException 


Overloaded. Initializes a new instance of a NotOwnerException object. 








Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 


Description 


(inherited from Exception ) 








Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 








printStackTrace 





getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 

clone (inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 








toString 


(inherited from Throwable ) 





Protected Methods 
Name 


finalize 





See Also 

Reference 
NotOwnerException Class 
Concepts 

java.security.acl Package 





(inherited from Object ) 
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NotOwnerException Constructor 


Initializes a new instance of a NotOwnerException object. 


Overload List 
Name Description 


NotOwnerException () Initializes a new instance of a NotOwnerException object. 


NotOwnerException (Serialization|Info, StreamingContext)|Initializes a new instance of a NotOwnerException object during des 
erialization. 





NotOwnerException (String, Exception) Initializes a new instance of a NotOwnerException object with the gi 
ven message and inner exception. 





See Also 

Reference 
NotOwnerException Class 
Concepts 

NotOwnerException Members 
java.security.acl Package 
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NotOwnerException Constructor () 


Initializes a new instance of a NotOwnerException object. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 





public java.security.acl.NotOwnerException(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
NotOwnerException Class 
Concepts 

NotOwnerException Members 
java.security.acl Package 
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NotOwnerException Constructor (SerializationInfo, 
StreamingContext) 


Initializes a new instance of a NotOwnerException object during deserialization. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


protected java.security.acl.NotOwnerException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
NotOwnerException Class 
Concepts 

NotOwnerException Members 
java.security.acl Package 
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NotOwnerException Constructor (String, Exception) 


Initializes a new instance of a NotOwnerException object with the given message and inner exception. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public java.security.acl.NotOwnerException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the exceptional condition. 
inner 
An inner exception that led to the NotOwnerException being thrown. 


See Also 

Reference 
NotOwnerException Class 
Concepts 

NotOwnerException Members 
java.security.acl Package 
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NotOwnerException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


NotOwnerException Class 


Concepts 


java.security.acl Package 
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NotOwnerException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
NotOwnerException Class 
Concepts 

java.security.acl Package 
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Owner Interface 


Represents an owner of an Access Control List. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 





public interface java.security.acl.Owner 





See Also 

Concepts 

Owner Members 
java.security.acl Package 


Visual J# Reference 


Owner Members 


Represents an owner of an Access Control List. 


The following tables list the members exposed by the Owner type. 


Public Methods 


























Name Description 

addOwner Adds an owner to the Access Control List. 

deleteOwner Deletes an owner from the Access Control List. 

isOwner Determines whether an individual is an owner of an Access Control List. 
See Also 

Reference 

Owner Interface 

Concepts 


java.security.acl Package 
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Owner Methods 


Public Methods 


























Name Description 

addOwner Adds an owner to the Access Control List. 

deleteOwner Deletes an owner from the Access Control List. 

isOwner Determines whether an individual is an owner of an Access Control List. 
See Also 

Reference 

Owner Interface 

Concepts 


java.security.acl Package 
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Owner.addOwner Method 


Adds an owner to the Access Control List. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean addOwner( 
java.security.Principal caller, 
java.security.Principal owner) throws java.security.acl.NotOwnerException; 


Parameters 
caller 


The person, represented by a Principal object, attempting to add the owner to the Access Control List. 
owner 

The person, represented by a Principal object, to set as the owner of the Access Control List. 
Return Value 
true if the owner was successfully added; false otherwise. 


See Also 

Reference 

Owner Interface 
Concepts 

Owner Members 
java.security.acl Package 
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Owner.deleteOwner Method 


Deletes an owner from the Access Control List. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean deleteOwner ( 

java.security.Principal caller, 

java.security.Principal owner) throws java.security.acl.NotOwnerException, java.securit 
y.acl.LastOwnerException; 


Parameters 
caller 


The person, represented by a Principal object, attempting to delete the owner from the Access Control List. 


owner 
The person, represented by a Principal object, to delete as the owner of the Access Control List. 

Return Value 

true if the owner was successfully deleted; false otherwise. 


See Also 

Reference 

Owner Interface 
Concepts 

Owner Members 
java.security.acl Package 
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Owner.isOwner Method 


Determines whether an individual is an owner of an Access Control List. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean isOwner( 
java.security.Principal owner); 


Parameters 
owner 


The person, represented by a Principal object, whose ownership status is being determined. 
Return Value 
true if owner is an owner of the Access Control List; false otherwise. 


See Also 

Reference 

Owner Interface 
Concepts 

Owner Members 
java.security.acl Package 
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Permission Interface 


Represents a permission within an entry in the Access Control List. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 





public interface java.security.acl.Permission 





See Also 
Concepts 
Permission Members 
Permission Methods 


Visual J# Reference 


Permission Members 


Represents a permission within an entry in the Access Control List. 


The following tables list the members exposed by the Permission type. 


Public Methods 























Name Description 

equals Determines whether two Permission objects are equal. 

toString Displays a human-readable representation of a Permission object. 
See Also 

Reference 

Permission Interface 

Concepts 


java.security.acl Package 
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Permission Methods 


Public Methods 























Name Description 

equals Determines whether two Permission objects are equal. 

toString Displays a human-readable representation of a Permission object. 
See Also 

Reference 

Permission Interface 

Concepts 


java.security.acl Package 


Visual J# Reference 


Permission.equals Method 


Determines whether two Permission objects are equal. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean equals( 
java.lang.Object another) ; 


Parameters 
another 


A Permission object to compare with the current Permission object for equality. 
Return Value 
true if the two Permission objects are equal; false otherwise. 


See Also 

Reference 

Permission Interface 
Concepts 

Permission Members 
java.security.acl Package 
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Permission.toString Method 


Displays a human-readable representation of a Permission object. 
Package: java.security.acl 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String toString(); 


Return Value 
A human-readable representation of a Permission object. 


See Also 

Reference 

Permission Interface 
Concepts 

Permission Members 
java.security.acl Package 
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java.sql 


Contains the classes and interfaces used for accessing and manipulating data stored in a relational database. 


Interfaces 





Connection Represent a connection to an external database such as SQL Server. 


Visual J# Reference 


CallableStatement Interface 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public interface java.sql.CallableStatement 
extends java.sql.PreparedStatement 


See Also 

Concepts 

CallableStatement Members 
java.sql Package 
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CallableStatement Members 


The following tables list the members exposed by the CallableStatement type. 


Public Methods 
Name Description 


getBigDecimal 
getBoolean 
getByte 


getBytes 





getDate 





getDouble 





getFloat 





getint 





getLong 





getObject 





getShort 





getString 





getTime 





getTimestamp 





registerOutParameter Overloaded. 





wasNull 














See Also 
Reference 


CallableStatement Interface 
Concepts 
java.sql Package 
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CallableStatement Methods 


Public Methods 





Name 


Description 





getBigDecimal 





getBoolean 





getByte 





getBytes 





getDate 


getDouble 


getFloat 


getint 


getLong 


getObject 


getShort 


getString 


getTime 


getTimestamp 


registerOutParameter 


wasNull 





See Also 
Reference 


CallableStatement Interface 
Concepts 
java.sql Package 


Overloaded. 
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CallableStatement.getBigDecimal Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.math.BigDecimal getBigDecimal( 
int parameterIndex, 
int scale) throws java.sql.SQLException; 


Parameters 
parameterIndex 


scale 


See Also 

Reference 
CallableStatement Interface 
Concepts 

CallableStatement Members 
java.sql Package 
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CallableStatement.getBoolean Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean getBoolean( 
int parameterIndex) throws java.sql.SQLException; 


Parameters 
parameterindex 


See Also 

Reference 
CallableStatement Interface 
Concepts 

CallableStatement Members 
java.sql Package 
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CallableStatement.getByte Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract byte getByte( 
int parameterIndex) throws java.sql.SQLException; 


Parameters 
parameterindex 


See Also 

Reference 
CallableStatement Interface 
Concepts 

CallableStatement Members 
java.sql Package 
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CallableStatement.getBytes Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract byte[] getBytes( 
int parameterIndex) throws java.sql.SQLException; 


Parameters 
parameterindex 


See Also 

Reference 
CallableStatement Interface 
Concepts 

CallableStatement Members 
java.sql Package 
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CallableStatement.getDate Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.Date getDate( 
int parameterIndex) throws java.sql.SQLException; 


Parameters 
parameterindex 


See Also 

Reference 
CallableStatement Interface 
Concepts 

CallableStatement Members 
java.sql Package 
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CallableStatement.getDouble Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract double getDouble( 
int parameterIndex) throws java.sql.SQLException; 


Parameters 
parameterindex 


See Also 

Reference 
CallableStatement Interface 
Concepts 

CallableStatement Members 
java.sql Package 


Visual J# Reference 


CallableStatement.getFloat Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract float getFloat( 
int parameterIndex) throws java.sql.SQLException; 


Parameters 
parameterindex 


See Also 

Reference 
CallableStatement Interface 
Concepts 

CallableStatement Members 
java.sql Package 
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CallableStatement.getInt Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract int getInt( 
int parameterIndex) throws java.sql.SQLException; 


Parameters 
parameterindex 


See Also 

Reference 
CallableStatement Interface 
Concepts 

CallableStatement Members 
java.sql Package 
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CallableStatement.getLong Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract long getLong( 
int parameterIndex) throws java.sql.SQLException; 


Parameters 
parameterindex 


See Also 

Reference 
CallableStatement Interface 
Concepts 

CallableStatement Members 
java.sql Package 
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CallableStatement.getObject Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.Object getObject( 
int parameterIndex) throws java.sql.SQLException; 


Parameters 
parameterindex 


See Also 

Reference 
CallableStatement Interface 
Concepts 

CallableStatement Members 
java.sql Package 


Visual J# Reference 


CallableStatement.getShort Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract short getShort( 
int parameterIndex) throws java.sql.SQLException; 


Parameters 
parameterindex 


See Also 

Reference 
CallableStatement Interface 
Concepts 

CallableStatement Members 
java.sql Package 
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CallableStatement.getString Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String getString( 
int parameterIndex) throws java.sql.SQLException; 


Parameters 
parameterindex 


See Also 

Reference 
CallableStatement Interface 
Concepts 

CallableStatement Members 
java.sql Package 
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CallableStatement.getTime Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.Time getTime( 
int parameterIndex) throws java.sql.SQLException; 


Parameters 
parameterindex 


See Also 

Reference 
CallableStatement Interface 
Concepts 

CallableStatement Members 
java.sql Package 
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CallableStatement.getTimestamp Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.Timestamp getTimestamp( 
int parameterIndex) throws java.sql.SQLException; 


Parameters 
parameterindex 


See Also 

Reference 
CallableStatement Interface 
Concepts 

CallableStatement Members 
java.sql Package 
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CallableStatement.registerOutParameter Method 


Overload List 





Name Description 





CallableStatement.registerOutParameter (int, int) 





CallableStatement.registerOutParameter (int, int, int) 











See Also 

Reference 
CallableStatement Interface 
Concepts 

CallableStatement Members 
java.sql Package 
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CallableStatement.registerOutParameter Method (Int32, Int32) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract void registerOutParameter( 
int parameterIndex, 
int sqlType) throws java.sql.SQLException; 


Parameters 
parameterIndex 


sqlType 


See Also 

Reference 
CallableStatement Interface 
Concepts 

CallableStatement Members 
java.sql Package 
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CallableStatement.registerOutParameter Method (Int32, Int32, 
Int32) 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract void registerOutParameter( 
int parameterIndex, 
int sqlType, 
int scale) throws java.sql.SQLException; 


Parameters 
parameterindex 


sqlType 
scale 


See Also 

Reference 
CallableStatement Interface 
Concepts 

CallableStatement Members 
java.sql Package 
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CallableStatement.wasNull Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean wasNull() throws java.sql.SQLException; 


See Also 

Reference 
CallableStatement Interface 
Concepts 

CallableStatement Members 
java.sql Package 
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Connection Interface 


Represents a connection to an external database such as SQL Server. 
Package: java.sq 


Assembly: vjslib (in vjslib.dll) 





public interface java.sql.Connection 





See Also 

Concepts 

Connection Members 
java.sql Package 
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Connection Members 


Represents a connection to an external database such as SQL Server. 


The following tables list the members exposed by the Connection type. 


Public Fields 





Name Description 





TRANSACTION_NONE If you do not set the transaction isolation or you set it to TRANSACTION_NONE, the tra 
nsaction executes according to the default isolation level of the underlying ODBC drive 
r. 





TRANSACTION_READ_COMMITTED _ |Shared locks are held while the data is being read to avoid dirty reads, but the data can 
be changed before the end of the transaction, resulting in non-repeatable reads or pha 
ntom data. 





TRANSACTION_READ_UNCOMMITTEDIA dirty read is possible, meaning that no shared locks are issued and no exclusive locks 
are honored. 





TRANSACTION_REPEATABLE_READ __ |Locks are placed on all data that is used in a query, preventing other users from updati 


ng the data. Prevents non-repeatable reads but phantom rows are still possible. 





TRANSACTION_SERIALIZABLE A range lock is placed on the dataset, preventing other users from updating or insertin 
g rows into the dataset until the transaction is complete. 





Public Methods 


Name Description 

clearWarnings Clears all warnings reported by calls on this connection. 

close Closes the connection to the database. 

commit Commits all transactions called on the database since the last commit. 

createStatement Creates a new instance of a Statement object that represents a statement to call on the database. 
getAutoCommit Gets a value determining whether transactions are being automatically committed. 

getCatalog Gets the name of the database associated with this connection. 

getMetaData Gets the metadata associated with the database that this connection is using. 


getTransactionlsolation|Gets a value representing the transaction locking behavior for this connection. 











getWarnings Gets all warnings reported by calls on this connection. 

isClosed Determines whether the connection to the database is closed. 

isReadOnly Determines whether the connection to the database is read-only. 

nativeSQL Gets the SQL command that will be passed to the database server, after any preprocessing by the data 


base driver. The behavior of this method is database dependent. 














prepareCall 


prepareStatement 


rollback 


setAutoCommit 


setCatalog 


setReadOnly 


setTransactionlsolation 


Generates an instance of a CallableStatement object representing a SQL command that can be called o 
n the database. 


Generates an instance of a PreparedStatement object representing a SQL command that will likely be c 
alled on the database many times. This is a hint to the database server to optimize the statement by do 
ing a precompilation of the statement. 


Undoes all transactions called on the database since the last commit operation. 
Sets a value determining whether transactions are being automatically committed. 
Sets the name of the database associated with this connection. 

Sets a value determining whether the connection to the database is read-only. 


Sets a value representing the transaction locking behavior for this connection. 














See Also 
Reference 
Connection Interface 
Concepts 

java.sql Package 
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Connection Fields 


Public Fields 





Name 


Description 





TRANSACTION_NONE 


If you do not set the transaction isolation or you set it to TRANSACTION_NONE, the tra 
nsaction executes according to the default isolation level of the underlying ODBC drive 
r. 





TRANSACTION_READ_COMMITTED 


Shared locks are held while the data is being read to avoid dirty reads, but the data can 
be changed before the end of the transaction, resulting in non-repeatable reads or pha 








TRANSACTION_REPEATABLE_READ 


TRANSACTION_SERIALIZABLE 








Locks are placed on all data that is used in a query, preventing other users from updati 
ng the data. Prevents non-repeatable reads but phantom rows are still possible. 


A range lock is placed on the dataset, preventing other users from updating or insertin 
g rows into the dataset until the transaction is complete. 








See Also 
Reference 
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Connection. TRANSACTION NONE Field 


If you do not set the transaction isolation or you set it to TRANSACTION_NONE, the transaction executes according to the 
default isolation level of the underlying ODBC driver. 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int TRANSACTION_NONE; 


See Also 

Reference 
Connection Interface 
Concepts 

Connection Members 
java.sql Package 


Visual J# Reference 


Connection. TRANSACTION_READ_COMMITTED Field 


Shared locks are held while the data is being read to avoid dirty reads, but the data can be changed before the end of the 
transaction, resulting in non-repeatable reads or phantom data. 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int TRANSACTION_READ COMMITTED; 


See Also 

Reference 
Connection Interface 
Concepts 

Connection Members 
java.sql Package 


Visual J# Reference 


Connection. TRANSACTION_READ_ UNCOMMITTED Field 


A dirty read is possible, meaning that no shared locks are issued and no exclusive locks are honored. 
Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int TRANSACTION_READ_UNCOMMITTED; 


See Also 

Reference 
Connection Interface 
Concepts 

Connection Members 
java.sql Package 


Visual J# Reference 


Connection. TRANSACTION_REPEATABLE_READ Field 


Locks are placed on all data that is used in a query, preventing other users from updating the data. Prevents non-repeatable 
reads but phantom rows are still possible. 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int TRANSACTION_REPEATABLE_READ; 


See Also 

Reference 
Connection Interface 
Concepts 

Connection Members 
java.sql Package 
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Connection. TRANSACTION_SERIALIZABLE Field 


A range lock is placed on the dataset, preventing other users from updating or inserting rows into the dataset until the 
transaction is complete. 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int TRANSACTION _SERIALIZABLE; 


See Also 

Reference 
Connection Interface 
Concepts 

Connection Members 
java.sql Package 
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Connection Methods 


Public Methods 





Name 


Description 





clearWarnings 


Clears all warnings reported by calls on this connection. 











close Closes the connection to the database. 
commit Commits all transactions called on the database since the last commit. 
createStatement Creates a new instance of a Statement object that represents a statement to call on the database. 





getAutoCommit 


getCatalog 


getMetaData 


getTransactionlsolation 


getWarnings 


Gets a value determining whether transactions are being automatically committed. 
Gets the name of the database associated with this connection. 

Gets the metadata associated with the database that this connection is using. 

Gets a value representing the transaction locking behavior for this connection. 


Gets all warnings reported by calls on this connection. 





setAutoCommit 


setCatalog 


setReadOnly 


isClosed Determines whether the connection to the database is closed. 

isReadOnly Determines whether the connection to the database is read-only. 

nativeSQL Gets the SQL command that will be passed to the database server, after any preprocessing by the data 
base driver. The behavior of this method is database dependent. 

prepareCall Generates an instance of a CallableStatement object representing a SQL command that can be called o 
n the database. 

prepareStatement Generates an instance of a PreparedStatement object representing a SQL command that will likely be c 
alled on the database many times. This is a hint to the database server to optimize the statement by do 
ing a precompilation of the statement. 

rollback Undoes all transactions called on the database since the last commit operation. 


Sets a value determining whether transactions are being automatically committed. 


Sets the name of the database associated with this connection. 


Sets a value determining whether the connection to the database is read-only. 





setTransactionlsolation 








Sets a value representing the transaction locking behavior for this connection. 








See Also 
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Connection.clearWarnings Method 


Clears all warnings reported by calls on this connection. 
Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract void clearWarnings() throws java.sql.SQLException; 


See Also 

Reference 
Connection Interface 
Concepts 

Connection Members 
java.sql Package 


Visual J# Reference 


Connection.close Method 


Closes the connection to the database. 
Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 





public abstract void close() throws java.sql.SQLException; 





See Also 

Reference 
Connection Interface 
Concepts 

Connection Members 
java.sql Package 
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Connection.commit Method 


Commits all transactions called on the database since the last commit. 
Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract void commit() throws java.sql.SQLException; 


See Also 

Reference 
Connection Interface 
Concepts 

Connection Members 
java.sql Package 
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Connection.createStatement Method 


Creates a new instance of a Statement object that represents a statement to call on the database. 
Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.Statement createStatement() throws java.sql.SQLException; 


Return Value 
A new instance of a Statement object that represents a statement to call on the database. 


See Also 

Reference 
Connection Interface 
Concepts 

Connection Members 
java.sql Package 
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Connection.getAutoCommit Method 


Gets a value determining whether transactions are being automatically committed. 
Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean getAutoCommit() throws java.sql.SQLException; 


Return Value 
true if transactions are being automatically committed; false otherwise. 


See Also 

Reference 
Connection Interface 
Concepts 

Connection Members 
java.sql Package 
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Connection.getCatalog Method 


Gets the name of the database associated with this connection. 
Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String getCatalog() throws java.sql.SQLException; 


Return Value 
The name of the database associated with this connection. 


See Also 

Reference 
Connection Interface 
Concepts 

Connection Members 
java.sql Package 
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Connection.getMetaData Method 


Gets the metadata associated with the database that this connection is using. 
Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.DatabaseMetaData getMetaData() throws java.sql.SQLException; 


Return Value 


An instance of a DatabaseMetaData object that represents the metadata associated with the database that this connection is 
using. 


See Also 

Reference 
Connection Interface 
Concepts 

Connection Members 
java.sql Package 


Visual J# Reference 


Connection.getTransactionlsolation Method 


Gets a value representing the transaction locking behavior for this connection. 
Package: java.sq 


Assembly: vjslib (in vjslib.dll) 





public abstract int getTransactionIsolation() throws java.sql.SQLException; 





Return Value 


A value representing the transaction locking behavior for this connection. Valid values are TRANSACTION_NONE, 
TRANSACTION_READ_UNCOMMITTED, TRANSACTION_READ_COMMITTED, TRANSACTION_REPEATABLE_READ, and 
TRANSACTION_SERIALIZABLE. 


See Also 

Reference 
Connection Interface 
Concepts 

Connection Members 
java.sql Package 


Visual J# Reference 


Connection.getWarnings Method 


Gets all warnings reported by calls on this connection. 
Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.SQLWarning getWarnings() throws java.sql.SQLException; 


Return Value 
An instance of a SQLWarning object containing all warnings reported by calls on this connection. 


See Also 

Reference 
Connection Interface 
Concepts 

Connection Members 
java.sql Package 
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Connection.isClosed Method 


Determines whether the connection to the database is closed. 
Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean isClosed() throws java.sql.SQLException; 


Return Value 
true if the connection to the database is closed; false otherwise. 


See Also 

Reference 
Connection Interface 
Concepts 

Connection Members 
java.sql Package 
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Connection.isReadOnly Method 


Determines whether the connection to the database is read-only. 
Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean isReadOnly() throws java.sql.SQLException; 


Return Value 
true if the connection to the database is read-only; false otherwise. 


See Also 

Reference 
Connection Interface 
Concepts 

Connection Members 
java.sql Package 
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Connection.nativeSQL Method 


Gets the SQL command that will be passed to the database server, after any preprocessing by the database driver. The 
behavior of this method is database dependent. 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String nativeSQL( 
java.lang.String sql) throws java.sql.SQLException; 


Parameters 


sql 
The SQL command passed to the database driver. 
Return Value 
The SQL command that will be passed to the database server, after any preprocessing. 


See Also 

Reference 
Connection Interface 
Concepts 

Connection Members 
java.sql Package 
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Connection.prepareCall Method 


Generates an instance of a CallableStatement object representing a SQL command that can be called on the database. 
Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.CallableStatement prepareCall( 
java.lang.String sql) throws java.sql.SQLException; 


Parameters 
sql 

The SQL command to call on the database. 
Return Value 


An instance of a CallableStatement object representing a SQL command that can be called on the database. 


See Also 

Reference 
Connection Interface 
Concepts 

Connection Members 
java.sql Package 
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Connection.prepareStatement Method 


Generates an instance of a PreparedStatement object representing a SQL command that will likely be called on the database 
many times. This is a hint to the database server to optimize the statement by doing a precompilation of the statement. 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.PreparedStatement prepareStatement( 
java.lang.String sql) throws java.sql.SQLException; 


Parameters 


sql 
The SQL command to call on the database. 
Return Value 
An instance of a PreparedStatement object representing a SQL command that will likely be called on the database many times. 


See Also 

Reference 
Connection Interface 
Concepts 

Connection Members 
java.sql Package 
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Connection.rollback Method 


Undoes all transactions called on the database since the last commit operation. 
Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract void rollback() throws java.sql.SQLException; 


See Also 

Reference 
Connection Interface 
Concepts 

Connection Members 
java.sql Package 
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Connection.setAutoCommit Method 


Sets a value determining whether transactions are being automatically committed. 
Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract void setAutoCommit( 
boolean autoCommit) throws java.sql.SQLException; 


Parameters 
autoCommit 


true to automatically commit transactions; false otherwise. 


See Also 

Reference 
Connection Interface 
Concepts 

Connection Members 
java.sql Package 
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Connection.setCatalog Method 


Sets the name of the database associated with this connection. 
Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract void setCatalog( 
java.lang.String catalog) throws java.sql.SQLException; 


Parameters 
catalog 


The name of the database associated with this connection. 


See Also 

Reference 
Connection Interface 
Concepts 

Connection Members 
java.sql Package 


Visual J# Reference 


Connection.setReadOnly Method 


Sets a value determining whether the connection to the database is read-only. 
Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract void setReadOnly( 
boolean readOnly) throws java.sql.SQLException; 


Parameters 


readOnly 
true to make the connection to the database read-only; false otherwise. 


See Also 

Reference 
Connection Interface 
Concepts 

Connection Members 
java.sql Package 
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Connection.setTransactionlsolation Method 


Sets a value representing the transaction locking behavior for this connection. 
Package: java.sq 


Assembly: vjslib (in vjslib.dll) 





public abstract void setTransactionIsolation( 
int transactionIsolation) throws java.sql.SQLException; 





Parameters 
transactionlsolation 


A value representing the transaction locking behavior for this connection. Valid values are TRANSACTION_NONE, 
TRANSACTION_READ_UNCOMMITTED, TRANSACTION_READ_COMMITTED, TRANSACTION_REPEATABLE_READ, and 
TRANSACTION_SERIALIZABLE. 


See Also 

Reference 
Connection Interface 
Concepts 

Connection Members 
java.sql Package 
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DatabaseMetaData Interface 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public interface java.sql.DatabaseMetaData 


See Also 

Concepts 

DatabaseMetaData Members 
java.sql Package 
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DatabaseMetaData Members 


The following tables list the members exposed by the DatabaseMetaData type. 


Public Fields 
Name Description 


bestRowNotPseudo 
bestRowPseudo 
bestRowSession 


bestRowTemporary 





bestRowTransaction 





bestRowUnknown 





columnNoNulls 





columnNullable 





columnNullableUnknown 





importedKeyCascade 





importedKeylnitiallyDeferred 





importedKeyInitiallyimmediate 





importedKeyNoAction 





importedKeyNotDeferrable 





importedKeyRestrict 





importedKeySetDefault 





importedKeySetNull 





procedureColumnin 





procedureColumnInOut 


procedureColumnOut 


procedureColumnResult 


procedureColumnReturn 


procedureColumnUnknown 














procedureNoNulls 





procedureNoResult 





procedureNullable 





procedureNullableUnknown 





procedureResultUnknown 





procedureReturnsResult 





tablelndexClustered 





tablelndexHashed 


tablelndexOther 


tablelndexStatistic 


typeNoNulls 


typeNullable 


typeNullableUnknown 


typePredBasic 


typePredChar 


typePredNone 


typeSearchable 


versionColumnNotPseudo 


versionColumnPseudo 


versionColumnUnknown 


Public Methods 








Name 


Description 





allProceduresAreCallable 





allTablesAreSelectable 


dataDefinitionCausesTransactionCommit 


dataDefinitionlgnoredInTransactions 


doesMaxRowSizelncludeBlobs 











getBestRowldentifier 





getCatalogs 





getCatalogSeparator 





getCatalogTerm 





getColumnPrivileges 





getColumns 





getCrossReference 





getDatabaseProductName 
getDatabaseProductVersion 
getDefaultTransactionlsolation 
getDriverMajorVersion 
getDriverMinorVersion 
getDriverName 
getDriverVersion 
getExportedKeys 
getExtraNameCharacters 
getidentifierQuoteString 
getlmportedKeys 
getindexinfo 
getMaxBinaryLiteralLength 
getMaxCatalogNameLength 
getMaxCharLiteralLength 


getMaxColumnNameLength 





getMaxColumnsInGroupBy 





getMaxColumnsInIndex 





getMaxColumnsInOrderBy 








getMaxColumnsInSelect 











getMaxColumnsInTable 





getMaxConnections 


getMaxCursorNameLength 


getMaxIndexLength 


getMaxProcedureNameLength 


getMaxRowSize 


getMaxSchemaNameLength 


getMaxStatementLength 





getMaxStatements 





getMaxTableNameLength 





getMaxTablesInSelect 





getMaxUserNameLength 





getNumericFunctions 





getPrimaryKeys 





getProcedureColumns 





getProcedures 





getProcedureTerm 





getSchemas 





getSchemaTerm 





getSearchStringEscape 





getSQLKeywords 





getStringFunctions 








getSystemFunctions 


getTablePrivileges 


getTables 


getTableTypes 


getTimeDateFunctions 








getTypelnfo 





getURL 


getUserName 
getVersionColumns 
isCatalogAtStart 
isReadOnly 
nullPlusNonNulllsNull 


nullsAreSortedAtEnd 





nullsAreSortedAtStart 





nullsAreSortedHigh 





nullsAreSortedLow 





storesLowerCaseldentifiers 





storesLowerCaseQuotedidentifiers 





storesMixedCaseldentifiers 





storesMixedCaseQuotedidentifiers 





storesUpperCaseldentifiers 





storesUpperCaseQuotedidentifiers 





supportsAlterTableWithAddColumn 





supportsAlterTableWithDropColumn 





supportsANSI92EntryLevelSQL 





supportsANSI92FullSQL 





supportsANSI92IntermediateSQL 








supportsCatalogsInDataManipulation 


supportsCatalogsInIndexDefinitions 


supportsCatalogsInPrivilegeDefinitions 


supportsCatalogsInProcedureCalls 


supportsCatalogsInTableDefinitions 








supportsColumnAliasing 





supportsConvert 


supportsCoreSQLGrammar 


supportsCorrelatedSubqueries 


supportsDataDefinitionAndDataManipulationTransactions 


supports DataManipulationTransactionsOnly 


supports DifferentTableCorrelationNames 


supportsExpressionsInOrderBy 


Overloaded. 





supportsExtendedSQLGrammar 





supportsFullOuterJoins 





supportsGroupBy 





supportsGroupByBeyondSelect 





supportsGroupByUnrelated 





supportsIntegrityEnhancementFacility 





supportsLikeEscapeClause 





supportsLimitedOuterJoins 





supportsMinimumSQLGrammar 





supportsMixedCaseldentifiers 





supportsMixedCaseQuotedidentifiers 





supportsMultipleResultS ets 





supportsMultipleTransactions 





supportsNonNullableColumns 








supportsOpenCursorsAcrossCommit 


supportsOpenCursorsAcrossRollback 


supportsOpenStatementsAcrossCommit 


supportsOpenStatementsAcrossRollback 








supportsOrderByUnrelated 





supportsOuterJoins 





supportsPositionedDelete 





supportsPositionedUpdate 





supportsSchemasInDataManipulation 





supportsSchemasinIndexDefinitions 





supportsSchemasInPrivilegeDefinitions 





supportsSchemas|nProcedureCalls 
supportsSchemasinTableDefinitions 
supportsSelectForUpdate 
supportsStoredProcedures 
supportsSubqueriesInComparisons 
supportsSubqueries|nExists 
supportsSubqueriesinIns 
supportsSubqueriesInQuantifieds 
supportsTableCorrelationNames 
supportsTransactionlsolationLevel 
supports Transactions 
supportsUnion 

supportsUnionAll 
usesLocalFilePerTable 


usesLocalFiles 





See Also 
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DatabaseMetaData Fields 


Public Fields 





Name Description 





bestRowNotPseudo 





bestRowPseudo 





bestRowSession 





bestRowTemporary 





bestRowTransaction 


bestRowUnknown 


columnNoNulls 


columnNullable 


columnNullableUnknown 


importedKeyCascade 


importedKeylnitially Deferred 


importedKeyInitiallylmmediate 


importedKeyNoAction 


importedKeyNotDeferrable 


importedKeyRestrict 


importedKeySetDefault 


importedKeySetNull 


procedureColumnin 


procedureColumninOut 


procedureColumnOut 





procedureColumnResult 





procedureColumnReturn 





procedureColumnUnknown 





procedureNoNulls 

















procedureNoResult 





procedureNullable 





procedureNullableUnknown 





procedureResultUnknown 





procedureReturnsResult 





tablelndexClustered 





tablelndexHashed 





tablelndexOther 
tablelndexS tatistic 
typeNoNulls 
typeNullable 
typeNullableUnknown 
typePredBasic 
typePredChar 
typePredNone 
typeSearchable 
versionColumnNotPseudo 
versionColumnPseudo 


versionColumnUnknown 





See Also 

Reference 
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DatabaseMetaData.bestRowNotPseudo Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int bestRowNotPseudo; 


See Also 

Reference 
DatabaseMetaData Interface 
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DatabaseMetaData.bestRowPseudo Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int bestRowPseudo; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 
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DatabaseMetaData.bestRowSession Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int bestRowSession; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 
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DatabaseMetaData.bestRowTemporary Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int bestRowTemporary; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 
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DatabaseMetaData.bestRowTransaction Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int bestRowTransaction; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 
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DatabaseMetaData.bestRowUnknown Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int bestRowUnknown; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 
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DatabaseMetaData.columnNoNulls Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int columnNoNulls; 


See Also 

Reference 
DatabaseMetaData Interface 
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DatabaseMetaData Members 
java.sql Package 
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DatabaseMetaData.columnNullable Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int columnNullable; 


See Also 

Reference 
DatabaseMetaData Interface 
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DatabaseMetaData Members 
java.sql Package 
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DatabaseMetaData.columnNullableUnknown Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int columnNullableUnknown; 


See Also 

Reference 
DatabaseMetaData Interface 
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DatabaseMetaData.importedKeyCascade Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int importedKeyCascade; 


See Also 

Reference 
DatabaseMetaData Interface 
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DatabaseMetaData Members 
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Visual J# Reference 


DatabaseMetaData.importedKeylnitiallyDeferred Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int importedKeyInitiallyDeferred; 


See Also 

Reference 
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DatabaseMetaData.importedKeyInitiallylmmediate Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int importedKeyInitiallyImmediate; 


See Also 

Reference 
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DatabaseMetaData.importedKeyNodAction Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int importedKeyNoAction; 


See Also 

Reference 
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DatabaseMetaData.importedKeyNotDeferrable Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int importedKeyNotDeferrable; 


See Also 

Reference 
DatabaseMetaData Interface 
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DatabaseMetaData.importedKeyRestrict Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int importedKeyRestrict; 


See Also 

Reference 
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DatabaseMetaData.importedKeySetDefault Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int importedKeySetDefault; 


See Also 

Reference 
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DatabaseMetaData.importedKeySetNull Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int importedKeySetNull1; 


See Also 

Reference 
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DatabaseMetaData.procedureColumnin Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int procedureColumnin; 


See Also 

Reference 
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DatabaseMetaData.procedureColumnInOut Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int procedureColumnInOut; 


See Also 

Reference 
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DatabaseMetaData.procedureColumnOut Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int procedureColumnOut; 


See Also 

Reference 
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DatabaseMetaData.procedureColumnResult Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int procedureColumnResult; 


See Also 

Reference 
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Concepts 
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DatabaseMetaData.procedureColumnReturn Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int procedureColumnReturn; 


See Also 
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Visual J# Reference 


DatabaseMetaData.procedureColumnUnknown Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int procedureColumnUnknown ; 


See Also 
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DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.procedureNoNulls Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int procedureNoNulls; 


See Also 
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DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.procedureNoResult Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int procedureNoResult; 


See Also 

Reference 
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DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.procedureNullable Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int procedureNullable; 


See Also 
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DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.procedureNullableUnknown Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int procedureNullableUnknown; 


See Also 

Reference 
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DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.procedureResultUnknown Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int procedureResultUnknown ; 


See Also 

Reference 
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DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.procedureReturnsResult Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int procedureReturnsResult; 


See Also 

Reference 
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DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.tablelndexClustered Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final short tableIndexClustered; 


See Also 
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DatabaseMetaData Members 
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Visual J# Reference 


DatabaseMetaData.tablelndexHashed Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final short tableIndexHashed; 


See Also 
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DatabaseMetaData Interface 
Concepts 
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Visual J# Reference 


DatabaseMetaData.tablelndexOther Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final short tableIndexOther; 


See Also 
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DatabaseMetaData Members 
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Visual J# Reference 


DatabaseMetaData.tablelndexStatistic Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final short tableIndexStatistic; 


See Also 
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Visual J# Reference 


DatabaseMetaData.typeNoNulls Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int typeNoNulls; 


See Also 
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DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.typeNullable Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int typeNullable; 


See Also 
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DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.typeNullableUnknown Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int typeNullableUnknown; 


See Also 

Reference 
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DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.typePredBasic Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int typePredBasic; 


See Also 
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Visual J# Reference 


DatabaseMetaData.typePredChar Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int typePredChar; 


See Also 

Reference 
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java.sql Package 


Visual J# Reference 


DatabaseMetaData.typePredNone Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int typePredNone; 


See Also 

Reference 
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Visual J# Reference 


DatabaseMetaData.typeSearchable Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int typeSearchable; 


See Also 

Reference 
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Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.versionColumnNotPseudo Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int versionColumnNotPseudo; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.versionColumnPseudo Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int versionColumnPseudo; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.versionColumnUnknown Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int versionColumnUnknown; 


See Also 
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DatabaseMetaData Members 
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Visual J# Reference 


DatabaseMetaData Methods 


Public Methods 





Name 


Description 





allProceduresAreCallable 





allTablesAreSelectable 





dataDefinitionCausesTransactionCommit 





dataDefinitionlgnoredinTransactions 





doesMaxRowSizelncludeBlobs 


getBestRowldentifier 


getCatalogs 


getCatalogSeparator 


getCatalogTerm 


getColumnPrivileges 


getColumns 


getCrossReference 


getDatabaseProductName 


getDatabaseProductVersion 


getDefaultTransactionlsolation 


getDriverMajorVersion 


getDriverMinorVersion 


getDriverName 


getDriverVersion 


getExportedKeys 





getExtraNameCharacters 





getidentifierQuoteString 





getimportedKeys 





getindexinfo 














getMaxBinaryLiteralLength 





getMaxCatalogNameLength 





getMaxCharLiteralLength 





getMaxColumnNameLength 





getMaxColumns|InGroupBy 





getMaxColumnsInIndex 





getMaxColumnsInOrderBy 





getMaxColumnsInSelect 
getMaxColumnsInTable 
getMaxConnections 
getMaxCursorNameLength 
getMaxIndexLength 
getMaxProcedureNameLength 
getMaxRowSize 
getMaxSchemaNameLength 
getMaxStatementLength 
getMaxStatements 
getMaxTableNameLength 
getMaxTablesinSelect 
getMaxUserNameLength 
getNumericFunctions 
getPrimaryKeys 


getProcedureColumns 





getProcedures 





getProcedureTerm 





getSchemas 








getSchemaTerm 











getSearchStringEscape 





getSQLKeywords 





getStringFunctions 





getSystemFunctions 





getTablePrivileges 





getTables 





getTableTypes 





getTimeDateFunctions 
getTypelnfo 

getURL 

getUserName 
getVersionColumns 
isCatalogAtStart 
isReadOnly 
nullPlusNonNulllsNull 
nullsAreSortedAtEnd 
nullsAreSortedAtStart 
nullsAreSortedHigh 
nullsAreSortedLow 
storesLowerCaseldentifiers 
storesLowerCaseQuotedidentifiers 
storesMixedCaseldentifiers 


storesMixedCaseQuotedlidentifiers 





storesUpperCaseldentifiers 





storesUpperCaseQuotedidentifiers 





supportsAlterTableWithAddColumn 








supportsAlterTableWithDropColumn 











supportsANSI92EntryLevelSQL 





supportsANSI92FullSQL 





supportsANSI92IntermediateSQL 





supportsCatalogsInDataManipulation 





supportsCatalogsInIndexDefinitions 





supportsCatalogsInPrivilegeDefinitions 





supportsCatalogsInProcedureCalls 





supportsCatalogsInTableDefinitions 


supportsColumnAliasing 


supportsConvert 


supportsCoreSQLGrammar 


supportsCorrelatedSubqueries 


supportsDataDefinitionAndDataManipulationTransactions 


supports DataManipulationTransactionsOnly 


supportsDifferentTableCorrelationNames 


supportsExpressionsInOrderBy 


supportsExtendedSQLGrammar 


supportsFullOuterJoins 


supportsGroupBy 


supportsGroupByBeyondSelect 


supportsGroupByUnrelated 


supportsIntegrityEnhancementFacility 


supportsLikeEscapeClause 


Overloaded. 





supportsLimitedOuterJoins 





supportsMinimumSQLGrammar 





supportsMixedCaseldentifiers 








supportsMixedCaseQuotedidentifiers 











supportsMultipleResultS ets 





supportsMultipleTransactions 





supportsNonNullableColumns 





supportsOpenCursorsAcrossCommit 





supportsOpenCursorsAcrossRollback 





supportsOpenStatementsAcrossCommit 





supportsOpenStatementsAcrossRollback 





supportsOrderByUnrelated 


supportsOuterJoins 


supportsPositionedDelete 


supportsPositionedUpdate 


supportsSchemasInDataManipulation 


supportsSchemasinIndexDefinitions 


supportsSchemasinPrivilegeDefinitions 


supportsSchemasInProcedureCalls 


supportsSchemasinTableDefinitions 


supportsSelectForUpdate 


supportsStoredProcedures 


supportsSubqueriesInComparisons 


supportsSubqueriesInExists 


supportsSubqueriesinIns 


supportsSubqueries|nQuantifieds 


supportsTableCorrelationNames 





supportsTransactionlsolationLevel 





supportsTransactions 





supportsUnion 








supportsUnionAll 











usesLocalFilePerTable 





usesLocalFiles 











See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

java.sql Package 


Visual J# Reference 


DatabaseMetaData.allProceduresAreCallable Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean allProceduresAreCallable() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.allTablesAreSelectable Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean allTablesAreSelectable() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.dataDefinitionCausesTransactionCommit 
Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean dataDefinitionCausesTransactionCommit() throws java.sql.SQLExceptio 
ns 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.dataDefinitionlgnoredInTransactions 
Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean dataDefinitionIgnoredInTransactions() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.doesMaxRowSizelncludeBlobs Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean doesMaxRowSizeIncludeBlobs() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getBestRowldentifier Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.ResultSet getBestRowIdentifier( 
java.lang.String catalog, 
java.lang.String schema, 
java.lang.String table, 
int scope, 
boolean nullable) throws java.sql.SQLException; 


Parameters 
catalog 


schema 
table 
scope 
nullable 


See Also 
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java.sql Package 


Visual J# Reference 


DatabaseMetaData.getCatalogs Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.ResultSet getCatalogs() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getCatalogSeparator Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String getCatalogSeparator() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getCatalogTerm Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String getCatalogTerm() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getColumnPrivileges Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.ResultSet getColumnPrivileges( 
java.lang.String catalog, 
java.lang.String schema, 
java.lang.String table, 
java.lang.String colNamePattern) throws java.sql.SQLException; 


Parameters 
catalog 


schema 
table 
colNamePattern 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getColumns Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.ResultSet getColumns( 
java.lang.String catalog, 
java.lang.String schemaPattern, 
java.lang.String tableNamePattern, 
java.lang.String columnNamePattern) throws java.sql.SQLException; 


Parameters 
catalog 


schemaPattern 
tableNamePattern 
columnNamePattern 


See Also 
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DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getCrossReference Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.ResultSet getCrossReference( 
java.lang.String primaryCatalog, 
java.lang.String primarySchema, 
java.lang.String primaryTable, 
java.lang.String foreignCatalog, 
java.lang.String foreignSchema, 
java.lang.String foreignTable) throws java.sql.SQLException; 


Parameters 
primaryCatalog 


primarySchema 
primaryTable 
foreignCatalog 
foreignSchema 
foreignTable 


See Also 
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java.sql Package 


Visual J# Reference 


DatabaseMetaData.getDatabaseProductName Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String getDatabaseProductName() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getDatabaseProductVersion Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String getDatabaseProductVersion() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getDefaultTransactionlsolation Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract int getDefaultTransactionIsolation() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getDriverMajorVersion Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract int getDriverMajorVersion(); 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getDriverMinorVersion Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract int getDriverMinorVersion(); 


See Also 

Reference 
DatabaseMetaData Interface 
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DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getDriverName Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String getDriverName() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getDriverVersion Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String getDriverVersion() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getExportedKeys Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.ResultSet getExportedKeys( 
java.lang.String catalog, 
java.lang.String schema, 
java.lang.String table) throws java.sql.SQLException; 


Parameters 
catalog 


schema 
table 


See Also 

Reference 
DatabaseMetaData Interface 
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DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getExtraNameCharacters Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String getExtraNameCharacters() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getldentifierQuoteString Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String getIdentifierQuoteString() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getlmportedKeys Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.ResultSet getImportedKeys( 
java.lang.String catalog, 
java.lang.String schema, 
java.lang.String table) throws java.sql.SQLException; 


Parameters 
catalog 


schema 
table 


See Also 

Reference 
DatabaseMetaData Interface 
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DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getIndexInfo Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.ResultSet getIndexInfo( 
java.lang.String catalog, 
java.lang.String schema, 
java.lang.String table, 
boolean unique, 
boolean approximate) throws java.sql.SQLException; 


Parameters 
catalog 


schema 
table 

unique 
approximate 


See Also 

Reference 
DatabaseMetaData Interface 
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DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getMaxBinaryLiteralLength Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract int getMaxBinaryLiteralLength() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getMaxCatalogNameLength Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract int getMaxCatalogNameLength() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getMaxCharLiteralLength Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract int getMaxCharLiteralLength() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getMaxColumnNameLength Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract int getMaxColumnNameLength() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getMaxColumnsInGroupBy Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract int getMaxColumnsInGroupBy() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getMaxColumnsInIndex Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract int getMaxColumnsInIndex() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getMaxColumnsInOrderBy Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract int getMaxColumnsInOrderBy() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getMaxColumnsInSelect Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract int getMaxColumnsInSelect() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getMaxColumnsInTable Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract int getMaxColumnsInTable() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getMaxConnections Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract int getMaxConnections() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getMaxCursorNameLength Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract int getMaxCursorNameLength() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getMaxIndexLength Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract int getMaxIndexLength() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getMaxProcedureNameLength Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract int getMaxProcedureNameLength() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getMaxRowSize Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract int getMaxRowSize() throws java.sql.SQLException; 


See Also 

Reference 
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DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getMaxSchemaNameLength Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract int getMaxSchemaNameLength() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getMaxStatementLength Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract int getMaxStatementLength() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getMaxStatements Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract int getMaxStatements() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getMaxTableNameLength Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract int getMaxTableNameLength() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getMaxTablesInSelect Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract int getMaxTablesInSelect() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getMaxUserNameLength Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract int getMaxUserNameLength() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
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DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getNumericFunctions Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String getNumericFunctions() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getPrimaryKeys Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.ResultSet getPrimaryKeys( 
java.lang.String catalog, 
java.lang.String schema, 
java.lang.String table) throws java.sql.SQLException; 


Parameters 
catalog 


schema 
table 


See Also 

Reference 
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DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getProcedureColumns Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.ResultSet getProcedureColumns( 
java.lang.String catalog, 
java.lang.String schemaPattern, 
java.lang.String procedureNamePattern, 
java.lang.String columnNamePattern) throws java.sql.SQLException; 


Parameters 
catalog 


schemaPattern 
procedureNamePattern 
columnNamePattern 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getProcedures Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.ResultSet getProcedures( 
java.lang.String catalog, 
java.lang.String schemaPattern, 
java.lang.String procedureNamePattern) throws java.sql.SQLException; 


Parameters 
catalog 


schemaPattern 
procedureNamePattern 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getProcedureTerm Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String getProcedureTerm() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getSchemas Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.ResultSet getSchemas() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getSchemaTerm Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String getSchemaTerm() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getSearchStringEscape Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String getSearchStringEscape() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getSQLKeywords Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String getSQLKeywords() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getStringFunctions Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String getStringFunctions() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getSystemFunctions Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String getSystemFunctions() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getTablePrivileges Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.ResultSet getTablePrivileges( 
java.lang.String catalog, 
java.lang.String schemaPattern, 
java.lang.String tableNamePattern) throws java.sql.SQLException; 


Parameters 
catalog 


schemaPattern 
tableNamePattern 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getTables Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.ResultSet getTables( 
java.lang.String catalog, 
java.lang.String schemaPattern, 
java.lang.String tableNamePattern, 
java.lang.String[] types) throws java.sql.SQLException; 


Parameters 
catalog 


schemaPattern 


tableNamePattern 


types 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getTableTypes Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.ResultSet getTableTypes() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getTimeDateFunctions Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String getTimeDateFunctions() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getTypelnfo Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.ResultSet getTypeInfo() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getURL Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String getURL() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getUserName Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String getUserName() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.getVersionColumns Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.ResultSet getVersionColumns( 
java.lang.String catalog, 
java.lang.String schema, 
java.lang.String table) throws java.sql.SQLException; 


Parameters 
catalog 


schema 
table 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.isCatalogAtStart Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean isCatalogAtStart() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.isReadOnly Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean isReadOnly() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.nullPlusNonNulllsNull Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean nullPlusNonNullIsNull() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.nullsAreSortedAtEnd Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean nullsAreSortedAtEnd() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.nullsAreSortedAtStart Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean nullsAreSortedAtStart() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.nullsAreSortedHigh Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean nullsAreSortedHigh() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.nullsAreSortedLow Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean nullsAreSortedLow() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.storesLowerCaseldentifiers Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean storesLowerCaselIdentifiers() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.storesLowerCaseQuotedIdentifiers Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean storesLowerCaseQuotedIdentifiers() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.storesMixedCaseldentifiers Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean storesMixedCaseIdentifiers() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.storesMixedCaseQuotedIidentifiers Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean storesMixedCaseQuotedIdentifiers() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.storesUpperCaseldentifiers Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean storesUpperCaseIdentifiers() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.storesUpperCaseQuotedIdentifiers Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean storesUpperCaseQuotedIdentifiers() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsAlterTableWithAddColumn 
Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsAlterTablewithAddColumn() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsAlterTableWithDropColumn 
Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsAlterTableWithDropColumn() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsANSI92EntryLevelSQL Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsANSI92EntryLevelSQL() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsANSI92FullSQL Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsANSI92Full1SQL() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsANSI92IntermediateSQL Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsANSI92IntermediateSQL() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsCatalogsInDataManipulation 
Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsCatalogsInDataManipulation() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsCatalogsInIndexDefinitions 
Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsCatalogsInIndexDefinitions() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsCatalogsInPrivilegeDefinitions 
Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsCatalogsInPrivilegeDefinitions() throws java.sql.SQLExcepti 
on; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsCatalogsInProcedureCalls Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsCatalogsInProcedureCalls() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsCatalogsInTableDefinitions 
Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsCatalogsInTableDefinitions() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsColumnAliasing Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsColumnAliasing() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsConvert Method 


Overload List 





Name Description 





DatabaseMetaData.supportsConvert () 





DatabaseMetaData.supportsConvert (int, int) 











See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsConvert Method () 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsConvert() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsConvert Method (Int32, Int32) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsConvert( 
int fromType, 
int toType) throws java.sql.SQLException; 


Parameters 


fromType 
toType 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsCoreSQLGrammar Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsCoreSQLGrammar() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsCorrelatedSubqueries Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsCorrelatedSubqueries() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsDataDefinitionAndDataManipulationTransactions 
Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsDataDefinitionAndDataManipulationTransactions() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsDataManipulationTransactionsOnly 
Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsDataManipulationTransactionsOnly() throws java.sql.SQLExcep 
tion; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
javasql Package 


Visual J# Reference 


DatabaseMetaData.supportsDifferentTableCorrelationNames 
Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsDifferentTableCorrelationNames() throws java.sql.SQLExcepti 
on; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsExpressionsInOrderBy Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsExpressionsInOrderBy() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsExtendedSQLGrammar Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsExtendedSQLGrammar() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsFullOuterJoins Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsFullouterJoins() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsGroupBy Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsGroupBy() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsGroupByBeyondSelect Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsGroupByBeyondSelect() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsGroupByUnrelated Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsGroupByUnrelated() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsIntegrityEnhancementFacility 
Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsIntegrityEnhancementFacility() throws java.sql.SQLException 


BJ 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsLikeEscapeClause Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsLikeEscapeClause() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsLimitedOuterJoins Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsLimitedOuterJoins() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsMinimumSQLGrammar Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsMinimumSQLGrammar() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsMixedCaseldentifiers Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsMixedCaseIdentifiers() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsMixedCaseQuotedIdentifiers 
Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsMixedCaseQuotedIdentifiers() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsMultipleResultSets Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsMultipleResultSets() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsMultipleTransactions Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsMultipleTransactions() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsNonNullableColumns Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsNonNullableColumns() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsOpenCursorsAcrossCommit 
Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsOpenCursorsAcrossCommit() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsOpenCursorsAcrossRollback 
Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsOpenCursorsAcrossRollback() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsOpenStatementsAcrossCommit 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsOpenStatementsAcrossCommit() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsOpenStatementsAcrossRollback 
Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsOpenStatementsAcrossRollback() throws java.sql.SQLException 


BJ 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsOrderByUnrelated Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsOrderByUnrelated() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsOuterJoins Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsOuterJoins() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsPositionedDelete Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsPositionedDelete() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsPositionedUpdate Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsPositionedUpdate() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsSchemasInDataManipulation 
Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsSchemasInDataManipulation() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsSchemasInIndexDefinitions 
Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsSchemasInIndexDefinitions() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsSchemasInPrivilegeDefinitions 
Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsSchemasInPrivilegeDefinitions() throws java.sql.SQLExceptio 
ns 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsSchemasInProcedureCalls Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsSchemasInProcedureCalls() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsSchemasInTableDefinitions 
Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsSchemasInTableDefinitions() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsSelectForUpdate Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsSelectForUpdate() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsStoredProcedures Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsStoredProcedures() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsSubqueriesInComparisons Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsSubqueriesInComparisons() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsSubqueriesInExists Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsSubqueriesInExists() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsSubqueriesInIns Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsSubqueriesInIns() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsSubqueriesInQuantifieds Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsSubqueriesInQuantifieds() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsTableCorrelationNames Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsTableCorrelationNames() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsTransactionlsolationLevel Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsTransactionIsolationLevel( 
int level) throws java.sql.SQLException; 


Parameters 
level 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsTransactions Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsTransactions() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsUnion Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsUnion() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.supportsUnionAll Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean supportsUnionAl1l() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.usesLocalFilePerTable Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean usesLocalFilePerTable() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DatabaseMetaData.usesLocalFiles Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean usesLocalFiles() throws java.sql.SQLException; 


See Also 

Reference 
DatabaseMetaData Interface 
Concepts 

DatabaseMetaData Members 
java.sql Package 


Visual J# Reference 


DataTruncation Class 


Package: java.sq 


Assembly: vjslib (in vjslib.dll) 


public class java.sql.DataTruncation 
extends java.sql.SQLWarning 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.sql.SQLException 
java.sql.SQLWarning 
java.sql.DataTruncation 


See Also 

Concepts 

DataTruncation Members 
java.sql Package 


Visual J# Reference 


DataTruncation Members 


The following tables list the members exposed by the DataTruncation type. 


Public Constructors 
Name 


DataTruncation 





Public Properties (see also Protected Properties ) 











Name Description 

HelpLink (inherited from Exception ) 
InnerException (inherited from Exception ) 
Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 


Protected Properties 





Name Description 





HResult (inherited from Exception ) 








Public Methods 


Name Description 

equals (inherited from Object ) 
filllnStackTrace (inherited from Throwable ) 
GetBaseException (inherited from Exception ) 


getDataSize 











getErrorCode (inherited from SQLException ) 
hashCode (inherited from Object ) 
getIndex 

getLocalizedMessage (inherited from Throwable ) 
getMessage (inherited from Throwable ) 
getNextException (inherited from SQLException ) 





getNextWarning (inherited from SQLWarning ) 























GetObjectData Overridden. 

getParameter 

getRead 

getSQLState (inherited from SQLException ) 





getTransferSize 





getClass 


(inherited from Object ) 





clone 


(inherited from Throwable ) 





printStackTrace 


setNextException 


setNextWarning 


toString 


Protected Methods 


Overloaded. (inherited from Throwable ) 


(inherited from SQLException ) 


(inherited from SQLWarning ) 


(inherited from SQLException ) 





Name 


Description 





finalize 








(inherited from Object ) 





See Also 

Reference 
DataTruncation Class 
Concepts 

java.sql Package 





Visual J# Reference 


DataTruncation Constructor 


Overload List 





Name 


Description 





DataTruncation (SerializationInfo, StreamingContext) 





DataTruncation (String, Exception) 





DataTruncation (int, boolean, boolean, int, int) 





DataTruncation (int, boolean, boolean, int, int, Exception) 











See Also 

Reference 
DataTruncation Class 
Concepts 

DataTruncation Members 
java.sql Package 





Visual J# Reference 


DataTruncation Constructor (SerializationInfo, 
StreamingContext) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


protected java.sql.DataTruncation( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


context 


See Also 

Reference 
DataTruncation Class 
Concepts 

DataTruncation Members 
java.sql Package 


Visual J# Reference 


DataTruncation Constructor (String, Exception) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public java.sql.DataTruncation( 
java.lang.String msg, 
System.Exception inner); 


Parameters 
msg 


inner 


See Also 

Reference 
DataTruncation Class 
Concepts 

DataTruncation Members 
java.sql Package 


Visual J# Reference 


DataTruncation Constructor (Int32, Boolean, Boolean, Int32, 
Int32) 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public java.sql.DataTruncation( 
int index, 
boolean parameter, 
boolean read, 
int dataSize, 
int transferSize); 


Parameters 
index 


parameter 
read 
dataSize 
transferSize 


See Also 

Reference 
DataTruncation Class 
Concepts 

DataTruncation Members 
java.sql Package 


Visual J# Reference 


DataTruncation Constructor (Int32, Boolean, Boolean, Int32, 
Int32, Exception) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public java.sql.DataTruncation( 
int index, 
boolean parameter, 
boolean read, 
int dataSize, 
int transferSize, 
System.Exception inner); 


Parameters 
index 


parameter 
read 
dataSize 
transferSize 
inner 


See Also 

Reference 
DataTruncation Class 
Concepts 

DataTruncation Members 
java.sql Package 


Visual J# Reference 


DataTruncation Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





getDataSize 





getErrorCode 


hashCode 


getIndex 


getLocalizedMessage 


getMessage 


getNextException 


getNextWarning 


GetObjectData 


getParameter 


getRead 


getSQLState 


getTransferSize 


getClass 


clone 


printStackTrace 


setNextException 


(inherited from SQLException ) 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from SQLException ) 


(inherited from SQLWarning ) 


Overridden. 


(inherited from SQLException ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from SQLException ) 





setNextWarning 


(inherited from SQLWarning ) 





toString 


(inherited from SQLException ) 





Name 


finalize 





Protected Methods 





(inherited from Object ) 





See Also 

Reference 
DataTruncation Class 
Concepts 

java.sql Package 


Visual J# Reference 


DataTruncation.getDataSize Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public int getDataSize(); 


See Also 

Reference 
DataTruncation Class 
Concepts 

DataTruncation Members 
java.sql Package 


Visual J# Reference 


DataTruncation.getindex Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public int getIndex(); 


See Also 

Reference 
DataTruncation Class 
Concepts 

DataTruncation Members 
java.sql Package 


Visual J# Reference 


DataTruncation.GetObjectData Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public void GetObjectData( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


context 


See Also 

Reference 
DataTruncation Class 
Concepts 

DataTruncation Members 
java.sql Package 


Visual J# Reference 


DataTruncation.getParameter Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public boolean getParameter(); 


See Also 

Reference 
DataTruncation Class 
Concepts 

DataTruncation Members 
java.sql Package 


Visual J# Reference 


DataTruncation.getRead Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public boolean getRead(); 


See Also 

Reference 
DataTruncation Class 
Concepts 

DataTruncation Members 
java.sql Package 


Visual J# Reference 


DataTruncation.getTransferSize Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public int getTransferSize(); 


See Also 

Reference 
DataTruncation Class 
Concepts 

DataTruncation Members 
java.sql Package 


Visual J# Reference 


DataTruncation Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
DataTruncation Class 
Concepts 

java.sql Package 








Visual J# Reference 


Date Class 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public class java.sql.Date 
extends java.util.Date 





Inheritance Hierarchy 

java.lang.Object 
java.util.Date 
java.sql.Date 


See Also 
Concepts 

Date Members 
java.sql Package 


Visual J# Reference 


Date Members 


The following tables list the members exposed by the Date type. 


Public Constructors 


Name 


Date 





Public Methods 











getTimezoneOffset 


Name Description 

after Determines whether the Date object is after a given date. (inherited from Date) 
before Determines whether the Date object is before a given date. (inherited from Date) 
compareTo Compares two dates. (inherited from Date) 

equals Determines whether two Date objects are equal. (inherited from Date) 

getDate Gets a value indicating the date. (inherited from Date) 

getDay Gets a value indicating the day of the week. (inherited from Date) 

hashCode Generates a hash of the date. (inherited from Date) 

getHours Overridden. 

getMinutes Overridden. 

getMonth Gets a value indicating the month. (inherited from Date) 

getSeconds Overridden. 

getTime Gets a value indicating the time in milliseconds since epoch. (inherited from Date) 


Gets a value indicating the time zone offset in milliseconds. (inherited from Date) 




















getClass (inherited from Object ) 

getYear Gets a value indicating the year. (inherited from Date) 
clone (inherited from Date ) 

setDate Sets a value indicating the date. (inherited from Date) 
setHours Overridden. 

setMinutes Overridden. 

setMonth Sets a value indicating the month. (inherited from Date) 








setSeconds 


Overridden. 




















setTime Sets the time to the value represented in milliseconds since epoch. (inherited from Date) 
setYear Sets a value indicating the year. (inherited from Date) 

ToBoolean Converts an instance of a Date object to a Boolean. (inherited from Date) 

ToByte Converts an instance of a Date object to a Byte. (inherited from Date) 

ToChar Converts an instance of a Date object to a Char. (inherited from Date) 

ToDateTime Converts an instance of a Date object to a DateTime. (inherited from Date) 

ToDecimal Converts an instance of a Date object to a Decimal. (inherited from Date) 

ToDouble Converts an instance of a Date object to a Double. (inherited from Date) 

toGMTString Displays a value representing the date/time of a Date object in GMT. (inherited from Date) 
Tolnt16 Converts an instance of a Date object to an Int16. (inherited from Date) 

Tolnt32 Converts an instance of a Date object to an Int32. (inherited from Date) 

Tolnt64 Converts an instance of a Date object to an Int64. (inherited from Date) 





toLocaleString 


ToSByte 


ToSingle 


toString 


ToType 


ToUInt16 


ToUInt32 


ToUInt64 


valueOf 


Name 


finalize 





See Also 
Reference 

Date Class 
Concepts 
java.sql Package 





Displays a value representing the date/time of a Date object displayed in the format of current locale. (inhe 
rited from Date) 


Converts an instance of a Date object to a SByte. (inherited from Date) 


Converts an instance of a Date object to a Single. (inherited from Date) 


Overloaded. Overridden. 


Converts an instance of a Date object to a given Type. (inherited from Date) 


Converts an instance of a Date object to an Ulnt16. (inherited from Date) 


Converts an instance of a Date object to an Ulnt32. (inherited from Date) 


Converts an instance of a Date object to an Ulnt64. (inherited from Date) 


Protected Methods 


(inherited from Object ) 








Visual J# Reference 


Date Constructor 


Overload List 





Name Description 





Date (long) 





Date (int, int, int) 











See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.sql Package 


Visual J# Reference 


Date Constructor (Int64) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public java.sql.Date( 
long msSinceEpoch) ; 





Parameters 
msSinceEpoch 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.sql Package 


Visual J# Reference 


Date Constructor (Int32, Int32, Int32) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public java.sql.Date( 
int year, 
int month, 
int date); 


Parameters 
year 


month 
date 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.sql Package 


Visual J# Reference 


Date Methods 


Public Methods 




















getTimezoneOffset 


Name Description 

after Determines whether the Date object is after a given date. (inherited from Date ) 
before Determines whether the Date object is before a given date. (inherited from Date ) 
compareTo Compares two dates. (inherited from Date ) 

equals Determines whether two Date objects are equal. (inherited from Date ) 

getDate Gets a value indicating the date. (inherited from Date ) 

getDay Gets a value indicating the day of the week. (inherited from Date ) 

hashCode Generates a hash of the date. (inherited from Date ) 

getHours Overridden. 

getMinutes Overridden. 

getMonth Gets a value indicating the month. (inherited from Date ) 

getSeconds Overridden. 

getTime Gets a value indicating the time in milliseconds since epoch. (inherited from Date ) 


Gets a value indicating the time zone offset in milliseconds. (inherited from Date ) 





























getClass (inherited from Object ) 

getYear Gets a value indicating the year. (inherited from Date ) 

clone (inherited from Date ) 

setDate Sets a value indicating the date. (inherited from Date ) 

setHours Overridden. 

setMinutes Overridden. 

setMonth Sets a value indicating the month. (inherited from Date ) 

setSeconds Overridden. 

setTime Sets the time to the value represented in milliseconds since epoch. (inherited from Date ) 
setYear Sets a value indicating the year. (inherited from Date ) 

















ToBoolean Converts an instance of a Date object to a Boolean. (inherited from Date ) 

ToByte Converts an instance of a Date object to a Byte. (inherited from Date ) 

ToChar Converts an instance of a Date object to a Char. (inherited from Date ) 

ToDateTime Converts an instance of a Date object to a DateTime. (inherited from Date ) 

ToDecimal Converts an instance of a Date object to a Decimal. (inherited from Date ) 

ToDouble Converts an instance of a Date object to a Double. (inherited from Date ) 

toGMTString Displays a value representing the date/time of a Date object in GMT. (inherited from Date ) 
Tolnt16 Converts an instance of a Date object to an Int16. (inherited from Date ) 

Tolnt32 Converts an instance of a Date object to an Int32. (inherited from Date ) 

Tolnt64 Converts an instance of a Date object to an Int64. (inherited from Date ) 





toLocaleString 


ToSByte 


ToSingle 


toString 


ToType 


ToUInt16 


ToUInt32 


ToUInt64 


valueOf 





Displays a value representing the date/time of a Date object displayed in the format of current locale. (inhe 
rited from Date ) 


Converts an instance of a Date object to a SByte. (inherited from Date ) 


Converts an instance of a Date object to a Single. (inherited from Date ) 


Overloaded. Overridden. 


Converts an instance of a Date object to a given Type. (inherited from Date ) 


Converts an instance of a Date object to an Ulnt16. (inherited from Date ) 


Converts an instance of a Date object to an Ulnt32. (inherited from Date ) 


Converts an instance of a Date object to an Ulnt64. (inherited from Date ) 


Protected Methods 





Name 


Description 





finalize 





(inherited from Object ) 








See Also 
Reference 

Date Class 
Concepts 
java.sql Package 





Visual J# Reference 


Date.getHours Method 


Package: java.sq 


Assembly: vjslib (in vjslib.dll) 





public int getHours(); 





See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.sql Package 


Visual J# Reference 


Date.getMinutes Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public int getMinutes(); 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.sql Package 


Visual J# Reference 


Date.getSeconds Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public int getSeconds(); 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.sql Package 


Visual J# Reference 


Date.setHours Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public void setHours( 
int hour); 





Parameters 
hour 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.sql Package 


Visual J# Reference 


Date.setMinutes Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public void setMinutes( 
int minute) ; 


Parameters 
minute 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.sql Package 


Visual J# Reference 


Date.setSeconds Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public void setSeconds( 
int second); 





Parameters 
second 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.sql Package 


Visual J# Reference 


Date.toString Method 


Overload List 





Name Description 





Date.ToString () 





Date.ToString (IFormatProvider) Converts an instance of a Date object to a String. 











See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.sql Package 


Visual J# Reference 


Date.toString Method () 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toString(); 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.sql Package 


Visual J# Reference 


Date.valueOf Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static java.sql.Date valueOf( 
java.lang.String strDate); 





Parameters 
strDate 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.sql Package 


Visual J# Reference 


Driver Interface 


Package: java.sq 


Assembly: vjslib (in vjslib.dll) 





public interface java.sql.Driver 





See Also 
Concepts 
Driver Members 
java.sql Package 


Visual J# Reference 


Driver Members 


The following tables list the members exposed by the Driver type. 


Public Methods 
Name 


acceptsURL 


connect 


getMajorVersion 


getMinorVersion 


Description 





getPropertylnfo 





\j}dbcCompliant 











See Also 
Reference 
Driver Interface 
Concepts 
java.sql Package 





Visual J# Reference 


Driver Methods 


Public Methods 





Name 


Description 





acceptsURL 





connect 





getMajorVersion 





getMinorVersion 





getPropertyInfo 


\j\dbcCompliant 





See Also 
Reference 

Driver Interface 
Concepts 
java.sql Package 








Visual J# Reference 


Driver.acceptsURL Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean acceptsURL( 
java.lang.String url) throws java.sql.SQLException; 


Parameters 
url 


See Also 
Reference 
Driver Interface 
Concepts 

Driver Members 
java.sql Package 


Visual J# Reference 


Driver.connect Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.Connection connect( 
java.lang.String url, 
java.util.Properties info) throws java.sql.SQLException; 


Parameters 
url 


info 


See Also 
Reference 
Driver Interface 
Concepts 

Driver Members 
java.sql Package 


Visual J# Reference 


Driver.getMajorVersion Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract int getMajorVersion(); 


See Also 
Reference 
Driver Interface 
Concepts 

Driver Members 
java.sql Package 


Visual J# Reference 


Driver.getMinorVersion Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract int getMinorVersion(); 


See Also 
Reference 
Driver Interface 
Concepts 

Driver Members 
java.sql Package 


Visual J# Reference 


Driver.getPropertyInfo Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.DriverPropertyInfo[] getPropertyInfo( 
java.lang.String url, 
java.util.Properties info) throws java.sql.SQLException; 


Parameters 
url 


info 


See Also 
Reference 
Driver Interface 
Concepts 

Driver Members 
java.sql Package 


Visual J# Reference 


Driver.jdbcCompliant Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean jdbcCompliant(); 


See Also 
Reference 
Driver Interface 
Concepts 

Driver Members 
java.sql Package 


Visual J# Reference 


DriverManager Class 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public class java.sql.DriverManager 
extends java.lang.Object 





Inheritance Hierarchy 
java.lang.Object 
java.sql.DriverManager 


See Also 

Concepts 

DriverManager Members 
java.sql Package 


Visual J# Reference 


DriverManager Members 


The following tables list the members exposed by the DriverManager type. 


Public Methods 
Name Description 


deregisterDriver 








equals (inherited from Object ) 
getConnection Overloaded. 

getDriver 

getDrivers 

hashCode (inherited from Object ) 





getLoginTimeout 





getLogStream 





getClass (inherited from Object ) 





printin 





registerDriver 





setLoginTimeout 





setLogStream 





toString Overridden. 





Protected Methods 
Name Description 


finalize (inherited from Object ) 


MemberwiseClone Performs a shallow copy of the members. 





See Also 
Reference 
DriverManager Class 
Concepts 

java.sql Package 





Visual J# Reference 


DriverManager Methods 


Public Methods 





Name Description 





deregisterDriver 














equals (inherited from Object ) 
getConnection Overloaded. 

getDriver 

getDrivers 

hashCode (inherited from Object ) 


getLoginTimeout 

getLogStream 

getClass (inherited from Object ) 
printin 

registerDriver 

setLoginTimeout 

setLogStream 


toString Overridden. 


Protected Methods 





Name Description 





finalize (inherited from Object ) 





MemberwiseClone Performs a shallow copy of the members. 











See Also 
Reference 
DriverManager Class 
Concepts 

java.sql Package 


Visual J# Reference 


DriverManager.deregisterDriver Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static void deregisterDriver ( 
java.sql.Driver driver) throws java.sql.SQLException; 


Parameters 
driver 


See Also 

Reference 
DriverManager Class 
Concepts 

DriverManager Members 
java.sql Package 


Visual J# Reference 


DriverManager.getConnection Method 


Overload List 





Name 


Description 





DriverManager.getConnection (String) 





DriverManager.getConnection (String, Properties) 





DriverManager.getConnection (String, String, String) 








See Also 

Reference 
DriverManager Class 
Concepts 

DriverManager Members 
java.sql Package 





Visual J# Reference 


DriverManager.getConnection Method (String) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static java.sql.Connection getConnection( 
java.lang.String url) throws java.sql.SQLException; 


Parameters 
url 


See Also 

Reference 
DriverManager Class 
Concepts 

DriverManager Members 
java.sql Package 


Visual J# Reference 


DriverManager.getConnection Method (String, Properties) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static java.sql.Connection getConnection( 
java.lang.String url, 
java.util.Properties info) throws java.sql.SQLException; 


Parameters 
url 


info 


See Also 

Reference 
DriverManager Class 
Concepts 

DriverManager Members 
java.sql Package 


Visual J# Reference 


DriverManager.getConnection Method (String, String, String) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static java.sql.Connection getConnection( 
java.lang.String url, 
java.lang.String user, 
java.lang.String password) throws java.sql.SQLException; 


Parameters 
url 


user 
password 


See Also 

Reference 
DriverManager Class 
Concepts 

DriverManager Members 
java.sql Package 


Visual J# Reference 


DriverManager.getDriver Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static java.sql.Driver getDriver( 
java.lang.String url) throws java.sql.SQLException; 


Parameters 
url 


See Also 

Reference 
DriverManager Class 
Concepts 

DriverManager Members 
java.sql Package 


Visual J# Reference 


DriverManager.getDrivers Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static java.util.Enumeration getDrivers(); 


See Also 

Reference 
DriverManager Class 
Concepts 

DriverManager Members 
java.sql Package 


Visual J# Reference 


DriverManager.getLoginTimeout Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static int getLoginTimeout(); 


See Also 

Reference 
DriverManager Class 
Concepts 

DriverManager Members 
java.sql Package 


Visual J# Reference 


DriverManager.getLogStream Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static java.io.PrintStream getLogStream(); 


See Also 

Reference 
DriverManager Class 
Concepts 

DriverManager Members 
java.sql Package 


Visual J# Reference 


DriverManager.printin Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public static void println( 
java.lang.String message); 


Parameters 
message 


See Also 

Reference 
DriverManager Class 
Concepts 

DriverManager Members 
java.sql Package 


Visual J# Reference 


DriverManager.registerDriver Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static void registerDriver( 
java.sql.Driver driver) throws java.sql.SQLException; 


Parameters 
driver 


See Also 

Reference 
DriverManager Class 
Concepts 

DriverManager Members 
java.sql Package 


Visual J# Reference 


DriverManager.setLoginTimeout Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static void setLoginTimeout( 
int seconds); 


Parameters 
seconds 


See Also 

Reference 
DriverManager Class 
Concepts 

DriverManager Members 
java.sql Package 


Visual J# Reference 


DriverManager.setLogStream Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static void setLogStream( 
java.io.PrintStream out); 


Parameters 
out 


See Also 

Reference 
DriverManager Class 
Concepts 

DriverManager Members 
java.sql Package 


Visual J# Reference 


DriverPropertyInfo Class 


Package: java.sq 


Assembly: vjslib (in vjslib.dll) 


public class java.sql.DriverPropertyInfo 
extends java.lang.Object 





Inheritance Hierarchy 
java.lang.Object 
java.sql.DriverProperty|nfo 


See Also 

Concepts 

DriverPropertylnfo Members 
java.sql Package 


Visual J# Reference 


DriverPropertyInfo Members 


The following tables list the members exposed by the DriverPropertylnfo type. 


Public Constructors 
Name 


DriverProperty|nfo 


Public Fields 








Name 


Description 





choices 





description 


name 


required 


value 


Public Methods 








Name 


Description 




















finalize 


MemberwiseClone 





See Also 

Reference 
DriverPropertyInfo Class 
Concepts 

java.sql Package 


equals (inherited from Object ) 
hashCode (inherited from Object ) 
getClass (inherited from Object ) 
toString Overridden. 
Protected Methods 

Name Description 


(inherited from Object ) 


Performs a shallow copy of the members. 





Visual J# Reference 


DriverPropertylInfo Fields 


Public Fields 





Name Description 





choices 





description 





name 





required 





value 








See Also 

Reference 
DriverPropertyInfo Class 
Concepts 

java.sql Package 





Visual J# Reference 


DriverPropertyInfo.choices Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String[] choices; 


See Also 

Reference 
DriverPropertyInfo Class 
Concepts 

DriverPropertylnfo Members 
java.sql Package 


Visual J# Reference 


DriverPropertyInfo.description Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String description; 


See Also 

Reference 
DriverPropertyInfo Class 
Concepts 

DriverPropertyInfo Members 
java.sql Package 


Visual J# Reference 


DriverPropertyInfo.name Field 


Package: java.sq 


Assembly: vjslib (in vjslib.dll) 





public java.lang.String name; 





See Also 

Reference 
DriverPropertyInfo Class 
Concepts 

DriverPropertylnfo Members 
java.sql Package 


Visual J# Reference 


DriverPropertylnfo.required Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public boolean required; 


See Also 

Reference 
DriverPropertyInfo Class 
Concepts 

DriverPropertylnfo Members 
java.sql Package 


Visual J# Reference 


DriverPropertyInfo.value Field 


Package: java.sq 


Assembly: vjslib (in vjslib.dll) 





public java.lang.String value; 





See Also 

Reference 
DriverPropertyInfo Class 
Concepts 

DriverPropertylnfo Members 
java.sql Package 


Visual J# Reference 


DriverPropertyInfo Constructor 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public java.sql.DriverPropertyInfo( 
java.lang.String name, 
java.lang.String value); 


Parameters 
name 


value 


See Also 

Reference 
DriverPropertylInfo Class 
Concepts 

DriverPropertylnfo Members 
java.sql Package 


Visual J# Reference 


DriverPropertyInfo Methods 


Public Methods 





Name 


Description 

















equals (inherited from Object ) 
hashCode (inherited from Object ) 
getClass (inherited from Object ) 
toString Overridden. 





Protected Methods 





Name 


Description 





finalize 


(inherited from Object ) 





MemberwiseClone 





Performs a shallow copy of the members. 





See Also 

Reference 
DriverPropertyInfo Class 
Concepts 

java.sql Package 





Visual J# Reference 


PreparedStatement Interface 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public interface java.sql.PreparedStatement 
extends java.sql.Statement 


See Also 

Concepts 

PreparedStatement Members 
java.sql Package 


Visual J# Reference 


PreparedStatement Members 


The following tables list the members exposed by the PreparedStatement type. 
Public Methods 
clearParameters 
execute 
executeQuery 


executeUpdate 


Name Description 





setAsciiStream 





setBigDecimal 





setBinaryStream 





setBoolean 





setByte 





setBytes 





setDate 





setDouble 





setFloat 





setint 





setLong 





setNull 





setObject Overloaded. 





setShort 





setString 


setTime 


setTimestamp 


setUnicodeStream 








See Also 
Reference 


PreparedStatement Interface 





Concepts 
java.sql Package 


Visual J# Reference 


PreparedStatement Methods 


Public Methods 





Name Description 





clearParameters 





execute 





executeQuery 





executeUpdate 





setAsciiStream 
setBigDecimal 
setBinaryStream 
setBoolean 
setByte 

setBytes 

setDate 
setDouble 
setFloat 

setint 

setLong 

setNull 
setObject Overloaded. 
setShort 
setString 


setTime 





setTimestamp 





setUnicodeStream 














See Also 

Reference 
PreparedStatement Interface 
Concepts 


java.sql Package 


Visual J# Reference 


PreparedStatement.clearParameters Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract void clearParameters() throws java.sql.SQLException; 


See Also 

Reference 
PreparedStatement Interface 
Concepts 

PreparedStatement Members 
java.sql Package 


Visual J# Reference 


PreparedStatement.execute Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean execute() throws java.sql.SQLException; 


See Also 

Reference 
PreparedStatement Interface 
Concepts 

PreparedStatement Members 
java.sql Package 


Visual J# Reference 


PreparedStatement.executeQuery Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.ResultSet executeQuery() throws java.sql.SQLException; 


See Also 

Reference 
PreparedStatement Interface 
Concepts 

PreparedStatement Members 
java.sql Package 


Visual J# Reference 


PreparedStatement.executeUpdate Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract int executeUpdate() throws java.sql.SQLException; 


See Also 

Reference 
PreparedStatement Interface 
Concepts 

PreparedStatement Members 
java.sql Package 


Visual J# Reference 


PreparedStatement.setAsciiStream Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract void setAsciiStream( 
int parameterIndex, 
java.io.InputStream x, 
int length) throws java.sql.SQLException; 


Parameters 
parameterIndex 


length 


See Also 

Reference 
PreparedStatement Interface 
Concepts 

PreparedStatement Members 
java.sql Package 


Visual J# Reference 


PreparedStatement.setBigDecimal Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract void setBigDecimal( 
int parameterIndex, 
java.math.BigDecimal x) throws java.sql.SQLException; 


Parameters 
parameterIndex 


See Also 

Reference 
PreparedStatement Interface 
Concepts 

PreparedStatement Members 
java.sql Package 


Visual J# Reference 


PreparedStatement.setBinaryStream Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract void setBinaryStream( 
int parameterIndex, 
java.io.InputStream x, 
int length) throws java.sql.SQLException; 


Parameters 
parameterIndex 


length 


See Also 

Reference 
PreparedStatement Interface 
Concepts 

PreparedStatement Members 
java.sql Package 


Visual J# Reference 


PreparedStatement.setBoolean Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract void setBoolean( 
int parameterIndex, 
boolean x) throws java.sql.SQLException; 


Parameters 
parameterIndex 


See Also 

Reference 
PreparedStatement Interface 
Concepts 

PreparedStatement Members 
java.sql Package 


Visual J# Reference 


PreparedStatement.setByte Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract void setByte( 
int parameterIndex, 
byte x) throws java.sql.SQLException; 


Parameters 
parameterIndex 


See Also 

Reference 
PreparedStatement Interface 
Concepts 

PreparedStatement Members 
java.sql Package 


Visual J# Reference 


PreparedStatement.setBytes Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract void setBytes( 
int parameterIndex, 
byte[] x) throws java.sql.SQLException; 


Parameters 
parameterIndex 


See Also 

Reference 
PreparedStatement Interface 
Concepts 

PreparedStatement Members 
java.sql Package 


Visual J# Reference 


PreparedStatement.setDate Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract void setDate( 
int parameterIndex, 
java.sql.Date x) throws java.sql.SQLException; 


Parameters 
parameterIndex 


See Also 

Reference 
PreparedStatement Interface 
Concepts 

PreparedStatement Members 
java.sql Package 


Visual J# Reference 


PreparedStatement.setDouble Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract void setDouble( 
int parameterIndex, 
double x) throws java.sql.SQLException; 


Parameters 
parameterIndex 


See Also 

Reference 
PreparedStatement Interface 
Concepts 

PreparedStatement Members 
java.sql Package 


Visual J# Reference 


PreparedStatement.setFloat Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract void setFloat( 
int parameterIndex, 
float x) throws java.sql.SQLException; 


Parameters 
parameterIndex 


See Also 

Reference 
PreparedStatement Interface 
Concepts 

PreparedStatement Members 
java.sql Package 


Visual J# Reference 


PreparedStatement.setInt Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract void setInt( 
int parameterIndex, 
int x) throws java.sql.SQLException; 


Parameters 
parameterIndex 


See Also 

Reference 
PreparedStatement Interface 
Concepts 

PreparedStatement Members 
java.sql Package 


Visual J# Reference 


PreparedStatement.setLong Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract void setLong( 
int parameterIndex, 
long x) throws java.sql.SQLException; 


Parameters 
parameterIndex 


See Also 

Reference 
PreparedStatement Interface 
Concepts 

PreparedStatement Members 
java.sql Package 


Visual J# Reference 


PreparedStatement.setNull Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract void setNull( 
int parameterIndex, 
int sqlType) throws java.sql.SQLException; 


Parameters 
parameterIndex 


sqlType 


See Also 

Reference 
PreparedStatement Interface 
Concepts 

PreparedStatement Members 
java.sql Package 


Visual J# Reference 


PreparedStatement.setObject Method 


Overload List 





Name 


Description 





PreparedStatement.setObject (int, Object) 





PreparedStatement.setObject (int, Object, int) 





PreparedStatement.setObject (int, Object, int, int) 











See Also 

Reference 
PreparedStatement Interface 
Concepts 

PreparedStatement Members 
java.sql Package 





Visual J# Reference 


PreparedStatement.setObject Method (Int32, Object) 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract void setObject( 
int parameterIndex, 
java.lang.Object x) throws java.sql.SQLException; 


Parameters 
parameterIndex 


See Also 

Reference 
PreparedStatement Interface 
Concepts 

PreparedStatement Members 
java.sql Package 


Visual J# Reference 


PreparedStatement.setObject Method (Int32, Object, Int32) 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract void setObject( 
int parameterIndex, 
java.lang.Object x, 
int targetSqlType) throws java.sql.SQLException; 


Parameters 
parameterIndex 


targetSqlType 


See Also 

Reference 
PreparedStatement Interface 
Concepts 

PreparedStatement Members 
java.sql Package 


Visual J# Reference 


PreparedStatement.setObject Method (Int32, Object, Int32, 
Int32) 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract void setObject( 
int parameterIndex, 
java.lang.Object x, 
int targetSqlType, 
int scale) throws java.sql.SQLException; 


Parameters 
parameterIndex 


targetSqlType 
scale 


See Also 

Reference 
PreparedStatement Interface 
Concepts 

PreparedStatement Members 
java.sql Package 


Visual J# Reference 


PreparedStatement.setShort Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract void setShort( 
int parameterIndex, 
short x) throws java.sql.SQLException; 


Parameters 
parameterIndex 


See Also 

Reference 
PreparedStatement Interface 
Concepts 

PreparedStatement Members 
java.sql Package 


Visual J# Reference 


PreparedStatement.setString Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract void setString( 
int parameterIndex, 
java.lang.String x) throws java.sql.SQLException; 


Parameters 
parameterIndex 


See Also 

Reference 
PreparedStatement Interface 
Concepts 

PreparedStatement Members 
java.sql Package 


Visual J# Reference 


PreparedStatement.setTime Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract void setTime( 
int parameterIndex, 
java.sql.Time x) throws java.sql.SQLException; 


Parameters 
parameterIndex 


See Also 

Reference 
PreparedStatement Interface 
Concepts 

PreparedStatement Members 
java.sql Package 


Visual J# Reference 


PreparedStatement.setTimestamp Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract void setTimestamp( 
int parameterIndex, 
java.sql.Timestamp x) throws java.sql.SQLException; 


Parameters 
parameterIndex 


See Also 

Reference 
PreparedStatement Interface 
Concepts 

PreparedStatement Members 
java.sql Package 


Visual J# Reference 


PreparedStatement.setUnicodeStream Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract void setUnicodeStream( 
int parameterIndex, 
java.io.InputStream x, 
int length) throws java.sql.SQLException; 


Parameters 
parameterIndex 


length 


See Also 

Reference 
PreparedStatement Interface 
Concepts 

PreparedStatement Members 
java.sql Package 


Visual J# Reference 


ResultSet Interface 


Package: java.sq 


Assembly: vjslib (in vjslib.dll) 





public interface java.sql.ResultSet 





See Also 

Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet Members 


The following tables list the members exposed by the ResultSet type. 


Public Methods 















































Name Description 
clearWarnings 

close 

findColumn 

getAsciiStream Overloaded. 
getBigDecimal Overloaded. 
getBinaryStream Overloaded. 
getBoolean Overloaded. 
getByte Overloaded. 
getBytes Overloaded. 
getCursorName 

getDate Overloaded. 
getDouble Overloaded. 
getFloat Overloaded. 
getint Overloaded. 
getLong Overloaded. 
getMetaData 

getObject Overloaded. 
getShort Overloaded. 
getString Overloaded. 
getTime Overloaded. 
getTimestamp Overloaded. 
getUnicodeStream Overloaded. 
getWarnings 











next 





wasNull 











See Also 
Reference 
ResultSet Interface 
Concepts 

java.sql Package 


Visual J# Reference 


ResultSet Methods 


Public Methods 
































Name Description 
clearWarnings 

close 

findColumn 

getAsciiStream Overloaded. 
getBigDecimal Overloaded. 
getBinaryStream Overloaded. 
getBoolean Overloaded. 
getByte Overloaded. 
getBytes Overloaded. 
getCursorName 

getDate Overloaded. 
getDouble Overloaded. 
getFloat Overloaded. 
getint Overloaded. 
getLong Overloaded. 
getMetaData 

getObject Overloaded. 
getShort Overloaded. 
getString Overloaded. 
getTime Overloaded. 
getTimestamp Overloaded. 
getUnicodeStream Overloaded. 
getWarnings 

next 














wasNull 











See Also 
Reference 
ResultSet Interface 
Concepts 

java.sql Package 


Visual J# Reference 


ResultSet.clearWarnings Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract void clearWarnings() throws java.sql.SQLException; 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.close Method 


Package: java.sq 


Assembly: vjslib (in vjslib.dll) 





public abstract void close() throws java.sql.SQLException; 





See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.findColumn Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract int findColumn( 
java.lang.String columnName) throws java.sql.SQLException; 


Parameters 
columnName 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getAsciiStream Method 


Overload List 





Name 


Description 





ResultSet.getAsciiStream (int) 





ResultSet.getAsciiStream (String) 











See Also 
Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 





Visual J# Reference 


ResultSet.getAsciiStream Method (Int32) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.io.InputStream getAsciiStream( 
int columnIndex) throws java.sql.SQLException; 


Parameters 
columnindex 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getAsciiStream Method (String) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.io.InputStream getAsciiStream( 
java.lang.String columnName) throws java.sql.SQLException; 


Parameters 
columnName 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getBigDecimal Method 


Overload List 





Name Description 





ResultSet.getBigDecimal (int, int) 





ResultSet.getBigDecimal (String, int) 











See Also 
Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getBigDecimal Method (Int32, Int32) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.math.BigDecimal getBigDecimal( 
int columnIndex, 
int scale) throws java.sql.SQLException; 


Parameters 
columnindex 


scale 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getBigDecimal Method (String, Int32) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.math.BigDecimal getBigDecimal( 
java.lang.String columnName, 
int scale) throws java.sql.SQLException; 


Parameters 
columnName 


scale 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getBinaryStream Method 


Overload List 





Name Description 





ResultSet.getBinaryStream (int) 





ResultSet.getBinaryStream (String) 











See Also 
Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getBinaryStream Method (Int32) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.io.InputStream getBinaryStream( 
int columnIndex) throws java.sql.SQLException; 


Parameters 
columnindex 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getBinaryStream Method (String) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.io.InputStream getBinaryStream( 
java.lang.String columnName) throws java.sql.SQLException; 


Parameters 
columnName 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getBoolean Method 


Overload List 





Name 


Description 





ResultSet.getBoolean (int) 





ResultSet.getBoolean (String) 











See Also 
Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 





Visual J# Reference 


ResultSet.getBoolean Method (Int32) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean getBoolean( 
int columnIndex) throws java.sql.SQLException; 


Parameters 
columnindex 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getBoolean Method (String) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean getBoolean( 
java.lang.String columnName) throws java.sql.SQLException; 


Parameters 
columnName 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getByte Method 


Overload List 





Name Description 





ResultSet.getByte (int) 





ResultSet.getByte (String) 











See Also 
Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getByte Method (Int32) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract byte getByte( 
int columnIndex) throws java.sql.SQLException; 


Parameters 
columnindex 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getByte Method (String) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract byte getByte( 
java.lang.String columnName) throws java.sql.SQLException; 


Parameters 
columnName 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getBytes Method 


Overload List 





Name 


Description 





ResultSet.getBytes (int) 





ResultSet.getBytes (String) 











See Also 
Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 





Visual J# Reference 


ResultSet.getBytes Method (Int32) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract byte[] getBytes( 
int columnIndex) throws java.sql.SQLException; 


Parameters 
columnindex 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getBytes Method (String) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract byte[] getBytes( 
java.lang.String columnName) throws java.sql.SQLException; 


Parameters 
columnName 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getCursorName Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String getCursorName() throws java.sql.SQLException; 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getDate Method 


Overload List 





Name Description 





ResultSet.getDate (int) 





ResultSet.getDate (String) 











See Also 
Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getDate Method (Int32) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.Date getDate( 
int columnIndex) throws java.sql.SQLException; 


Parameters 
columnindex 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getDate Method (String) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.Date getDate( 
java.lang.String columnName) throws java.sql.SQLException; 


Parameters 
columnName 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getDouble Method 


Overload List 





Name Description 





ResultSet.getDouble (int) 





ResultSet.getDouble (String) 











See Also 
Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getDouble Method (Int32) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract double getDouble( 
int columnIndex) throws java.sql.SQLException; 


Parameters 
columnindex 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getDouble Method (String) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract double getDouble( 
java.lang.String columnName) throws java.sql.SQLException; 


Parameters 
columnName 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getFloat Method 


Overload List 





Name Description 





ResultSet.getFloat (int) 





ResultSet.getFloat (String) 











See Also 
Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getFloat Method (Int32) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract float getFloat( 
int columnIndex) throws java.sql.SQLException; 


Parameters 
columnindex 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getFloat Method (String) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract float getFloat( 
java.lang.String columnName) throws java.sql.SQLException; 


Parameters 
columnName 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getint Method 


Overload List 





Name Description 





ResultSet.getint (int) 





ResultSet.getint (String) 











See Also 
Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getInt Method (Int32) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract int getInt( 
int columnIndex) throws java.sql.SQLException; 


Parameters 
columnindex 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getint Method (String) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract int getInt( 
java.lang.String columnName) throws java.sql.SQLException; 


Parameters 
columnName 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getLong Method 


Overload List 





Name 


Description 





ResultSet.getLong (int) 





ResultSet.getLong (String) 











See Also 
Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 





Visual J# Reference 


ResultSet.getLong Method (Int32) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract long getLong( 
int columnIndex) throws java.sql.SQLException; 


Parameters 
columnindex 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getLong Method (String) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract long getLong( 
java.lang.String columnName) throws java.sql.SQLException; 


Parameters 
columnName 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getMetaData Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.ResultSetMetaData getMetaData() throws java.sql.SQLException; 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getObject Method 


Overload List 





Name 


Description 





ResultSet.getObject (int) 





ResultSet.getObject (String) 











See Also 
Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 





Visual J# Reference 


ResultSet.getObject Method (Int32) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.Object getObject( 
int columnIndex) throws java.sql.SQLException; 


Parameters 
columnindex 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getObject Method (String) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.Object getObject( 
java.lang.String columnName) throws java.sql.SQLException; 


Parameters 
columnName 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getShort Method 


Overload List 





Name Description 





ResultSet.getShort (int) 





ResultSet.getShort (String) 











See Also 
Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getShort Method (Int32) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract short getShort( 
int columnIndex) throws java.sql.SQLException; 


Parameters 
columnindex 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getShort Method (String) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract short getShort( 
java.lang.String columnName) throws java.sql.SQLException; 


Parameters 
columnName 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getString Method 


Overload List 





Name Description 





ResultSet.getString (int) 





ResultSet.getString (String) 











See Also 
Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getString Method (Int32) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String getString( 
int columnIndex) throws java.sql.SQLException; 


Parameters 
columnindex 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getString Method (String) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String getString( 
java.lang.String columnName) throws java.sql.SQLException; 


Parameters 
columnName 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getTime Method 


Overload List 





Name Description 





ResultSet.getTime (int) 





ResultSet.getTime (String) 











See Also 
Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getTime Method (Int32) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.Time getTime( 
int columnIndex) throws java.sql.SQLException; 


Parameters 
columnindex 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getTime Method (String) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.Time getTime( 
java.lang.String columnName) throws java.sql.SQLException; 


Parameters 
columnName 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getTimestamp Method 


Overload List 





Name 


Description 





ResultSet.getTimestamp (int) 





ResultSet.getTimestamp (String) 











See Also 
Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 





Visual J# Reference 


ResultSet.getTimestamp Method (Int32) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.Timestamp getTimestamp( 
int columnIndex) throws java.sql.SQLException; 


Parameters 
columnindex 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getTimestamp Method (String) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.Timestamp getTimestamp( 
java.lang.String columnName) throws java.sql.SQLException; 


Parameters 
columnName 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getUnicodeStream Method 


Overload List 





Name 


Description 





ResultSet.getUnicodeStream (int) 





ResultSet.getUnicodeStream (String) 











See Also 
Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 





Visual J# Reference 


ResultSet.getUnicodeStream Method (Int32) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.io.InputStream getUnicodeStream( 
int columnIndex) throws java.sql.SQLException; 


Parameters 
columnindex 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getUnicodeStream Method (String) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.io.InputStream getUnicodeStream( 
java.lang.String columnName) throws java.sql.SQLException; 


Parameters 
columnName 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.getWarnings Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.SQLWarning getWarnings() throws java.sql.SQLException; 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.next Method 


Package: java.sq 


Assembly: vjslib (in vjslib.dll) 





public abstract boolean next() throws java.sql.SQLException; 





See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSet.wasNull Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean wasNull() throws java.sql.SQLException; 


See Also 

Reference 
ResultSet Interface 
Concepts 

ResultSet Members 
java.sql Package 


Visual J# Reference 


ResultSetMetaData Interface 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public interface java.sql.ResultSetMetaData 


See Also 

Concepts 

ResultSetMetaData Members 
java.sql Package 


Visual J# Reference 


ResultSetMetaData Members 


The following tables list the members exposed by the ResultSetMetaData type. 


Public Fields 


Name Description 


columnNoNulls 
columnNullable 


columnNullableUnknown 





Public Methods 





Name Description 


getCatalogName 
getColumnCount 
getColumnDisplaySize 
getColumnLabel 
getColumnName 
getColumnType 
getColumnTypeName 
getPrecision 

getScale 
getSchemaName 
getTableName 
isAutoIncrement 
isCaseSensitive 
isCurrency 


isDefinitelyWritable 





isNullable 





isReadOnly 





isSearchable 





isSigned 














isWritable 











See Also 

Reference 
ResultSetMetaData Interface 
Concepts 

java.sql Package 


Visual J# Reference 


ResultSetMetaData Fields 


Public Fields 





Name 


Description 





columnNoNulls 





columnNullable 





columnNullableUnknown 











See Also 

Reference 
ResultSetMetaData Interface 
Concepts 

java.sql Package 





Visual J# Reference 


ResultSetMetaData.columnNoNulls Field 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public static final int columnNoNulls; 


See Also 

Reference 
ResultSetMetaData Interface 
Concepts 

ResultSetMetaData Members 
java.sql Package 


Visual J# Reference 


ResultSetMetaData.columnNullable Field 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public static final int columnNullable; 


See Also 

Reference 
ResultSetMetaData Interface 
Concepts 

ResultSetMetaData Members 
java.sql Package 


Visual J# Reference 


ResultSetMetaData.columnNullableUnknown Field 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public static final int columnNullableUnknown; 


See Also 

Reference 
ResultSetMetaData Interface 
Concepts 

ResultSetMetaData Members 
java.sql Package 


Visual J# Reference 


ResultSetMetaData Methods 


Public Methods 





Name 


Description 





getCatalogName 





getColumnCount 





getColumnDisplaySize 





getColumnLabel 





getColumnName 


getColumnType 


getColumnTypeName 


getPrecision 


getScale 


getSchemaName 


getTableName 


isAutolncrement 


isCaseSensitive 


isCurrency 


isDefinitelyWritable 


isNullable 


isReadOnly 


isSearchable 


isSigned 


isWritable 








See Also 

Reference 
ResultSetMetaData Interface 
Concepts 

java.sql Package 





Visual J# Reference 


ResultSetMetaData.getCatalogName Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String getCatalogName( 
int column) throws java.sql.SQLException; 


Parameters 
column 


See Also 

Reference 
ResultSetMetaData Interface 
Concepts 

ResultSetMetaData Members 
java.sql Package 


Visual J# Reference 


ResultSetMetaData.getColumnCount Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract int getColumnCount() throws java.sql.SQLException; 


See Also 

Reference 
ResultSetMetaData Interface 
Concepts 

ResultSetMetaData Members 
java.sql Package 


Visual J# Reference 


ResultSetMetaData.getColumnDisplaySize Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract int getColumnDisplaySize( 
int column) throws java.sql.SQLException; 


Parameters 
column 


See Also 

Reference 
ResultSetMetaData Interface 
Concepts 

ResultSetMetaData Members 
java.sql Package 


Visual J# Reference 


ResultSetMetaData.getColumnLabel Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String getColumnLabel( 
int column) throws java.sql.SQLException; 


Parameters 
column 


See Also 

Reference 
ResultSetMetaData Interface 
Concepts 

ResultSetMetaData Members 
java.sql Package 


Visual J# Reference 


ResultSetMetaData.getColumnName Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String getColumnName( 
int column) throws java.sql.SQLException; 


Parameters 
column 


See Also 

Reference 
ResultSetMetaData Interface 
Concepts 

ResultSetMetaData Members 
java.sql Package 


Visual J# Reference 


ResultSetMetaData.getColumnType Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract int getColumnType( 
int column) throws java.sql.SQLException; 


Parameters 
column 


See Also 

Reference 
ResultSetMetaData Interface 
Concepts 

ResultSetMetaData Members 
java.sql Package 


Visual J# Reference 


ResultSetMetaData.getColumnTypeName Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String getColumnTypeName( 
int column) throws java.sql.SQLException; 


Parameters 
column 


See Also 

Reference 
ResultSetMetaData Interface 
Concepts 

ResultSetMetaData Members 
java.sql Package 


Visual J# Reference 


ResultSetMetaData.getPrecision Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract int getPrecision( 
int column) throws java.sql.SQLException; 


Parameters 
column 


See Also 

Reference 
ResultSetMetaData Interface 
Concepts 

ResultSetMetaData Members 
java.sql Package 


Visual J# Reference 


ResultSetMetaData.getScale Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract int getScale( 
int column) throws java.sql.SQLException; 


Parameters 
column 


See Also 

Reference 
ResultSetMetaData Interface 
Concepts 

ResultSetMetaData Members 
java.sql Package 


Visual J# Reference 


ResultSetMetaData.getSchemaName Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String getSchemaName( 
int column) throws java.sql.SQLException; 


Parameters 
column 


See Also 

Reference 
ResultSetMetaData Interface 
Concepts 

ResultSetMetaData Members 
java.sql Package 


Visual J# Reference 


ResultSetMetaData.getTableName Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.String getTableName( 
int column) throws java.sql.SQLException; 


Parameters 
column 


See Also 

Reference 
ResultSetMetaData Interface 
Concepts 

ResultSetMetaData Members 
java.sql Package 


Visual J# Reference 


ResultSetMetaData.isAutolIncrement Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean isAutoIncrement( 
int column) throws java.sql.SQLException; 


Parameters 
column 


See Also 

Reference 
ResultSetMetaData Interface 
Concepts 

ResultSetMetaData Members 
java.sql Package 


Visual J# Reference 


ResultSetMetaData.isCaseSensitive Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean isCaseSensitive( 
int column) throws java.sql.SQLException; 


Parameters 
column 


See Also 

Reference 
ResultSetMetaData Interface 
Concepts 

ResultSetMetaData Members 
java.sql Package 


Visual J# Reference 


ResultSetMetaData.isCurrency Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean isCurrency( 
int column) throws java.sql.SQLException; 


Parameters 
column 


See Also 

Reference 
ResultSetMetaData Interface 
Concepts 

ResultSetMetaData Members 
java.sql Package 


Visual J# Reference 


ResultSetMetaData.isDefinitelyWritable Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean isDefinitelyWritable( 
int column) throws java.sql.SQLException; 


Parameters 
column 


See Also 

Reference 
ResultSetMetaData Interface 
Concepts 

ResultSetMetaData Members 
java.sql Package 


Visual J# Reference 


ResultSetMetaData.isNullable Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract int isNullable( 
int column) throws java.sql.SQLException; 


Parameters 
column 


See Also 

Reference 
ResultSetMetaData Interface 
Concepts 

ResultSetMetaData Members 
java.sql Package 


Visual J# Reference 


ResultSetMetaData.isReadOnly Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean isReadOnly( 
int column) throws java.sql.SQLException; 


Parameters 
column 


See Also 

Reference 
ResultSetMetaData Interface 
Concepts 

ResultSetMetaData Members 
java.sql Package 


Visual J# Reference 


ResultSetMetaData.isSearchable Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean isSearchable( 
int column) throws java.sql.SQLException; 


Parameters 
column 


See Also 

Reference 
ResultSetMetaData Interface 
Concepts 

ResultSetMetaData Members 
java.sql Package 


Visual J# Reference 


ResultSetMetaData.isSigned Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean isSigned( 
int column) throws java.sql.SQLException; 


Parameters 
column 


See Also 

Reference 
ResultSetMetaData Interface 
Concepts 

ResultSetMetaData Members 
java.sql Package 


Visual J# Reference 


ResultSetMetaData.isWritable Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean isWritable( 
int column) throws java.sql.SQLException; 


Parameters 
column 


See Also 

Reference 
ResultSetMetaData Interface 
Concepts 

ResultSetMetaData Members 
java.sql Package 


Visual J# Reference 


SQLException Class 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public class java.sql.SQLException 
extends java.lang.Exception 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.sql. SQLException 
java.sql.SQLWarning 


See Also 

Concepts 

SQLException Members 
java.sql Package 


Visual J# Reference 


SQLException Members 


The following tables list the members exposed by the SQLException type. 


Public Constructors 
Name 


SQLException 





Public Properties (see also Protected Properties ) 











Name Description 

HelpLink (inherited from Exception ) 
InnerException (inherited from Exception ) 
Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 


Protected Properties 





Name Description 





HResult (inherited from Exception ) 








Public Methods 











Name Description 

equals (inherited from Object ) 
filllnStackTrace (inherited from Throwable ) 
GetBaseException (inherited from Exception ) 
getErrorCode 

hashCode (inherited from Object ) 
getLocalizedMessage (inherited from Throwable ) 
getMessage (inherited from Throwable ) 
getNextException 

GetObjectData Overridden. 

getSQLState 





getClass (inherited from Object ) 














clone (inherited from Throwable ) 





printStackTrace Overloaded. (inherited from Throwable ) 





setNextException 





toString Overridden. 





Protected Methods 
Name 


finalize (inherited from Object ) 








See Also 
Reference 
SQLException Class 
Concepts 

java.sql Package 





Visual J# Reference 


SQLException Constructor 


Overload List 





Name Description 





SQLException () 





SQLException (String) 





SQLException (SerializationInfo, StreamingContext) 





SQLException (String, Exception) 





SQLException (String, String) 
SQLException (String, String, int) 


SQLException (String, String, int, Exception) 








See Also 

Reference 
SQLException Class 
Concepts 

SQLException Members 
java.sql Package 





Visual J# Reference 


SQLException Constructor () 


Initializes a new instance of the SQLException Class . 
Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 





public java.sql.SQLException(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
SQLException Class 
Concepts 

SQLException Members 
java.sql Package 


Visual J# Reference 


SQLException Constructor (String) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public java.sql.SQLException( 
java.lang.String reason); 


Parameters 
reason 


See Also 

Reference 
SQLException Class 
Concepts 

SQLException Members 
java.sql Package 


Visual J# Reference 


SQLException Constructor (SerializationInfo, 
StreamingContext) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


protected java.sql.SQLException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


context 


See Also 

Reference 
SQLException Class 
Concepts 

SQLException Members 
java.sql Package 


Visual J# Reference 


SQLException Constructor (String, Exception) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public java.sql.SQLException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
S 


inner 


See Also 

Reference 
SQLException Class 
Concepts 

SQLException Members 
java.sql Package 


Visual J# Reference 


SQLException Constructor (String, String) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public java.sql.SQLException( 
java.lang.String reason, 
java.lang.String SQLState); 


Parameters 
reason 


SQLState 


See Also 

Reference 
SQLException Class 
Concepts 

SQLException Members 
java.sql Package 


Visual J# Reference 


SQLException Constructor (String, String, Int32) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public java.sql.SQLException( 
java.lang.String reason, 
java.lang.String SQLState, 
int vendorCode) ; 


Parameters 
reason 


SQLState 
vendorCode 


See Also 

Reference 
SQLException Class 
Concepts 

SQLException Members 
java.sql Package 


Visual J# Reference 


SQLException Constructor (String, String, Int32, Exception) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public java.sql.SQLException( 
java.lang.String reason, 
java.lang.String SQLState, 
int vendorCode, 
System.Exception inner); 


Parameters 
reason 


SQLState 
vendorCode 
inner 


See Also 

Reference 
SQLException Class 
Concepts 

SQLException Members 
java.sql Package 


Visual J# Reference 


SQLException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





getErrorCode 





hashCode 


getLocalizedMessage 


getMessage 


getNextException 


GetObjectData 


getSQLState 


getClass 


clone 


printStackTrace 


setNextException 


toString 





Protected Methods 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


Overridden. 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


Overridden. 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


SQLException Class 
Concepts 
java.sql Package 








Visual J# Reference 


SQLException.getErrorCode Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public int getErrorCode(); 


See Also 

Reference 
SQLException Class 
Concepts 

SQLException Members 
java.sql Package 


Visual J# Reference 


SQLException.getNextException Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public java.sql.SQLException getNextException(); 


See Also 

Reference 
SQLException Class 
Concepts 

SQLException Members 
java.sql Package 


Visual J# Reference 


SQLException.GetObjectData Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public void GetObjectData( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


context 


See Also 

Reference 
SQLException Class 
Concepts 

SQLException Members 
java.sql Package 


Visual J# Reference 


SQLException.getSQLState Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getSQLState(); 


See Also 

Reference 
SQLException Class 
Concepts 

SQLException Members 
java.sql Package 


Visual J# Reference 


SQLException.setNextException Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public synchronized void setNextException( 
java.sql.SQLException ex); 


Parameters 
ex 


See Also 

Reference 
SQLException Class 
Concepts 

SQLException Members 
java.sql Package 


Visual J# Reference 


SQLException.toString Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toString(); 


See Also 

Reference 
SQLException Class 
Concepts 

SQLException Members 
java.sql Package 


Visual J# Reference 


SQLException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 
SQLException Class 
Concepts 

java.sql Package 








Visual J# Reference 


SQLWarning Class 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public class java.sql.SQLWarning 
extends java.sql.SQLException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.sql.SQLException 
java.sql SQLWarning 
java.sql.DataTruncation 


See Also 

Concepts 

SQLWarning Members 
java.sql Package 


Visual J# Reference 


SQLWarning Members 


The following tables list the members exposed by the SQLWarning type. 


Public Constructors 
Name 


SQLWarning 





Public Properties (see also Protected Properties ) 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 
Message 
Source 
StackTrace 


TargetSite 


Protected Properties 


(inherited from Exception ) 


(inherited from Exception ) 


(inherited from Exception ) 


(inherited from Exception ) 


(inherited from Exception ) 





Name 


Description 





HResult 





(inherited from Exception ) 





Public Methods 
Name 


equals 


filllnStackTrace 


GetBaseException 


getErrorCode 


hashCode 


getLocalizedMessage 


getMessage 


Description 


(inherited from Object ) 
(inherited from Throwable ) 
(inherited from Exception ) 
(inherited from SQLException ) 
(inherited from Object ) 
(inherited from Throwable ) 


(inherited from Throwable ) 





getNextException 


(inherited from SQLException ) 





getNextWarning 





GetObjectData 


(inherited from SQLException ) 





getSQLState 





(inherited from SQLException ) 











getClass 


(inherited from Object ) 





clone 


(inherited from Throwable ) 





printStackTrace 


Overloaded. (inherited from Throwable ) 





setNextException 


(inherited from SQLException ) 





setNextWarning 





toString 


(inherited from SQLException ) 





Protected Methods 
Name 


finalize 








(inherited from Object ) 





See Also 
Reference 
SQLWarning Class 
Concepts 

java.sql Package 





Visual J# Reference 


SQLWarning Constructor 


Overload List 





Name 


Description 





SQLWarning () 





SQLWarning (String) 





SQLWarning (SerializationInfo, StreamingContext) 





SQLWarning (String, Exception) 





SQLWarning (String, String) 
SQLWarning (String, String, int) 


SQLWarning (String, String, int, Exception) 





See Also 

Reference 
SQLWarning Class 
Concepts 

SQLWarning Members 
java.sql Package 








Visual J# Reference 


SQLWarning Constructor () 


Initializes a new instance of the SQLWarning Class . 
Package: java.sq 


Assembly: vjslib (in vjslib.dll) 





public java.sql.SQLWarning(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
SQLWarning Class 
Concepts 

SQLWarning Members 
java.sql Package 


Visual J# Reference 


SQLWarning Constructor (String) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public java.sql.SQLWarning( 
java.lang.String reason); 


Parameters 
reason 


See Also 

Reference 
SQLWarning Class 
Concepts 

SQLWarning Members 
java.sql Package 


Visual J# Reference 


SQLWarning Constructor (SerializationInfo, StreamingContext) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


protected java.sql.SQLWarning( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


context 


See Also 
Reference 


SQLWarning Class 
Concepts 

SQLWarning Members 
java.sql Package 


Visual J# Reference 


SQLWarning Constructor (String, Exception) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public java.sql.SQLWarning( 
java.lang.String s, 
System.Exception inner); 


Parameters 
S 


inner 


See Also 
Reference 


SQLWarning Class 
Concepts 

SQLWarning Members 
java.sql Package 


Visual J# Reference 


SQLWarning Constructor (String, String) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public java.sql.SQLWarning( 
java.lang.String reason, 
java.lang.String SQLState); 


Parameters 
reason 


SQLState 


See Also 
Reference 


SQLWarning Class 
Concepts 

SQLWarning Members 
java.sql Package 


Visual J# Reference 


SQLWarning Constructor (String, String, Int32) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public java.sql.SQLWarning( 
java.lang.String reason, 
java.lang.String SQLState, 
int vendorCode) ; 


Parameters 
reason 


SQLState 
vendorCode 


See Also 

Reference 
SQLWarning Class 
Concepts 

SQLWarning Members 
java.sql Package 


Visual J# Reference 


SQLWarning Constructor (String, String, Int32, Exception) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public java.sql.SQLWarning( 
java.lang.String reason, 
java.lang.String SQLState, 
int vendorCode, 
System.Exception inner); 


Parameters 
reason 


SQLState 
vendorCode 
inner 


See Also 

Reference 
SQLWarning Class 
Concepts 

SQLWarning Members 
java.sql Package 


Visual J# Reference 


SQLWarning Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





getErrorCode 


(inherited from SQLException ) 





hashCode 


getLocalizedMessage 


getMessage 


getNextException 


getNextWarning 


GetObjectData 


getSQLState 


getClass 


clone 


printStackTrace 


setNextException 


setNextWarning 


toString 


Protected Methods 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from SQLException ) 


(inherited from SQLException ) 


(inherited from SQLException ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from SQLException ) 


(inherited from SQLException ) 





Name 


Description 





finalize 








(inherited from Object ) 





See Also 
Reference 
SQLWarning Class 
Concepts 

java.sql Package 





Visual J# Reference 


SQLWarning.getNextWarning Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public java.sql.SQLWarning getNextWarning(); 


See Also 

Reference 
SQLWarning Class 
Concepts 

SQLWarning Members 
java.sql Package 


Visual J# Reference 


SQLWarning.setNextWarning Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public synchronized void setNextWarning( 
java.sql.SQLWarning nwg); 


Parameters 
nwg 


See Also 

Reference 
SQLWarning Class 
Concepts 

SQLWarning Members 
java.sql Package 


Visual J# Reference 


SQLWarning Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 
SQLWarning Class 
Concepts 

java.sql Package 








Visual J# Reference 


Statement Interface 


Package: java.sq 


Assembly: vjslib (in vjslib.dll) 





public interface java.sql.Statement 





See Also 

Concepts 

Statement Members 
java.sql Package 


Visual J# Reference 


Statement Members 


The following tables list the members exposed by the Statement type. 


Public Methods 
Name 


cancel 
clearWarnings 
close 


execute 


Description 





executeQuery 





executeUpdate 





getMaxFieldSize 





getMaxRows 





getMoreResults 





getQueryTimeout 





getResultSet 





getUpdateCount 





getWarnings 





setCursorName 





setEscapeProcessing 





setMaxFieldSize 





setMaxRows 





setQueryTimeout 











See Also 
Reference 
Statement Interface 
Concepts 

java.sql Package 





Visual J# Reference 


Statement Methods 


Public Methods 





Name 


Description 





cancel 





clearWarnings 





close 





execute 





executeQuery 


executeUpdate 


getMaxFieldSize 


getMaxRows 


getMoreResults 


getQueryTimeout 


getResultSet 


getUpdateCount 


getWarnings 


setCursorName 


setEscapeProcessing 


setMaxFieldSize 


setMaxRows 


setQueryTimeout 





See Also 
Reference 


Statement Interface 
Concepts 
java.sql Package 








Visual J# Reference 


Statement.cancel Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 





public abstract void cancel() throws java.sql.SQLException; 





See Also 

Reference 
Statement Interface 
Concepts 

Statement Members 
java.sql Package 


Visual J# Reference 


Statement.clearWarnings Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract void clearWarnings() throws java.sql.SQLException; 


See Also 

Reference 
Statement Interface 
Concepts 

Statement Members 
java.sql Package 


Visual J# Reference 


Statement.close Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 





public abstract void close() throws java.sql.SQLException; 





See Also 

Reference 
Statement Interface 
Concepts 

Statement Members 
java.sql Package 


Visual J# Reference 


Statement.execute Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean execute( 
java.lang.String sql) throws java.sql.SQLException; 


Parameters 
sql 


See Also 

Reference 
Statement Interface 
Concepts 

Statement Members 
java.sql Package 


Visual J# Reference 


Statement.executeQuery Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.ResultSet executeQuery( 
java.lang.String sql) throws java.sql.SQLException; 


Parameters 
sql 


See Also 

Reference 
Statement Interface 
Concepts 

Statement Members 
java.sql Package 


Visual J# Reference 


Statement.executeUpdate Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract int executeUpdate( 
java.lang.String sql) throws java.sql.SQLException; 


Parameters 
sql 


See Also 

Reference 
Statement Interface 
Concepts 

Statement Members 
java.sql Package 


Visual J# Reference 


Statement.getMaxFieldSize Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract int getMaxFieldSize() throws java.sql.SQLException; 


See Also 

Reference 
Statement Interface 
Concepts 

Statement Members 
java.sql Package 


Visual J# Reference 


Statement.getMaxRows Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract int getMaxRows() throws java.sql.SQLException; 


See Also 

Reference 
Statement Interface 
Concepts 

Statement Members 
java.sql Package 


Visual J# Reference 


Statement.getMoreResults Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean getMoreResults() throws java.sql.SQLException; 


See Also 

Reference 
Statement Interface 
Concepts 

Statement Members 
java.sql Package 


Visual J# Reference 


Statement.getQueryTimeout Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract int getQueryTimeout() throws java.sql.SQLException; 


See Also 

Reference 
Statement Interface 
Concepts 

Statement Members 
java.sql Package 


Visual J# Reference 


Statement.getResultSet Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.ResultSet getResultSet() throws java.sql.SQLException; 


See Also 

Reference 
Statement Interface 
Concepts 

Statement Members 
java.sql Package 


Visual J# Reference 


Statement.getUpdateCount Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract int getUpdateCount() throws java.sql.SQLException; 


See Also 

Reference 
Statement Interface 
Concepts 

Statement Members 
java.sql Package 


Visual J# Reference 


Statement.getWarnings Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public abstract java.sql.SQLWarning getWarnings() throws java.sql.SQLException; 


See Also 

Reference 
Statement Interface 
Concepts 

Statement Members 
java.sql Package 


Visual J# Reference 


Statement.setCursorName Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract void setCursorName( 
java.lang.String name) throws java.sql.SQLException; 


Parameters 
name 


See Also 

Reference 
Statement Interface 
Concepts 

Statement Members 
java.sql Package 


Visual J# Reference 


Statement.setEscapeProcessing Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract void setEscapeProcessing( 
boolean enable) throws java.sql.SQLException; 


Parameters 
enable 


See Also 

Reference 
Statement Interface 
Concepts 

Statement Members 
java.sql Package 


Visual J# Reference 


Statement.setMaxFieldSize Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract void setMaxFieldSize( 
int maxFieldSize) throws java.sql.SQLException; 


Parameters 
maxFieldSize 


See Also 

Reference 
Statement Interface 
Concepts 

Statement Members 
java.sql Package 


Visual J# Reference 


Statement.setMaxRows Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract void setMaxRows ( 
int maxRows) throws java.sql.SQLException; 


Parameters 
maxRows 


See Also 

Reference 
Statement Interface 
Concepts 

Statement Members 
java.sql Package 


Visual J# Reference 


Statement.setQueryTimeout Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public abstract void setQueryTimeout ( 
int queryTimeout) throws java.sql.SQLException; 


Parameters 
queryTimeout 


See Also 

Reference 
Statement Interface 
Concepts 

Statement Members 
java.sql Package 


Visual J# Reference 


Time Class 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public class java.sql.Time 
extends java.util.Date 





Inheritance Hierarchy 

java.lang.Object 
java.util.Date 
java.sql.Time 


See Also 
Concepts 

Time Members 
java.sql Package 


Visual J# Reference 


Time Members 


The following tables list the members exposed by the Time type. 


Public Constructors 


Name 


Time 





Public Methods 











getTimezoneOffset 


Name Description 

after Determines whether the Date object is after a given date. (inherited from Date) 
before Determines whether the Date object is before a given date. (inherited from Date) 
compareTo Compares two dates. (inherited from Date) 

equals Determines whether two Date objects are equal. (inherited from Date) 

getDate Gets a value indicating the date. (inherited from Date) 

getDay Gets a value indicating the day of the week. (inherited from Date) 

hashCode Generates a hash of the date. (inherited from Date) 

getHours Overridden. 

getMinutes Overridden. 

getMonth Gets a value indicating the month. (inherited from Date) 

getSeconds Overridden. 

getTime Gets a value indicating the time in milliseconds since epoch. (inherited from Date) 


Gets a value indicating the time zone offset in milliseconds. (inherited from Date) 




















getClass (inherited from Object ) 

getYear Gets a value indicating the year. (inherited from Date) 
clone (inherited from Date ) 

setDate Sets a value indicating the date. (inherited from Date) 
setHours Overridden. 

setMinutes Overridden. 

setMonth Overridden. 








setSeconds 


Overridden. 




















setTime Sets the time to the value represented in milliseconds since epoch. (inherited from Date) 
setYear Sets a value indicating the year. (inherited from Date) 

ToBoolean Converts an instance of a Date object to a Boolean. (inherited from Date) 

ToByte Converts an instance of a Date object to a Byte. (inherited from Date) 

ToChar Converts an instance of a Date object to a Char. (inherited from Date) 

ToDateTime Converts an instance of a Date object to a DateTime. (inherited from Date) 

ToDecimal Converts an instance of a Date object to a Decimal. (inherited from Date) 

ToDouble Converts an instance of a Date object to a Double. (inherited from Date) 

toGMTString Displays a value representing the date/time of a Date object in GMT. (inherited from Date) 
Tolnt16 Converts an instance of a Date object to an Int16. (inherited from Date) 

Tolnt32 Converts an instance of a Date object to an Int32. (inherited from Date) 

Tolnt64 Converts an instance of a Date object to an Int64. (inherited from Date) 





toLocaleString 


ToSByte 


ToSingle 


toString 


ToType 


ToUInt16 


ToUInt32 


ToUInt64 


valueOf 


Name 


finalize 





See Also 
Reference 

Time Class 
Concepts 
java.sql Package 





Displays a value representing the date/time of a Date object displayed in the format of current locale. (inhe 
rited from Date) 


Converts an instance of a Date object to a SByte. (inherited from Date) 
Converts an instance of a Date object to a Single. (inherited from Date) 
Overloaded. Overridden. 

Converts an instance of a Date object to a given Type. (inherited from Date) 
Converts an instance of a Date object to an Ulnt16. (inherited from Date) 
Converts an instance of a Date object to an Ulnt32. (inherited from Date) 


Converts an instance of a Date object to an Ulnt64. (inherited from Date) 


Protected Methods 


(inherited from Object ) 








Visual J# Reference 


Time Constructor 


Overload List 





Name 


Description 





Time (long) 





Time (int, int, int) 











See Also 
Reference 

Time Class 
Concepts 

Time Members 
java.sql Package 





Visual J# Reference 


Time Constructor (Int64) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public java.sql.Time( 
long msSinceEpoch) ; 





Parameters 
msSinceEpoch 


See Also 
Reference 

Time Class 
Concepts 

Time Members 
java.sql Package 


Visual J# Reference 


Time Constructor (Int32, Int32, Int32) 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public java.sql.Time( 
int hour, 
int minute, 
int second); 


Parameters 
hour 


minute 
second 


See Also 
Reference 

Time Class 
Concepts 

Time Members 
java.sql Package 


Visual J# Reference 


Time Methods 


Public Methods 




















getTimezoneOffset 


Name Description 

after Determines whether the Date object is after a given date. (inherited from Date ) 
before Determines whether the Date object is before a given date. (inherited from Date ) 
compareTo Compares two dates. (inherited from Date ) 

equals Determines whether two Date objects are equal. (inherited from Date ) 

getDate Gets a value indicating the date. (inherited from Date ) 

getDay Gets a value indicating the day of the week. (inherited from Date ) 

hashCode Generates a hash of the date. (inherited from Date ) 

getHours Overridden. 

getMinutes Overridden. 

getMonth Gets a value indicating the month. (inherited from Date ) 

getSeconds Overridden. 

getTime Gets a value indicating the time in milliseconds since epoch. (inherited from Date ) 


Gets a value indicating the time zone offset in milliseconds. (inherited from Date ) 





























getClass (inherited from Object ) 

getYear Gets a value indicating the year. (inherited from Date ) 

clone (inherited from Date ) 

setDate Sets a value indicating the date. (inherited from Date ) 

setHours Overridden. 

setMinutes Overridden. 

setMonth Overridden. 

setSeconds Overridden. 

setTime Sets the time to the value represented in milliseconds since epoch. (inherited from Date ) 
setYear Sets a value indicating the year. (inherited from Date ) 

















ToBoolean Converts an instance of a Date object to a Boolean. (inherited from Date ) 

ToByte Converts an instance of a Date object to a Byte. (inherited from Date ) 

ToChar Converts an instance of a Date object to a Char. (inherited from Date ) 

ToDateTime Converts an instance of a Date object to a DateTime. (inherited from Date ) 

ToDecimal Converts an instance of a Date object to a Decimal. (inherited from Date ) 

ToDouble Converts an instance of a Date object to a Double. (inherited from Date ) 

toGMTString Displays a value representing the date/time of a Date object in GMT. (inherited from Date ) 
Tolnt16 Converts an instance of a Date object to an Int16. (inherited from Date ) 

Tolnt32 Converts an instance of a Date object to an Int32. (inherited from Date ) 

Tolnt64 Converts an instance of a Date object to an Int64. (inherited from Date ) 





toLocaleString 


ToSByte 


ToSingle 


toString 


ToType 


ToUInt16 


ToUInt32 


ToUInt64 


valueOf 





Displays a value representing the date/time of a Date object displayed in the format of current locale. (inhe 
rited from Date ) 


Converts an instance of a Date object to a SByte. (inherited from Date ) 


Converts an instance of a Date object to a Single. (inherited from Date ) 


Overloaded. Overridden. 


Converts an instance of a Date object to a given Type. (inherited from Date ) 


Converts an instance of a Date object to an Ulnt16. (inherited from Date ) 


Converts an instance of a Date object to an Ulnt32. (inherited from Date ) 


Converts an instance of a Date object to an Ulnt64. (inherited from Date ) 


Protected Methods 





Name 


Description 





finalize 





(inherited from Object ) 








See Also 
Reference 

Time Class 
Concepts 
java.sql Package 





Visual J# Reference 


Time.getHours Method 


Package: java.sq 


Assembly: vjslib (in vjslib.dll) 





public int getHours(); 





See Also 
Reference 

Time Class 
Concepts 

Time Members 
java.sql Package 


Visual J# Reference 


Time.getMinutes Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public int getMinutes(); 


See Also 
Reference 

Time Class 
Concepts 

Time Members 
java.sql Package 


Visual J# Reference 


Time.getSeconds Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public int getSeconds(); 


See Also 
Reference 

Time Class 
Concepts 

Time Members 
java.sql Package 


Visual J# Reference 


Time.setHours Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public void setHours( 
int hour); 





Parameters 
hour 


See Also 
Reference 

Time Class 
Concepts 

Time Members 
java.sql Package 


Visual J# Reference 


Time.setMinutes Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public void setMinutes( 
int minute) ; 





Parameters 
minute 


See Also 
Reference 

Time Class 
Concepts 

Time Members 
java.sql Package 


Visual J# Reference 


Time.setMonth Method 


Package: java.sq 


Assembly: vjslib (in vjslib.dll) 


public void setMonth( 
int second); 





Parameters 
second 


See Also 
Reference 

Time Class 
Concepts 

Time Members 
java.sql Package 


Visual J# Reference 


Time.setSeconds Method 


Package: java.sq 


Assembly: vjslib (in vjslib.dll) 


public void setSeconds( 
int second); 





Parameters 
second 


See Also 
Reference 

Time Class 
Concepts 

Time Members 
java.sql Package 


Visual J# Reference 


Time.toString Method 


Overload List 





Name Description 





Time.ToString () 





Time.ToString (lFormatProvider) Converts an instance of a Date object to a String. 











See Also 
Reference 

Time Class 
Concepts 

Time Members 
java.sql Package 


Visual J# Reference 


Time.toString Method () 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toString(); 


See Also 
Reference 

Time Class 
Concepts 

Time Members 
java.sql Package 


Visual J# Reference 


Time.valueOf Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static java.sql.Time valueOf( 
java.lang.String s); 





Parameters 
Ss 


See Also 
Reference 

Time Class 
Concepts 

Time Members 
java.sql Package 


Visual J# Reference 


Timestamp Class 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public class java.sql.Timestamp 
extends java.util.Date 





Inheritance Hierarchy 

java.lang.Object 
java.util.Date 
java.sql.Timestamp 


See Also 

Concepts 

Timestamp Members 
java.sql Package 


Visual J# Reference 


Timestamp Members 


The following tables list the members exposed by the Timestamp type. 


Public Constructors 


Name 


Timestamp 


Description 





Public Methods 











getTimezoneOffset 


Name Description 

after Determines whether the Date object is after a given date. (inherited from Date) 
before Determines whether the Date object is before a given date. (inherited from Date) 
compareTo Compares two dates. (inherited from Date) 

equals Determines whether two Date objects are equal. (inherited from Date) 

getDate Gets a value indicating the date. (inherited from Date) 

getDay Gets a value indicating the day of the week. (inherited from Date) 

hashCode Generates a hash of the date. (inherited from Date) 

getHours Gets a value indicating the hours. (inherited from Date) 

getMinutes Gets a value indicating the minutes. (inherited from Date) 

getMonth Gets a value indicating the month. (inherited from Date) 

getNanos 

getSeconds Gets a value indicating the seconds. (inherited from Date) 

getTime Gets a value indicating the time in milliseconds since epoch. (inherited from Date) 


Gets a value indicating the time zone offset in milliseconds. (inherited from Date) 














getClass (inherited from Object ) 

getYear Gets a value indicating the year. (inherited from Date) 
clone (inherited from Date ) 

setDate Sets a value indicating the date. (inherited from Date) 
setHours Sets a value indicating the hours. (inherited from Date) 
setMinutes Sets a value indicating the minutes. (inherited from Date) 



































setMonth Sets a value indicating the month. (inherited from Date) 

setNanos 

setSeconds Sets a value indicating the seconds. (inherited from Date) 

setTime Sets the time to the value represented in milliseconds since epoch. (inherited from Date) 
setYear Sets a value indicating the year. (inherited from Date) 

ToBoolean Converts an instance of a Date object to a Boolean. (inherited from Date) 

ToByte Converts an instance of a Date object to a Byte. (inherited from Date) 

ToChar Converts an instance of a Date object to a Char. (inherited from Date) 

ToDateTime Converts an instance of a Date object to a DateTime. (inherited from Date) 

ToDecimal Converts an instance of a Date object to a Decimal. (inherited from Date) 

ToDouble Converts an instance of a Date object to a Double. (inherited from Date) 

toGMTString Displays a value representing the date/time of a Date object in GMT. (inherited from Date) 
Tolnt16 Converts an instance of a Date object to an Int16. (inherited from Date) 

Tolnt32 Converts an instance of a Date object to an Int32. (inherited from Date) 

Tolnt64 Converts an instance of a Date object to an Int64. (inherited from Date) 





toLocaleString 


Displays a value representing the date/time of a Date object displayed in the format of current locale. (inhe 
rited from Date) 





ToSByte Converts an instance of a Date object to a SByte. (inherited from Date) 
ToSingle Converts an instance of a Date object to a Single. (inherited from Date) 
toString Overloaded. Overridden. 

ToType Converts an instance of a Date object to a given Type. (inherited from Date) 
ToUInt16 Converts an instance of a Date object to an Ulnt16. (inherited from Date) 
ToUInt32 Converts an instance of a Date object to an Ulnt32. (inherited from Date) 
ToUInt64 Converts an instance of a Date object to an Ulnt64. (inherited from Date) 
valueOf 








Protected Methods 


Name 


finalize 





(inherited from Object ) 








See Also 
Reference 
Timestamp Class 
Concepts 
java.sql Package 


Visual J# Reference 


Timestamp Constructor 


Overload List 





Name 


Description 





Timestamp (long) 





Timestamp (int, int, int, int, int, int, int) 











See Also 

Reference 
Timestamp Class 
Concepts 

Timestamp Members 
java.sql Package 





Visual J# Reference 


Timestamp Constructor (Int64) 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public java.sql.Timestamp( 
long msSinceEpoch) ; 


Parameters 
msSinceEpoch 


See Also 

Reference 
Timestamp Class 
Concepts 

Timestamp Members 
java.sql Package 


Visual J# Reference 


Timestamp Constructor (Int32, Int32, Int32, Int32, Int32, Int32, 
Int32) 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public java.sql.Timestamp( 
int year, 
int month, 
int date, 
int hour, 
int minute, 
int second, 
int nano); 


Parameters 
year 


month 
date 
hour 
minute 
second 
nano 


See Also 
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Timestamp Methods 


Public Methods 




















getTimezoneOffset 


Name Description 

after Determines whether the Date object is after a given date. (inherited from Date ) 
before Determines whether the Date object is before a given date. (inherited from Date ) 
compareTo Compares two dates. (inherited from Date ) 

equals Determines whether two Date objects are equal. (inherited from Date ) 

getDate Gets a value indicating the date. (inherited from Date ) 

getDay Gets a value indicating the day of the week. (inherited from Date ) 

hashCode Generates a hash of the date. (inherited from Date ) 

getHours Gets a value indicating the hours. (inherited from Date ) 

getMinutes Gets a value indicating the minutes. (inherited from Date ) 

getMonth Gets a value indicating the month. (inherited from Date ) 

getNanos 

getSeconds Gets a value indicating the seconds. (inherited from Date ) 

getTime Gets a value indicating the time in milliseconds since epoch. (inherited from Date ) 


Gets a value indicating the time zone offset in milliseconds. (inherited from Date ) 


























getClass (inherited from Object ) 

getYear Gets a value indicating the year. (inherited from Date ) 
clone (inherited from Date ) 

setDate Sets a value indicating the date. (inherited from Date ) 
setHours Sets a value indicating the hours. (inherited from Date ) 
setMinutes Sets a value indicating the minutes. (inherited from Date ) 
setMonth Sets a value indicating the month. (inherited from Date ) 
setNanos 

setSeconds Sets a value indicating the seconds. (inherited from Date ) 























setTime Sets the time to the value represented in milliseconds since epoch. (inherited from Date ) 
setYear Sets a value indicating the year. (inherited from Date ) 

ToBoolean Converts an instance of a Date object to a Boolean. (inherited from Date ) 

ToByte Converts an instance of a Date object to a Byte. (inherited from Date ) 

ToChar Converts an instance of a Date object to a Char. (inherited from Date ) 

ToDateTime Converts an instance of a Date object to a DateTime. (inherited from Date ) 

ToDecimal Converts an instance of a Date object to a Decimal. (inherited from Date ) 

ToDouble Converts an instance of a Date object to a Double. (inherited from Date ) 

toGMTString Displays a value representing the date/time of a Date object in GMT. (inherited from Date ) 
Tolnt16 Converts an instance of a Date object to an Int16. (inherited from Date ) 

Tolnt32 Converts an instance of a Date object to an Int32. (inherited from Date ) 

Tolnt64 Converts an instance of a Date object to an Int64. (inherited from Date ) 





toLocaleString 


ToSByte 


ToSingle 


toString 


ToType 


ToUInt16 


ToUInt32 


ToUInt64 


valueOf 





Displays a value representing the date/time of a Date object displayed in the format of current locale. (inhe 
rited from Date ) 


Converts an instance of a Date object to a SByte. (inherited from Date ) 
Converts an instance of a Date object to a Single. (inherited from Date ) 
Overloaded. Overridden. 

Converts an instance of a Date object to a given Type. (inherited from Date ) 
Converts an instance of a Date object to an Ulnt16. (inherited from Date ) 
Converts an instance of a Date object to an Ulnt32. (inherited from Date ) 


Converts an instance of a Date object to an Ulnt64. (inherited from Date ) 


Protected Methods 





Name 


finalize 





See Also 
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(inherited from Object ) 
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Timestamp.getNanos Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public int getNanos(); 


See Also 
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Timestamp.setNanos Method 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public void setNanos( 
int nano); 





Parameters 
nano 


See Also 
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Timestamp.toString Method 


Overload List 





Name 


Description 





Timestamp.ToString () 








Timestamp.ToString (lFormatProvider) 





Converts an instance of a Date object to a String. 





See Also 
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Timestamp.toString Method () 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toString(); 


See Also 
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Timestamp.valueOf Method 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public static java.sql.Timestamp valueOf( 
java.lang.String s); 


Parameters 
S 


See Also 
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Types Class 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public class java.sql.Types 
extends java.lang.Object 





Inheritance Hierarchy 
java.lang.Object 
java.sql.Types 


See Also 
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java.sql Package 


Visual J# Reference 


Types Members 


The following tables list the members exposed by the Types type. 


Public Constructors 


Name Description 


Types 





Public Fields 





Name 


Description 





BIGINT 





BINARY 


BIT 


CHAR 


DATE 


DECIMAL 


DOUBLE 


FLOAT 


INTEGER 


LONGVARBINARY 


LONGVARCHAR 


NULL 


NUMERIC 


OTHER 


REAL 


SMALLINT 


TIME 





TIMESTAMP 





TINYINT 





VARBINARY 





VARCHAR 











Public Methods 


Name Description 
equals (inherited from Object ) 
hashCode (inherited from Object ) 
getClass (inherited from Object ) 
toString Overridden. 





Protected Methods 











Name Description 
finalize (inherited from Object ) 
MemberwiseClone Performs a shallow copy of the object. 











See Also 
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Types Fields 


Public Fields 





Name 


Description 





BIGINT 





BINARY 





BIT 





CHAR 





DATE 


DECIMAL 


DOUBLE 


FLOAT 


INTEGER 


LONGVARBINARY 


LONGVARCHAR 


NULL 


NUMERIC 


OTHER 


REAL 


SMALLINT 


TIME 


TIMESTAMP 


TINYINT 


VARBINARY 





VARCHAR 








See Also 
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Types.BIGINT Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 





public static final int BIGINT; 





See Also 
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Types.BINARY Field 


Package: java.sq 


Assembly: vjslib (in vjslib.dll) 





public static final int BINARY; 





See Also 
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Concepts 

Types Members 
java.sql Package 


Visual J# Reference 


Types.BIT Field 


Package: java.sq 


Assembly: vjslib (in vjslib.dll) 





public static final int BIT; 





See Also 
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Types.CHAR Field 


Package: java.sq 


Assembly: vjslib (in vjslib.dll) 





public static final int CHAR; 





See Also 
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Types.DATE Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 





public static final int DATE; 





See Also 
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Types.DECIMAL Field 


Package: java.sq 


Assembly: vjslib (in vjslib.dll) 





public static final int DECIMAL; 





See Also 
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Types.DOUBLE Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 





public static final int DOUBLE; 





See Also 
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Types.FLOAT Field 


Package: java.sq 


Assembly: vjslib (in vjslib.dll) 





public static final int FLOAT; 





See Also 
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Types.INTEGER Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 





public static final int INTEGER; 





See Also 
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Types.LONGVARBINARY Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int LONGVARBINARY; 


See Also 
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Types.LONGVARCHAR Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int LONGVARCHAR; 


See Also 
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Types.NULL Field 


Package: java.sq 


Assembly: vjslib (in vjslib.dll) 





public static final int NULL; 





See Also 
Reference 
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Types.NUMERIC Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int NUMERIC; 


See Also 
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java.sql Package 


Visual J# Reference 


Types.OTHER Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 





public static final int OTHER; 





See Also 
Reference 
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Types.REAL Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 





public static final int REAL; 





See Also 
Reference 
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Types.SMALLINT Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 





public static final int SMALLINT; 





See Also 
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Types.TIME Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 





public static final int TIME; 





See Also 
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Types. TIMESTAMP Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int TIMESTAMP; 


See Also 
Reference 
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Types.TINYINT Field 


Package: java.sq 


Assembly: vjslib (in vjslib.dll) 





public static final int TINYINT; 





See Also 
Reference 
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Types. VARBINARY Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public static final int VARBINARY; 


See Also 
Reference 
Types Class 
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Types Members 
java.sql Package 
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Types. VARCHAR Field 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 





public static final int VARCHAR; 





See Also 
Reference 
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Concepts 
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Types Constructor 


Initializes a new instance of the Types Class . 
Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 





public java.sql.Types(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 
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Types Methods 


Public Methods 





Name 


Description 




















equals (inherited from Object) 
hashCode (inherited from Object) 
getClass (inherited from Object) 
toString Overridden. 
Protected Methods 

Name Description 





finalize 


(inherited from Object) 





MemberwiseClone 





Performs a shallow copy of the object. 





See Also 
Reference 

Types Class 
Concepts 
java.sql Package 
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java.text 


Contains the classes used for processing text, numbers and dates. 





Classes 

Class Description 

Collator Contains methods used to sort and arrange strings of Unicode characters based on their decomposition an 
d strength. 

DateFormat Contains methods and properties used to format a Date object as a string and to parse a string into a Date 


DecimalFormat 


object. 


Contains methods and properties used to format a number as a string and to parse a string into a number. 
This class provides a default implementation of the abstract class NumberFormat. 





Format An abstract class used as the base class for the rest of the format classes in the java.text package. 
MessageFormat |Contains methods and properties used to format a message as a string and to parse a string into a messag 
e. A message is simply a collection of objects that are formatted according to their type. 

NumberFormat |Contains methods and properties used to format a number as a string and to parse a string into a number. 








SimpleDateFormat|Contains methods and properties used to format a Date object as a string and to parse a string into a Date 


object. 
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Breakiterator Class 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 





public abstract class java.text.BreakIterator 
extends java.lang.Object 
implements java.lang.Cloneable, java.io.Serializable 





Inheritance Hierarchy 
java.lang.Object 
java.text.Breaklterator 


See Also 

Concepts 

Breaklterator Members 
java.text Package 


Visual J# Reference 


Breakliterator Members 


The following tables list the members exposed by the Breakiterator type. 


Public Constructors 


Name 


Breaklterator 


Public Fields 








Name 


Description 





DONE 








Public Methods 





Name 


Description 





current 





equals 


(inherited from Object ) 





first 





following 





getAvailableLocales 





getCharacterlnstance 


Overloaded. 











hashCode (inherited from Object ) 
getLinelnstance Overloaded. 
getSentencelnstance Overloaded. 





getText 





getClass 


(inherited from Object ) 





getWordInstance 


Overloaded. 





last 





MemberwiseClone 


Performs a shallow copy of the members. 





next 


previous 


setText 


toString 





Protected Methods 





Overloaded. 


Overloaded. 


Overridden. 




















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


Breaklterator Class 
Concepts 
java.text Package 
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Breakliterator Fields 


Public Fields 





Name Description 





DONE 














See Also 
Reference 
Breaklterator Class 
Concepts 

java.text Package 
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Breakiterator.DONE Field 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 





public static final int DONE; 





See Also 

Reference 
Breaklterator Class 
Concepts 

Breaklterator Members 
java.text Package 
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Breakliterator Constructor 


Initializes a new instance of the Breaklterator Class . 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 





protected java.text.BreakIterator(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 
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java.text Package 


Visual J# Reference 


Breakiterator Methods 


Public Methods 





Name 


Description 





current 





equals 


(inherited from Object ) 





first 





following 





getAvailableLocales 


getCharacterlnstance 


hashCode 


getLinelnstance 


getSentencelnstance 


getText 


getClass 


getWordInstance 


last 


MemberwiseClone 


next 


previous 


setText 


toString 


Protected Methods 


Overloaded. 


(inherited from Object ) 


Overloaded. 


Overloaded. 


(inherited from Object ) 


Overloaded. 


Performs a shallow copy of the members. 


Overloaded. 


Overloaded. 


Overridden. 








Name 


Description 





finalize 





See Also 
Reference 
Breaklterator Class 
Concepts 

java.text Package 





(inherited from Object ) 
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Breakiterator.clone Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 





See Also 

Reference 
Breaklterator Class 
Concepts 

Breaklterator Members 
java.text Package 


Visual J# Reference 


Breakiterator.current Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public abstract int current(); 


See Also 

Reference 
Breaklterator Class 
Concepts 

Breaklterator Members 
java.text Package 
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Breakiterator.first Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 





public abstract int first(); 





See Also 

Reference 
Breaklterator Class 
Concepts 

Breaklterator Members 
java.text Package 
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Breakiterator.following Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public abstract int following( 
int pos); 


Parameters 
pos 


See Also 
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Breakiterator.getAvailableLocales Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static synchronized java.util.Locale[] getAvailableLocales(); 


See Also 

Reference 
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Concepts 

Breaklterator Members 
java.text Package 
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Breakiterator.getCharacterlInstance Method 


Overload List 





Name 


Description 





Breaklterator.getCharacterlnstance () 





Breaklterator.getCharacterInstance (Locale) 











See Also 

Reference 
Breaklterator Class 
Concepts 

Breaklterator Members 
java.text Package 
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Breaklterator.getCharacterInstance Method () 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static java.text.BreakIterator getCharacterInstance(); 


See Also 

Reference 
Breaklterator Class 
Concepts 

Breaklterator Members 
java.text Package 


Visual J# Reference 


Breakiterator.getCharacterInstance Method (Locale) 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static java.text.BreakIterator getCharacterInstance( 
java.util.Locale loc); 


Parameters 
loc 


See Also 

Reference 
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Concepts 

Breaklterator Members 
java.text Package 
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Breakliterator.getLinelnstance Method 


Overload List 





Name 


Description 





Breaklterator.getLinelnstance () 





Breaklterator.getLinelnstance (Locale) 











See Also 

Reference 
Breaklterator Class 
Concepts 

Breaklterator Members 
java.text Package 
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Breakiterator.getLinelnstance Method () 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static java.text.BreakIterator getLineInstance(); 


See Also 

Reference 
Breaklterator Class 
Concepts 

Breaklterator Members 
java.text Package 
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Breakliterator.getLinelnstance Method (Locale) 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static java.text.BreakIterator getLineInstance( 
java.util.Locale loc); 


Parameters 
loc 


See Also 

Reference 
Breaklterator Class 
Concepts 

Breaklterator Members 
java.text Package 
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Breakiterator.getSentencelnstance Method 


Overload List 





Name 


Description 





Breaklterator.getSentencelnstance () 





Breaklterator.getSentencelnstance (Locale) 











See Also 

Reference 
Breaklterator Class 
Concepts 

Breaklterator Members 
java.text Package 
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Breakiterator.getSentencelnstance Method () 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static java.text.BreakIterator getSentenceInstance(); 


See Also 

Reference 
Breaklterator Class 
Concepts 

Breaklterator Members 
java.text Package 
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Breaklterator.getSentencelnstance Method (Locale) 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static java.text.BreakIterator getSentenceInstance( 
java.util.Locale loc); 


Parameters 
loc 


See Also 

Reference 
Breaklterator Class 
Concepts 

Breaklterator Members 
java.text Package 
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Breakiterator.getText Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public abstract java.text.CharacterIterator getText(); 


See Also 

Reference 
Breaklterator Class 
Concepts 

Breaklterator Members 
java.text Package 
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Breakiterator.getWordInstance Method 


Overload List 





Name 


Description 





Breaklterator.getWordInstance () 





Breaklterator.getWordInstance (Locale) 











See Also 

Reference 
Breaklterator Class 
Concepts 

Breaklterator Members 
java.text Package 
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Breakiterator.getWordInstance Method () 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static java.text.BreakIterator getwWordInstance(); 


See Also 

Reference 
Breaklterator Class 
Concepts 

Breaklterator Members 
java.text Package 
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Breaklterator.getWordInstance Method (Locale) 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static java.text.BreakIterator getwWordInstance( 
java.util.Locale loc); 


Parameters 
loc 


See Also 

Reference 
Breaklterator Class 
Concepts 

Breaklterator Members 
java.text Package 
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Breakiterator.last Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 





public abstract int last(); 





See Also 

Reference 
Breaklterator Class 
Concepts 

Breaklterator Members 
java.text Package 
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Breakiterator.next Method 


Overload List 





Name 


Description 





Breaklterator.next () 





Breaklterator.next (int) 











See Also 

Reference 
Breaklterator Class 
Concepts 

Breaklterator Members 
java.text Package 
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Breakiterator.next Method () 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 





public abstract int next(); 





See Also 

Reference 
Breaklterator Class 
Concepts 

Breaklterator Members 
java.text Package 
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Breakiterator.next Method (Int32) 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public abstract int next( 
int n); 


Parameters 
n 


See Also 

Reference 
Breaklterator Class 
Concepts 

Breaklterator Members 
java.text Package 
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Breaklterator.previous Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public abstract int previous(); 


See Also 

Reference 
Breaklterator Class 
Concepts 

Breaklterator Members 
java.text Package 
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Breakiterator.setText Method 


Overload List 





Name Description 





Breaklterator.setText (Characterlterator) 





Breaklterator.setText (String) 











See Also 

Reference 
Breaklterator Class 
Concepts 

Breaklterator Members 
java.text Package 
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Breakliterator.setText Method (Characterlterator) 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public abstract void setText( 
java.text.CharacterIterator newText); 


Parameters 
newText 


See Also 

Reference 
Breaklterator Class 
Concepts 

Breaklterator Members 
java.text Package 
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Breakiterator.setText Method (String) 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setText( 
java.lang.String newText) ; 


Parameters 
newText 


See Also 

Reference 
Breaklterator Class 
Concepts 

Breaklterator Members 
java.text Package 
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Characterlterator Interface 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public interface java.text.CharacterIterator 
extends java.lang.Cloneable 





See Also 

Concepts 

Characterlterator Members 
java.text Package 
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Characterlterator Members 


The following tables list the members exposed by the Characterlterator type. 


Public Fields 


Name Description 


DONE 





Public Methods 





Name Description 





current 





first 


getBeginIndex 


getEndIndex 


getindex 


last 


clone 


next 


previous 


setindex 





See Also 

Reference 
Characterlterator Interface 
Concepts 

java.text Package 
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Characterlterator Fields 


Public Fields 





Name Description 





DONE 














See Also 

Reference 
Characterlterator Interface 
Concepts 

java.text Package 
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Characterlterator.DONE Field 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 





public static final char DONE; 





See Also 

Reference 
Characterlterator Interface 
Concepts 

Characterlterator Members 
java.text Package 


Visual J# Reference 


Characterlterator Methods 


Public Methods 





Name Description 





current 





first 





getBeginIndex 





getEndIndex 





getIndex 


last 


clone 


next 


previous 


setindex 





See Also 

Reference 
Characterlterator Interface 
Concepts 

java.text Package 
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Characterlterator.clone Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.Object clone(); 


See Also 

Reference 
Characterlterator Interface 
Concepts 

Characterlterator Members 
java.text Package 
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Characterlterator.current Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public abstract char current(); 


See Also 

Reference 
Characterlterator Interface 
Concepts 

Characterlterator Members 
java.text Package 
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Characterlterator.first Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 





public abstract char first(); 





See Also 

Reference 
Characterlterator Interface 
Concepts 

Characterlterator Members 
java.text Package 
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Characterlterator.getBeginIndex Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public abstract int getBeginIndex(); 


See Also 

Reference 
Characterlterator Interface 
Concepts 

Characterlterator Members 
java.text Package 
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Characterlterator.getEndIndex Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public abstract int getEndIndex(); 


See Also 

Reference 
Characterlterator Interface 
Concepts 

Characterlterator Members 
java.text Package 


Visual J# Reference 


Characterlterator.getindex Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public abstract int getIndex(); 


See Also 

Reference 
Characterlterator Interface 
Concepts 

Characterlterator Members 
java.text Package 


Visual J# Reference 


Characterlterator.last Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 





public abstract char last(); 





See Also 

Reference 
Characterlterator Interface 
Concepts 

Characterlterator Members 
java.text Package 


Visual J# Reference 


Characterlterator.next Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 





public abstract char next(); 





See Also 

Reference 
Characterlterator Interface 
Concepts 

Characterlterator Members 
java.text Package 


Visual J# Reference 


Characterlterator.previous Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public abstract char previous(); 


See Also 

Reference 
Characterlterator Interface 
Concepts 

Characterlterator Members 
java.text Package 


Visual J# Reference 


Characterlterator.setindex Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public abstract char setIndex( 
int idx); 


Parameters 
idx 


See Also 

Reference 
Characterlterator Interface 
Concepts 

Characterlterator Members 
java.text Package 


Visual J# Reference 


ChoiceFormat Class 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public class java.text.ChoiceFormat 
extends java.text.NumberFormat 





Inheritance Hierarchy 
java.lang.Object 
java.text.Format 
java.text.NumberFormat 
java.text.ChoiceFormat 


See Also 

Concepts 

ChoiceFormat Members 
java.text Package 


Visual J# Reference 


ChoiceFormat Members 


The following tables list the members exposed by the ChoiceFormat type. 


Public Constructors 


Name Description 


ChoiceFormat 





Public Methods 











Name Description 
applyPattern 

equals Overridden. 
format Overloaded. 
getFormats 

hashCode Overridden. 
getLimits 


getMaximumFractionDigits|Gets a value representing the maximum number of digits displayed in the fractional part of the nu 
mber. (inherited from NumberFormat) 





getMaximumintegerDigits |Gets a value representing the maximum number of digits displayed in the integer part of the num 
ber. (inherited from NumberFormat) 


getMinimumFractionDigits |Gets a value representing the minimum number of digits displayed in the fractional part of the nu 
mber. (inherited from NumberFormat) 





getMinimumIntegerDigits |Gets a value representing the minimum number of digits displayed in the integer part of the numb 
er. (inherited from NumberFormat) 


getClass (inherited from Object ) 
isGroupingUsed Determines whether digits are being grouped together. (inherited from NumberFormat) 
isParselntegerOnly Determines whether only the integer portion of the number is being parsed or if the fractional part 


is also included. (inherited from NumberFormat) 








clone 

nextDouble Overloaded. 

parse Overloaded. 

parseObject Overloaded. Parses a string into an Object. (inherited from NumberFormat) 


previousDouble 


setChoices 











setGroupingUsed Sets a value determining whether digits are being grouped together. (inherited from 
NumberFormat) 





setMaximumFractionDigits |Sets the value representing the maximum number of digits displayed in the fractional part of the n 
umber. (inherited from NumberFormat) 






setMaximumIntegerDigits |Sets the value representing the maximum number of digits displayed in the integer part of the nu 
mber. (inherited from NumberFormat) 





setMinimumFractionDigits |Sets the value representing the minimum number of digits displayed in the fractional part of the n 
umber. (inherited from NumberFormat) 


setMinimumIntegerDigits |Sets the value representing the minimum number of digits displayed in the integer part of the nu 
mber. (inherited from NumberFormat) 





setParselntegerOnly Sets a value determining whether only the integer portion of the number is being parsed or if the f 
ractional part is also included. (inherited from NumberFormat) 





toPattern 





toString Displays a human-readable representation of a Format object. (inherited from Format) 





Protected Methods 
Name 


finalize (inherited from Object ) 








See Also 
Reference 
ChoiceFormat Class 
Concepts 

java.text Package 





Visual J# Reference 


ChoiceFormat Constructor 


Overload List 





Name 


Description 





ChoiceFormat (String) 





ChoiceFormat (doublef], String[]) 











See Also 

Reference 
ChoiceFormat Class 
Concepts 

ChoiceFormat Members 
java.text Package 





Visual J# Reference 


ChoiceFormat Constructor (String) 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.text.ChoiceFormat( 
java.lang.String newPattern) ; 


Parameters 
newPattern 


See Also 

Reference 
ChoiceFormat Class 
Concepts 

ChoiceFormat Members 
java.text Package 


Visual J# Reference 


ChoiceFormat Constructor (Double[ J, String[ ]) 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.text.ChoiceFormat( 
double[] limits, 
java.lang.String[] strings); 


Parameters 
limits 


strings 


See Also 

Reference 
ChoiceFormat Class 
Concepts 

ChoiceFormat Members 
java.text Package 
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ChoiceFormat Methods 


Public Methods 




















Name Description 
applyPattern 

equals Overridden. 
format Overloaded. 
getFormats 

hashCode Overridden. 
getLimits 


getMaximumFractionDigits|Gets a value representing the maximum number of digits displayed in the fractional part of the nu 
mber. (inherited from NumberFormat ) 





getMaximumintegerDigits |Gets a value representing the maximum number of digits displayed in the integer part of the num 
ber. (inherited from NumberFormat ) 


getMinimumFractionDigits |Gets a value representing the minimum number of digits displayed in the fractional part of the nu 
mber. (inherited from NumberFormat ) 





getMinimumIntegerDigits |Gets a value representing the minimum number of digits displayed in the integer part of the numb 
er. (inherited from NumberFormat ) 


getClass (inherited from Object ) 
isGroupingUsed Determines whether digits are being grouped together. (inherited from NumberFormat ) 
isParselntegerOnly Determines whether only the integer portion of the number is being parsed or if the fractional part 


is also included. (inherited from NumberFormat ) 














clone 

nextDouble Overloaded. 

parse Overloaded. 

parseObject Overloaded. Parses a string into an Object. (inherited from NumberFormat ) 





previousDouble 
setChoices 


setGroupingUsed Sets a value determining whether digits are being grouped together. (inherited from 
NumberFormat ) 





setMaximumFractionDigits |Sets the value representing the maximum number of digits displayed in the fractional part of the n 
umber. (inherited from NumberFormat ) 











setMaximumIntegerDigits 


Sets the value representing the maximum number of digits displayed in the integer part of the nu 
mber. (inherited from NumberFormat ) 





setMinimumIntegerDigits 


setMinimumFractionDigits 


Sets the value representing the minimum number of digits displayed in the fractional part of the n 
umber. (inherited from NumberFormat ) 


Sets the value representing the minimum number of digits displayed in the integer part of the nu 
mber. (inherited from NumberFormat ) 





setParselntegerOnly 


toPattern 


toString 





Sets a value determining whether only the integer portion of the number is being parsed or if the f 
ractional part is also included. (inherited from NumberFormat ) 


Displays a human-readable representation of a Format object. (inherited from Format ) 





Protected Methods 
Name 


finalize 





See Also 
Reference 
ChoiceFormat Class 
Concepts 

java.text Package 


Description 





(inherited from Object ) 
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ChoiceFormat.applyPattern Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void applyPattern( 
java.lang.String newPattern) ; 


Parameters 
newPattern 


See Also 

Reference 
ChoiceFormat Class 
Concepts 

ChoiceFormat Members 
java.text Package 


Visual J# Reference 


ChoiceFormat.clone Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object clone(); 


See Also 

Reference 
ChoiceFormat Class 
Concepts 

ChoiceFormat Members 
java.text Package 


Visual J# Reference 


ChoiceFormat.equals Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public boolean equals( 
java.lang.Object obj); 





Parameters 


obj 


See Also 

Reference 
ChoiceFormat Class 
Concepts 

ChoiceFormat Members 
java.text Package 


Visual J# Reference 


ChoiceFormat.format Method 


Overload List 





Name 


Description 





ChoiceFormat.format (double) 


Formats a double into a string. 





ChoiceFormat.format (long) 


Formats a long into a string. 





ChoiceFormat.ormat (Object) 


Formats an object into a string. 





ChoiceFormat.ormat (double, StringBuffer, FieldPosition) 





ChoiceFormat.format (long, StringBuffer, FieldPosition) 


ChoiceFormat.format (Object, StringBuffer, FieldPosition) 





See Also 

Reference 
ChoiceFormat Class 
Concepts 

ChoiceFormat Members 
java.text Package 





Formats an Object and appends it to a StringBuffer object. 
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ChoiceFormat.format Method (Double, StringBuffer, 
FieldPosition) 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.StringBuffer format( 
double num, 
java.lang.StringBuffer appendBuf, 
java.text.FieldPosition pos); 


Parameters 
num 


appendBuf 
pos 


See Also 

Reference 
ChoiceFormat Class 
Concepts 

ChoiceFormat Members 
java.text Package 
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ChoiceFormat.format Method (Int64,StringBuffer, 
FieldPosition) 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.StringBuffer format( 
long num, 
java.lang.StringBuffer appendBuf, 
java.text.FieldPosition pos); 


Parameters 
num 


appendBuf 
pos 


See Also 

Reference 
ChoiceFormat Class 
Concepts 

ChoiceFormat Members 
java.text Package 


Visual J# Reference 


ChoiceFormat.getFormats Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object[] getFormats(); 


See Also 

Reference 
ChoiceFormat Class 
Concepts 

ChoiceFormat Members 
java.text Package 
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ChoiceFormat.hashCode Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public int hashCode(); 


See Also 

Reference 
ChoiceFormat Class 
Concepts 

ChoiceFormat Members 
java.text Package 
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ChoiceFormat.getLimits Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public double[] getLimits(); 


See Also 

Reference 
ChoiceFormat Class 
Concepts 

ChoiceFormat Members 
java.text Package 
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ChoiceFormat.nextDouble Method 


Overload List 





Name Description 





ChoiceFormat.nextDouble (double) 





ChoiceFormat.nextDouble (double, boolean) 











See Also 

Reference 
ChoiceFormat Class 
Concepts 

ChoiceFormat Members 
java.text Package 
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ChoiceFormat.nextDouble Method (Double) 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final double nextDouble( 
double d); 


Parameters 


d 


See Also 

Reference 
ChoiceFormat Class 
Concepts 

ChoiceFormat Members 
java.text Package 
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ChoiceFormat.nextDouble Method (Double, Boolean) 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static double nextDouble( 
double db1Num, 
boolean next); 


Parameters 


dblINum 
next 


See Also 

Reference 
ChoiceFormat Class 
Concepts 

ChoiceFormat Members 
java.text Package 
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ChoiceFormat.parse Method 


Overload List 





Name Description 





ChoiceFormat.parse (String) Parses a string into a number represented by a Number object. 





ChoiceFormat.parse (String, ParsePosition) 











See Also 

Reference 
ChoiceFormat Class 
Concepts 

ChoiceFormat Members 
java.text Package 
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ChoiceFormat.parse Method (String, ParsePosition) 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Number parse( 
java.lang.String sourceStr, 
java.text.ParsePosition pos); 


Parameters 
sourceStr 


pos 


See Also 

Reference 
ChoiceFormat Class 
Concepts 

ChoiceFormat Members 
java.text Package 


Visual J# Reference 


ChoiceFormat.previousDouble Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final double previousDouble( 
double d); 


Parameters 


d 


See Also 

Reference 
ChoiceFormat Class 
Concepts 

ChoiceFormat Members 
java.text Package 
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ChoiceFormat.setChoices Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setChoices( 
double[] limits, 
java.lang.String[] strings); 


Parameters 
limits 


strings 


See Also 

Reference 
ChoiceFormat Class 
Concepts 

ChoiceFormat Members 
java.text Package 
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ChoiceFormat.toPattern Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toPattern(); 


See Also 

Reference 
ChoiceFormat Class 
Concepts 

ChoiceFormat Members 
java.text Package 


Visual J# Reference 


CollationKey Class 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 





public final class java.text.CollationKey 
extends java.lang.Object 
implements java.lang.Comparable 





Inheritance Hierarchy 
java.lang.Object 
java.text.CollationKey 


See Also 

Concepts 

CollationKey Members 
java.text Package 


Visual J# Reference 


CollationKey Members 


The following tables list the members exposed by the CollationKey type. 


Public Methods 


Name Description 
compareTo Overloaded. 
equals Overridden. 
hashCode Overridden. 


getSourceString 











getClass (inherited from Object ) 
toByteArray 
toString Overridden. 





Protected Members 
Name 


MemberwiseClone Performs a shallow copy of the members. 








See Also 
Reference 
CollationKey Class 
Concepts 

java.text Package 





Visual J# Reference 


CollationKey Methods 


Public Methods 





Name 


Description 











compareTo Overloaded. 
equals Overridden. 
hashCode Overridden. 





getSourceString 





getClass 


toByteArray 


toString 


Protected Methods 


(inherited from Object ) 


Overridden. 








Name 


Description 





MemberwiseClone 





Performs a shallow copy of the members. 





See Also 
Reference 
CollationKey Class 
Concepts 

java.text Package 
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CollationKey.compareTo Method 


Overload List 





Name 


Description 





CollationKey.compareTo (CollationKey) 





CollationKey.compareTo (Object) 











See Also 

Reference 
CollationKey Class 
Concepts 

CollationKey Members 
java.text Package 
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CollationKey.compareTo Method (CollationKey) 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public int compareTo( 
java.text.CollationKey target); 


Parameters 
target 


See Also 

Reference 
CollationKey Class 
Concepts 

CollationKey Members 
java.text Package 
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CollationKey.compareTo Method (Object) 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public int compareTo( 
java.lang.Object obj); 


Parameters 


obj 


See Also 

Reference 
CollationKey Class 
Concepts 

CollationKey Members 
java.text Package 


Visual J# Reference 


CollationKey.equals Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public boolean equals( 
java.lang.Object target); 


Parameters 
target 


See Also 

Reference 
CollationKey Class 
Concepts 

CollationKey Members 
java.text Package 


Visual J# Reference 


CollationKey.hashCode Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public int hashCode(); 


See Also 

Reference 
CollationKey Class 
Concepts 

CollationKey Members 
java.text Package 


Visual J# Reference 


CollationKey.getSourceString Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getSourceString(); 


See Also 

Reference 
CollationKey Class 
Concepts 

CollationKey Members 
java.text Package 
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CollationKey.toByteArray Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public byte[] toByteArray(); 


See Also 

Reference 
CollationKey Class 
Concepts 

CollationKey Members 
java.text Package 


Visual J# Reference 


Collator Class 


Contains methods used to sort and arrange strings of Unicode characters based on their decomposition and strength. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 





public abstract class java.text.Collator 
extends java.lang.Object 
implements java.lang.Cloneable, java.io.Serializable 





Inheritance Hierarchy 
java.lang.Object 
java.text.Collator 
java.text.RuleBasedCollator 


See Also 
Concepts 

Collator Members 
java.text Package 
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Collator Members 


Contains methods used to sort and arrange strings of Unicode characters based on their decomposition and strength. 


The following tables list the members exposed by the Collator type. 


Public Constructors 





Name Description 





Collator Initializes a new instance of a Collator object. 





Public Fields 
Name Description 


CANONICAL_DECOMPOSITION|The flag used to indicate that all characters are to be decomposed before collation. All precom 


posed or combined characters are to be decomposed as defined by the Unicode standard. 


FULL_DECOMPOSITION The flag used to indicate that all characters are to be decomposed before collation by doing b 
oth canonical and compatibility decomposition as defined by the Unicode standard. 





IDENTICAL The flag used to indicate that two characters are considered equal only if they are equal in thei 
r binary values regardless of their Unicode or language properties. 


NO_DECOMPOSITION The flag used to indicate that accented or precomposed characters should not be decomposed 
before collation. 





PRIMARY The flag used to indicate that two characters are equal if the base characters are equal while a 
ccent and case are ignored. 


SECONDARY The flag used to indicate that two characters are equal if their PRIMARY strengths as well as th 
eir accents are equal. The case of the character is ignored. 





TERTIARY The flag used to indicate that two characters are equal if their SECONDARY strengths as well a 
s their case are equal. 


Public Methods 














Name Description 

compare Compares two strings for equality. 

equals Determines whether two strings are equal. 

equals Overridden. Determines whether two Collator objects are equal. 





getAvailableLocales|Gets an array of all Locale objects that are supported by the Collator class. 





getCollationKey —_|Gets an instance of a CollationKey object for the given string. 






getDecomposition |Gets the decomposition type being used for collation. 


hashCode Overridden. Serves as a hash function for a particular type, suitable for use in hashing algorithms and data 
structures like a hash table. 





getinstance Overloaded. Gets an instance of a Collator object. 














getStrength Gets the strength type being used for collation. 





getClass (inherited from Object) 





MemberwiseClone |Performs a shallow copy of the members. 





setDecomposition |Sets the decomposition type being used for collation. 





setStrength Sets the strength type being used for collation. 





toString Overridden. Displays a human-readable representation of a Collator object. 





Protected Methods 
Name 





Description 


finalize (inherited from Object) 











See Also 
Reference 
Collator Class 
Concepts 
java.text Package 
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Collator Fields 


Public Fields 





Name 


Description 





FULL_DECOMPOSITION 


CANONICAL_DECOMPOSITION|The flag used to indicate that all characters are to be decomposed before collation. All precom 


posed or combined characters are to be decomposed as defined by the Unicode standard. 


The flag used to indicate that all characters are to be decomposed before collation by doing b 
oth canonical and compatibility decomposition as defined by the Unicode standard. 





IDENTICAL 


NO_DECOMPOSITION 


The flag used to indicate that two characters are considered equal only if they are equal in thei 
r binary values regardless of their Unicode or language properties. 


The flag used to indicate that accented or precomposed characters should not be decomposed 
before collation. 














PRIMARY The flag used to indicate that two characters are equal if the base characters are equal while a 
ccent and case are ignored. 

SECONDARY The flag used to indicate that two characters are equal if their PRIMARY strengths as well as th 
eir accents are equal. The case of the character is ignored. 

TERTIARY The flag used to indicate that two characters are equal if their SECONDARY strengths as well a 
s their case are equal. 

See Also 

Reference 

Collator Class 

Concepts 


java.text Package 
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Collator.CANONICAL_DECOMPOSITION Field 


The flag used to indicate that all characters are to be decomposed before collation. All precomposed or combined characters 
are to be decomposed as defined by the Unicode standard. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final int CANONICAL_DECOMPOSITION; 


See Also 
Reference 
Collator Class 
Concepts 

Collator Members 
java.text Package 
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Collator.FULL_DECOMPOSITION Field 


The flag used to indicate that all characters are to be decomposed before collation by doing both canonical and compatibility 
decomposition as defined by the Unicode standard. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final int FULL_DECOMPOSITION; 


See Also 
Reference 
Collator Class 
Concepts 

Collator Members 
java.text Package 


Visual J# Reference 


Collator.IDENTICAL Field 


The flag used to indicate that two characters are considered equal only if they are equal in their binary values regardless of 
their Unicode or language properties. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final int IDENTICAL; 


See Also 
Reference 
Collator Class 
Concepts 

Collator Members 
java.text Package 
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Collator.NO_DECOMPOSITION Field 


The flag used to indicate that accented or precomposed characters should not be decomposed before collation. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final int NO_DECOMPOSITION; 


Remarks 


Using this flag will block any pre-processing on strings for collation and hence the comparisons may produce unexpected 
results if accented characters are present and they are desired to be treated as equal. 


See Also 
Reference 
Collator Class 
Concepts 

Collator Members 
java.text Package 
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Collator.PRIMARY Field 


The flag used to indicate that two characters are equal if the base characters are equal while accent and case are ignored. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final int PRIMARY; 


See Also 
Reference 
Collator Class 
Concepts 

Collator Members 
java.text Package 
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Collator.SECONDARY Field 


The flag used to indicate that two characters are equal if their PRIMARY strengths as well as their accents are equal. The case of 
the character is ignored. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final int SECONDARY; 


See Also 
Reference 
Collator Class 
Concepts 

Collator Members 
java.text Package 
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Collator. TERTIARY Field 


The flag used to indicate that two characters are equal if their SECONDARY strengths as well as their case are equal. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final int TERTIARY; 


See Also 
Reference 
Collator Class 
Concepts 

Collator Members 
java.text Package 


Visual J# Reference 


Collator Constructor 


Initializes a new instance of a Collator object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 





protected java.text.Collator(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 
Reference 
Collator Class 
Concepts 

Collator Members 
java.text Package 
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Collator Methods 


Public Methods 














Name Description 

compare Compares two strings for equality. 

equals Determines whether two strings are equal. 

equals Overridden. Determines whether two Collator objects are equal. 





getAvailableLocales|Gets an array of all Locale objects that are supported by the Collator class. 





getCollationKey —_|Gets an instance of a CollationKey object for the given string. 


getDecomposition |Gets the decomposition type being used for collation. 





hashCode Overridden. Serves as a hash function for a particular type, suitable for use in hashing algorithms and data 
structures like a hash table. 











getinstance Overloaded. Gets an instance of a Collator object. 
getStrength Gets the strength type being used for collation. 
getClass (inherited from Object) 





MemberwiseClone |Performs a shallow copy of the members. 





setDecomposition |Sets the decomposition type being used for collation. 





setStrength Sets the strength type being used for collation. 





toString Overridden. Displays a human-readable representation of a Collator object. 





Protected Methods 


Name Description 


finalize (inherited from Object) 








See Also 
Reference 
Collator Class 
Concepts 
java.text Package 
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Collator.clone Method 


Creates an instance of a Collator object that is a deep copy of the current Collator object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


Return Value 
An instance of a Collator object that is a deep copy of the current Collator object. 


See Also 
Reference 
Collator Class 
Concepts 

Collator Members 
java.text Package 
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Collator.compare Method 


Compares two strings for equality. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public abstract int compare( 
java.lang.String source, 
java.lang.String target); 


Parameters 
source 
The first string to compare for equality. 
target 
The second string to compare for equality. 
Return Value 
-1 if source is less than target; 0 if source and target are equal; or 1 if source is greater than target. 
Example 


The following example compares two strings for equality. 


// collator_compare.jsl 
import java.text.*; 


public class Program 


{ 
public static void main(String[] args) 
i 
// Get a default instance of a Collator object. 
Collator coll = Collator.getInstance(); 
// Compare two strings using a Collator object. 
String a = "StringA"; 
String b = "StringB"; 
int result = coll.compare(a, b); 
System.out.printin(a + "\n" + b+ "\n" + 
"Results of compare = " + result); 
} 
} 
/* 
Output: 
StringA 
StringB 
Results of compare = -1 
*/ 
See Also 
Reference 
Collator Class 
Concepts 


Collator Members 
java.text Package 
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Collator.equals Method 


Determines whether two Collator objects are equal. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public boolean equals( 
java.lang.Object obj); 


Parameters 


obj 

The Collator object to compare against the current Collator object for equality. 
Return Value 
true if the two Collator objects are equal; false otherwise. 


See Also 
Reference 
Collator Class 
Concepts 

Collator Members 
java.text Package 
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Collator.equals Method (J#) 


Determines whether two Collator objects are equal. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public boolean equals( 
java.lang.Object obj); 


Parameters 


obj 

The Collator object to compare against the current Collator object for equality. 
Return Value 
true if the two Collator objects are equal; false otherwise. 


See Also 
Reference 
Collator Class 
Concepts 

Collator Members 
java.text Package 
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Collator.getAvailableLocales Method 


Gets an array of all Locale objects that are supported by the Collator class. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static synchronized java.util.Locale[] getAvailableLocales(); 


Return Value 
An array of all the Locale objects that are available. 


See Also 
Reference 
Collator Class 
Concepts 

Collator Members 
java.text Package 
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Collator.getCollationKey Method 


Gets an instance of a CollationKey object for the given string. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public abstract java.text.CollationKey getCollationKey( 
java.lang.String source); 


Parameters 
source 

The string used as the source for the CollationKey object. 
Return Value 
An instance of a CollationKey object for the given string. 
Example 


The following example gets the CollationKey object for an instance of a Collator object. 


// collator_getcollationkey.jsl 
import java.text.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Get a default instance of a Collator object. 
Collator coll = Collator.getInstance(); 
// Get the CollationKey for this Collator object. 
CollationKey collKey = coll.getCollationKey("sortKey") ; 
System.out.printin("CollationKey.getSourceString = " + 
collKey.getSourceString()); 
} 
} 
/* 
Output: 
CollationKey.getSourceString = sortKey 
*/ 
See Also 
Reference 
Collator Class 
Concepts 


Collator Members 
java.text Package 
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Collator.getDecomposition Method 


Gets the decomposition type being used for collation. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public synchronized int getDecomposition(); 


Return Value 


The decomposition type being used for collation. One of NO_DECOMPOSITION, CANONICAL_DECOMPOSITION, or 
FULL_DECOMPOSITION. 


Example 

The following example gets the decomposition type being used for collation. 
// collator_getdecomposition.jsl 
import java.text.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
// Get a default instance of a Collator object. 
Collator coll = Collator.getInstance(); 
// Get the decomposition being used for collation. 
int decomp = coll.getDecomposition(); 
System.out.println("decomposition = " + 
decomp) ; 
} 
} 
/* 
Output: 
decomposition = 1 
af 
Remarks 


Decomposition defines how characters are to be pre-processed for comparison —- mainly how precomposed characters should 
be handled or decomposed within strings. 


See Also 
Reference 
Collator Class 
Concepts 

Collator Members 
java.text Package 


Visual J# Reference 


Collator.hashCode Method 


Serves as a hash function for a particular type, suitable for use in hashing algorithms and data structures like a hash table. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public abstract int hashCode(); 


Return Value 
A hash code for the current object. 


See Also 
Reference 
Collator Class 
Concepts 

Collator Members 
java.text Package 


Visual J# Reference 


Collator.getInstance Method 


Gets an instance of a Collator object. 


Overload List 


Collator.getInstance () Gets a default instance of a Collator object. 





Collator.getInstance (Locale) Gets an instance of a Collator object for the given Locale. 


See Also 
Reference 
Collator Class 
Concepts 

Collator Members 
java.text Package 
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Collator.getinstance Method () 


Gets a default instance of a Collator object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static synchronized java.text.Collator getInstance(); 


Return Value 

A default instance of a Collator object. 

Example 

The following example demonstrates how to get a default instance of a Collator object. 
// collator_getinstance.jsl 
import java.text.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Get a default instance of a Collator object. 
Collator coll = Collator.getInstance(); 
// Get the decomposition being used for collation. 
int decomp = coll.getDecomposition(); 
System.out.println("decomposition = " + 
decomp) ; 
} 
} 
/* 
Output: 
decomposition = 1 
A 
See Also 
Reference 
Collator Class 
Concepts 


Collator Members 
java.text Package 
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Collator.getInstance Method (Locale) 


Gets an instance of a Collator object for the given Locale. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static synchronized java.text.Collator getInstance( 
java.util.Locale loc); 


Parameters 
loc 
The Locale to use for collation. 
Return Value 
An instance of a Collator object for the given Locale. 
Example 


The following example demonstrates how to get a default instance of a Collator object using the Italy locale. 


// collator_getinstance 2.jsl 


import java.text.*; 
import java.util.Locale; 


public class Program 


4 
public static void main(String[] args) 
{ 
// Get a default instance of a Collator object 
// using the Italy locale. 
Locale loc = new Locale(Locale.ITALY); 
Collator coll = Collator.getInstance(loc); 
// Get the decomposition being used for collation. 
int decomp = coll.getDecomposition(); 
System.out.println("decomposition = " + 
decomp) ; 
} 
} 
/* 
Output: 
decomposition = 1 
mf 
See Also 
Reference 
Collator Class 
Concepts 


Collator Members 
java.text Package 
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Collator.getStrength Method 


Gets the strength type being used for collation. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 





public synchronized int getStrength(); 





Return Value 
The strength type being used for collation. One of PRIMARY, SECONDARY, TERTIARY, or IDENTICAL. 
Example 


The following example gets the strength being used for collation. 











// collator_getstrength.jsl 
import java.text.*; 
public class Program 
{ 
public static void main(String[] args) 
if 
// Get a default instance of a Collator object. 
Collator coll = Collator.getInstance(); 
// Get the strength being used for collation. 
int strength = coll.getStrength(); 
System.out.printin("strength = " + 
strength) ; 
} 
} 
/* 
Output: 
strength = 2 
*/ 
See Also 
Reference 
Collator Class 
Concepts 


Collator Members 
java.text Package 
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Collator.setDecomposition Method 


Sets the decomposition type being used for collation. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public synchronized void setDecomposition( 
int mode); 


Parameters 
mode 


The decomposition type being used for collation. One of NO_DECOMPOSITION, CANONICAL_DECOMPOSITION, or 
FULL_DECOMPOSITION. 


Example 

The following example sets the decomposition to FULL_LDECOMPOSITION. 
// collator_setdecomposition.jsl 
import java.text.*; 


public class Program 


+ 
public static void main(String[] args) 
{ 
// Get a default instance of a Collator object. 
Collator coll = Collator.getInstance(); 
// Set the decomposition to FULL_DECOMPOSITION. 
coll.setDecomposition(Collator.FULL_DECOMPOSITION) ; 
// Get the decomposition being used for collation. 
int decomp = coll.getDecomposition(); 
System.out.println("decomposition = " + 
decomp) ; 
} 
} 
/* 
Output: 
decomposition = 2 
* f 
Remarks 


Decomposition defines how characters are to be pre-processed for comparison —- mainly how precomposed characters should 
be handled or decomposed within strings. 


See Also 
Reference 
Collator Class 
Concepts 

Collator Members 
java.text Package 
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Collator.setStrength Method 


Sets the strength type being used for collation. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 





public synchronized void setStrength( 
int strength); 





Parameters 
strength 


The strength type being used for collation. One of PRIMARY, SECONDARY, TERTIARY, or IDENTICAL. 
Example 


The following example sets the strength to IDENTICAL. 


// collator_setstrength.jsl 
import java.text.*; 
public class Program 


public static void main(String[] args) 

{ 
// Get a default instance of a Collator object. 
Collator coll = Collator.getInstance(); 


// Set the strength to IDENTICAL. 
coll.setStrength(Collator. IDENTICAL) ; 


// Get the strength being used for collation. 
int strength = coll.getStrength(); 


System.out.printin("strength = " + 
strength) ; 


} 


f* 

Output: 
strength = 3 
a 





See Also 
Reference 
Collator Class 
Concepts 

Collator Members 
java.text Package 
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DateFormat Class 


Contains methods and properties used to format a Date object as a string and to parse a string into a Date object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 





public abstract class java.text.DateFormat 


extends java.text. Format 
implements java.lang.Cloneable 





Example 


The following example demonstrates some common uses of the DateFormat object, such as formatting, parsing, and applying 
patterns. 





// dateformat_overview. jsl 
import java.text.*; 
import java.util.Date; 


import java.util.Locale; 


public class Program 


{ 
public static void main(String[] args) 
1 
// Create a SimpleDateFormat object. 
DateFormat sdf = DateFormat.getDateInstance(DateFormat.LONG, Locale.US); 
// Print out the date using the supplied pattern. 
System.out.println("A sample date looks like: " + 
sdf.format(new Date("15-Aug-1947"))); 
} 
} 
/* 


Sample output: 
A sample date looks like: Friday, August 15, 1947 
sv 











Inheritance Hierarchy 
java.lang.Object 
java.text.Format 
java.text.DateFormat 
java.text.SimpleDateFormat 


See Also 

Concepts 

DateFormat Members 
java.text Package 
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DateFormat Members 


Contains methods and properties used to format a Date object as a string and to parse a string into a Date object. 


The following tables list the members exposed by the DateFormat type. 


Public Constructors 





Name Description 





DateFormat Initializes a new instance of a DateFormat object. 





Public Fields 
Name 


AM_PM_FIELD 


calendar 


DATE_FIELD 


Description 


The value for the style used to indicate that the AM or PM field should be displayed when p 


rinting a time. 


The underlying Calendar object being used for dates and times. 


The value for the style used to indicate that the date field should be displayed when printin 
g a date. 





DAY_OF_WEEK_FIELD 


DAY_OF_WEEK_IN_MONTH_FIELD 


The value for the style used to indicate that the day of the week field should be displayed w 


hen printing a date. 


The value for the style used to indicate that the day of the week in the month field should b 
e displayed when printing a date. 





DAY_OF_YEAR_FIELD 


The value for the style used to indicate that the day of the year field should be displayed wh 


en printing a date. 





DEFAULT The value for the style used to indicate that the default fields should be displayed when prin 
ting a date and time. 

ERA_FIELD The value for the style used to indicate that the era field should be displayed when printing 
a date. 

FULL The value for the style used to indicate that all fields should be displayed when printing ad 


ate. 





HOUR_OF_DAYO_FIELD 


HOUR_OF_DAY1_FIELD 


The value for the style used to indicate that the zero-based hour of day field should be displ 


ayed when printing a time. 


The value for the style used to indicate that the one-based hour of day field should be displ 
ayed when printing a time. 











HOURO_FIELD The value for the style used to indicate that the zero-based hour field should be displayed w 
hen printing a time. 

HOUR1_FIELD The value for the style used to indicate that the one-based hour field should be displayed w 
hen printing a time. 

LONG The value for the style used to indicate that the long length style date and time should be pr 


inted. 














MEDIUM 


MILLISECOND_FIELD 


The value for the style used to indicate that the medium length style date and time should b 
e printed. 


The value for the style used to indicate that the milliseconds field should be displayed when 
printing a time. 








MINUTE_FIELD The value for the style used to indicate that the minute field should be displayed when print 
ing atime. 

MONTH_FIELD The value for the style used to indicate that the month field should be displayed when printi 
ng a date. 

numberFormat The NumberFormat object used to format and parse a date and a time. 





SECOND_FIELD 


The value for the style used to indicate that the seconds field should be displayed when prin 
ting atime. 





SHORT 


TIMEZONE_FIELD 


The value for the style used to indicate that the short length style date and time should be p 
rinted. 


The value for the style used to indicate that the time zone field should be displayed when pr 
inting a time. 





WEEK_OF_MONTH_F 


WEEK_OF_YEAR_FIEL 


IELD The value for the style used to indicate that the week of the month field should be displayed 
when printing a date. 


D The value for the style used to indicate that the week of the year field should be displayed w 
hen printing a date. 





YEAR_FIELD 





Public Methods 


The value for the style used to indicate that the year field should be displayed when printin 
g a date. 








Name 


Description 





equals 


Overridden. Determines whether two DateFormat objects are equal. 





format 


Overloaded. Formats a Date object into a string. 





getAvailableLocales 


Returns an array of all the Locale objects that are available. 





getCalendar 


Gets the Calendar object that is being used. The calendar is used to determine the format of a date. 





getDatelnstance 


Overloaded. Creates a new instance of a DateFormat object used to represent a date (without a time). 





getDateTimelnstance 


hashCode 


Overloaded. Creates a new instance of a DateFormat object used to represent a date and a time. 


Overridden. Serves as a hash function for a particular type, suitable for use in hashing algorithms and da 
ta structures like a hash table. 





getlnstance 


getNumberFormat 





Creates a new instance of a DateFormat object used to represent a date and a time with the default locale 





Gets the NumberFormat object used to format and parse a date and a time. 











getTimelnstance 


getTimeZone 


Overloaded. Creates a new instance of a DateFormat object used to represent a time (without a date). 


Gets the TimeZone object associated with the Calendar object of this instance. 











setCalendar 


getClass (inherited from Object ) 

isLenient Determines whether parsing is set to lenient for this DateFormat object. Leniency is determined by the C 
alendar object associated with this instance. 

clone Creates a new instance of a DateFormat object that is a shallow copy of this instance. 

parse Overloaded. Parses a string into a Date object. 

parseObject Overloaded. Parses a string into an Object. 


Sets the Calendar object that is being used. The calendar is used to determine the format of a date. 





setLenient Sets a value that determines whether parsing is set to lenient for this DateFormat object. Leniency is dete 
rmined by the Calendar object associated with this instance. 
setNumberFormat |Sets the NumberFormat object used to format and parse a date and a time. 





setTimeZone 


Sets a TimeZone object to be associated with the Calendar object of this instance. 





toString 





Displays a human-readable representation of a Format object. (inherited from Format) 





Name 


finalize 





See Also 
Reference 
DateFormat Class 
Concepts 
java.text Package 


Protected Methods 


Description 


(inherited from Object ) 
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DateFormat Fields 


Public Fields 








Name Description 

AM_PM_FIELD The value for the style used to indicate that the AM or PM field should be displayed when p 
rinting a time. 

calendar The underlying Calendar object being used for dates and times. 

DATE_FIELD The value for the style used to indicate that the date field should be displayed when printin 


g a date. 





DAY_OF_WEEK_FIELD 


The value for the style used to indicate that the day of the week field should be displayed w 
hen printing a date. 





DAY_OF_WEEK_IN_MONTH_FIELD 


DAY_OF_YEAR_FIELD 


The value for the style used to indicate that the day of the week in the month field should b 
e displayed when printing a date. 


The value for the style used to indicate that the day of the year field should be displayed wh 
en printing a date. 








HOUR_OF_DAYO_FIELD 


DEFAULT The value for the style used to indicate that the default fields should be displayed when prin 
ting a date and time. 

ERA_FIELD The value for the style used to indicate that the era field should be displayed when printing 
a date. 

FULL The value for the style used to indicate that all fields should be displayed when printing ad 


ate. 


The value for the style used to indicate that the zero-based hour of day field should be displ 
ayed when printing a time. 





HOUR_OF_DAY1_FIELD 


The value for the style used to indicate that the one-based hour of day field should be displ 
ayed when printing a time. 





HOURO_FIELD The value for the style used to indicate that the zero-based hour field should be displayed w 
hen printing a time. 

HOUR1_FIELD The value for the style used to indicate that the one-based hour field should be displayed w 
hen printing a time. 

LONG The value for the style used to indicate that the long length style date and time should be pr 
inted. 

MEDIUM The value for the style used to indicate that the medium length style date and time should b 


e printed. 





MILLISECOND_FIELD 


MINUTE_FIELD 








The value for the style used to indicate that the milliseconds field should be displayed when 
printing a time. 


The value for the style used to indicate that the minute field should be displayed when print 
ing atime. 














MONTH_FIELD The value for the style used to indicate that the month field should be displayed when printi 
ng a date. 
numberFormat The NumberFormat object used to format and parse a date and a time. 





SECOND_FIELD 


SHORT 


The value for the style used to indicate that the seconds field should be displayed when prin 
ting atime. 


The value for the style used to indicate that the short length style date and time should be p 
rinted. 





TIMEZONE_FIELD 


WEEK_OF_MONTH_FIELD 


WEEK_OF_YEAR_FIELD 


The value for the style used to indicate that the time zone field should be displayed when pr 
inting a time. 


The value for the style used to indicate that the week of the month field should be displayed 
when printing a date. 


The value for the style used to indicate that the week of the year field should be displayed w 
hen printing a date. 





YEAR_FIELD 





See Also 
Reference 
DateFormat Class 
Concepts 
java.text Package 





The value for the style used to indicate that the year field should be displayed when printin 
g a date. 
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DateFormat.AM PM _FIELD Field 


The value for the style used to indicate that the AM or PM field should be displayed when printing a time. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final int AM _PM_FIELD; 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.calendar Field 


The underlying Calendar object being used for dates and times. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 





protected java.util.Calendar calendar; 





See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.DATE_FIELD Field 


The value for the style used to indicate that the date field should be displayed when printing a date. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final int DATE_FIELD; 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.DAY_OF_WEEK_FIELD Field 


The value for the style used to indicate that the day of the week field should be displayed when printing a date. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final int DAY_OF_WEEK_FIELD; 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.DAY_OF_WEEK_IN_MONTH_FIELD Field 


The value for the style used to indicate that the day of the week in the month field should be displayed when printing a date. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final int DAY_OF_WEEK_IN_MONTH_FIELD; 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.DAY_OF_YEAR_FIELD Field 


The value for the style used to indicate that the day of the year field should be displayed when printing a date. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final int DAY_OF_YEAR_FIELD; 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.DEFAULT Field 


The value for the style used to indicate that the default fields should be displayed when printing a date and time. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final int DEFAULT; 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.ERA_FIELD Field 


The value for the style used to indicate that the era field should be displayed when printing a date. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final int ERA_FIELD; 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.FULL Field 


The value for the style used to indicate that all fields should be displayed when printing a date. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 





public static final int FULL; 





See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.HOUR_OF DAYO FIELD Field 


The value for the style used to indicate that the zero-based hour of day field should be displayed when printing a time. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final int HOUR_OF_DAY@ FIELD; 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.HOUR_OF_DAY1_FIELD Field 


The value for the style used to indicate that the one-based hour of day field should be displayed when printing a time. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final int HOUR_OF_DAY1_FIELD; 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.HOURO FIELD Field 


The value for the style used to indicate that the zero-based hour field should be displayed when printing a time. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final int HOUR@ FIELD; 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 


Visual J# Reference 


DateFormat.HOUR1 FIELD Field 


The value for the style used to indicate that the one-based hour field should be displayed when printing a time. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final int HOUR1_FIELD; 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.LONG Field 


The value for the style used to indicate that the long length style date and time should be printed. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final int LONG; 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 


Visual J# Reference 


DateFormat.MEDIUM Field 


The value for the style used to indicate that the medium length style date and time should be printed. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final int MEDIUM; 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.MILLISECOND_FIELD Field 


The value for the style used to indicate that the milliseconds field should be displayed when printing a time. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final int MILLISECOND_FIELD; 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 


Visual J# Reference 


DateFormat.MINUTE_FIELD Field 


The value for the style used to indicate that the minute field should be displayed when printing a time. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final int MINUTE_FIELD; 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.MONTH FIELD Field 


The value for the style used to indicate that the month field should be displayed when printing a date. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final int MONTH_FIELD; 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.numberFormat Field 


The NumberFormat object used to format and parse a date and a time. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


protected java.text.NumberFormat numberFormat; 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.SECOND FIELD Field 


The value for the style used to indicate that the seconds field should be displayed when printing a time. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final int SECOND FIELD; 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 


Visual J# Reference 


DateFormat.SHORT Field 


The value for the style used to indicate that the short length style date and time should be printed. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final int SHORT; 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 


Visual J# Reference 


DateFormat.TIMEZONE_FIELD Field 


The value for the style used to indicate that the time zone field should be displayed when printing a time. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final int TIMEZONE_FIELD; 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.WEEK_OF_MONTH_FIELD Field 


The value for the style used to indicate that the week of the month field should be displayed when printing a date. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final int WEEK_OF_MONTH_FIELD; 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.WEEK_OF_YEAR_FIELD Field 


The value for the style used to indicate that the week of the year field should be displayed when printing a date. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final int WEEK_OF_YEAR_FIELD; 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.YEAR FIELD Field 


The value for the style used to indicate that the year field should be displayed when printing a date. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final int YEAR_FIELD; 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat Constructor 


Initializes a new instance of a DateFormat object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 





protected java.text.DateFormat(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat Methods 


Public Methods 





Name 


Description 





equals 


Overridden. Determines whether two DateFormat objects are equal. 





format 


Overloaded. Formats a Date object into a string. 





getAvailableLocales 


Returns an array of all the Locale objects that are available. 





getCalendar 


Gets the Calendar object that is being used. The calendar is used to determine the format of a date. 





getDatelnstance 


getDateTimelnstance 


hashCode 


Overloaded. Creates a new instance of a DateFormat object used to represent a date (without a time). 


Overloaded. Creates a new instance of a DateFormat object used to represent a date and a time. 


Overridden. Serves as a hash function for a particular type, suitable for use in hashing algorithms and da 
ta structures like a hash table. 





getinstance 


getNumberFormat 


getTimelnstance 


getTimeZone 


Creates a new instance of a DateFormat object used to represent a date and a time with the default locale 


Gets the NumberFormat object used to format and parse a date and a time. 
Overloaded. Creates a new instance of a DateFormat object used to represent a time (without a date). 


Gets the TimeZone object associated with the Calendar object of this instance. 











getClass (inherited from Object ) 

isLenient Determines whether parsing is set to lenient for this DateFormat object. Leniency is determined by the C 
alendar object associated with this instance. 

clone Creates a new instance of a DateFormat object that is a shallow copy of this instance. 

parse Overloaded. Parses a string into a Date object. 

parseObject Overloaded. Parses a string into an Object. 





setCalendar 


Sets the Calendar object that is being used. The calendar is used to determine the format of a date. 








setLenient Sets a value that determines whether parsing is set to lenient for this DateFormat object. Leniency is dete 
rmined by the Calendar object associated with this instance. 
setNumberFormat |Sets the NumberFormat object used to format and parse a date and a time. 





setTimeZone 


Sets a TimeZone object to be associated with the Calendar object of this instance. 





toString 





Displays a human-readable representation of a Format object. (inherited from Format ) 








Protected Methods 


Name Description 








finalize (inherited from Object ) 





See Also 
Reference 
DateFormat Class 
Concepts 
java.text Package 
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DateFormat.clone Method 


Creates a new instance of a DateFormat object that is a shallow copy of this instance. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object clone(); 


Return Value 
A new instance of a DateFormat object that is a shallow copy of this instance. 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.equals Method 


Determines whether two DateFormat objects are equal. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public boolean equals( 
java.lang.Object obj); 


Parameters 


obj 

A DateFormat object to compare with the current DateFormat object for equality. 
Return Value 
true if the two DateFormat objects are equal; false otherwise. 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.format Method 


Formats a Date object into a string. 


Overload List 


Name Description 
DateFormat.format (Date) Formats a Date object into a string. 
DateFormat.format (Object) Formats an object into a string. 


DateFormat.ormat (Date, StringBuffer, FieldPosition) |Formats a Date object and appends it to a StringBuffer object. 


DateFormat.format (Object, StringBuffer, FieldPosition)|Formats an object representing a Date and appends it to a StringBuffer 
object. 








See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.format Method (Date) 


Formats a Date object into a string. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public final java.lang.String format( 
java.util.Date date); 


Parameters 
date 

The Date object to be formatted into a string. 
Return Value 
A String object containing the formatted Date object. 
Example 


The following example shows how to format a Date object. 


// dateformat_format.jsl 


import java.text.*; 
import java.util.Date; 


public class Program 


4 
public static void main(String[] args) 
{ 
// Apply a pattern to a SimpleDateFormat object. 
String pattern = 
""This moment: 'dd MMM yyyy ‘@'hh ‘hours and ‘mm ‘'minutes.'"; 
SimpleDateFormat sdf = new SimpleDateFormat (pattern) ; 
// Print out the time now using the format method. 
System.out.println(sdf.format(new Date())); 
} 
} 
/* 


Sample Output: 
This moment: 11 Nov 2004 @@1 hours and 14 minutes. 
*/ 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 


Visual J# Reference 


DateFormat.format Method (Date, StringBuffer, FieldPosition) 


Formats a Date object and appends it to a StringBuffer object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.StringBuffer format( 
java.util.Date date, 
java.lang.StringBuffer appendBuf, 
java.text.FieldPosition pos); 


Parameters 
date 


The Date object to be formatted into a string. 
appendBuf 
A StringBuffer object to be appended with the Date object formatted into a string. 
pos 
Used to find start and end indices of a particular field of the date in the formatted string. 
Return Value 
A StringBuffer object appended with the formatted Date object. 
Example 


The following example shows how to format a Date object and how to determine the indices of the year field. 


// dateformat_formati.jsl 


import java.text.*; 
import java.util.Date; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Apply a pattern to a SimpleDateFormat object. 
String pattern = 
""This moment: 'dd MMM yyyy ‘@'hh ‘hours and ‘mm ‘minutes.'"; 
SimpleDateFormat sdf = new SimpleDateFormat (pattern) ; 


// Print out the time now using the format method. 
StringBuffer buf = new StringBuffer(); 

FieldPosition pos = new FieldPosition(DateFormat.YEAR_FIELD) ; 
sdf.format(new Date(), buf, pos); 

System.out.println(buf) ; 

System.out.printlin("The year field occupies indices: " + 


pos.getBeginIndex() + - " + pos.getEndIndex()); 


} 


/* 

Sample Output: 

This moment: 11 Nov 2004 @10 hours and 29 minutes. 
The year field occupies indices: 20 - 24 


ey 


See Also 
Reference 


DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.format Method (Object, StringBuffer, 
FieldPosition) 


Formats an object representing a Date and appends it to a StringBuffer object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public final java.lang.StringBuffer format( 
java.lang.Object obj, 
java.lang.StringBuffer appendBuf, 
java.text.FieldPosition pos); 


Parameters 
obj 
The object representing a date to be formatted into a string. 
appendBuf 
A StringBuffer object to be appended with the object formatted into a string. 
pos 
Used to find start and end indices of a particular field of the date in the formatted string. 
Return Value 
A StringBuffer object appended with the formatted object representing a date. 
Example 


The following example shows how to format a Date object and how to determine the indices of the year field. 


// dateformat_format2.jsl 


import java.text.*; 
import java.util.Date; 


public class Program 


public static void main(String[] args) 


{ 
// Apply a pattern to a SimpleDateFormat object. 
String pattern = 
""This moment: 'dd MMM yyyy ‘@'hh ‘hours and ‘mm ‘'minutes.'"; 
SimpleDateFormat sdf = new SimpleDateFormat (pattern) ; 
// Print out the time now using the format method. 
StringBuffer buf = new StringBuffer(); 
FieldPosition pos = new FieldPosition(DateFormat.YEAR_FIELD) ; 
sdf.format(new Date(), buf, pos); 
System.out.println(buf) ; 
System.out.println("The year field occupies indices: " + 
pos.getBeginIndex() + " - " + pos.getEndIndex()); 
} 
} 
/* 


Sample Output: 
This moment: 11 Nov 2004 @10 hours and 29 minutes. 
The year field occupies indices: 20 - 24 


my 


See Also 
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DateFormat.getAvailableLocales Method 


Returns an array of all the Locale objects that are available. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static java.util.Locale[] getAvailableLocales(); 


Return Value 
An array of all the Locale objects that are available. 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.getCalendar Method 


Gets the Calendar object that is being used. The calendar is used to determine the format of a date. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.util.Calendar getCalendar(); 


Return Value 
The Calendar object that is being used. 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 


Visual J# Reference 


DateFormat.getDatelnstance Method 


Creates a new instance of a DateFormat object used to represent a date (without a time). 


Overload List 
Name 


DateFormat.getDatelnstance () 


Description 


Creates a new instance of a DateFormat object used to represent a date (without a ti 
me) with the default style and locale. 





DateFormat.getDatelnstance (int) 


DateFormat.getDatelnstance (int, Locale) 





See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 


Creates a new instance of a DateFormat object used to represent a date (without a ti 
me) with the given style and the default locale. 


Creates a new instance of a DateFormat object used to represent a date (without a ti 
me) with the given style and locale. 
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DateFormat.getDatelnstance Method () 


Creates a new instance of a DateFormat object used to represent a date (without a time) with the default style and locale. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final java.text.DateFormat getDateInstance(); 


Return Value 
A new instance of a DateFormat object used to represent a date (without a time) with the default style and the default locale. 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.getDatelnstance Method (Int32) 


Creates a new instance of a DateFormat object used to represent a date (without a time) with the given style and the default 
locale. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final java.text.DateFormat getDateInstance( 
int style); 


Parameters 
style 


The style used when formatting the date. This can be one of the four style constants defined by DateFormat class -- SHORT, 
MEDIUM, LONG, and FULL. 


Return Value 
A new instance of a DateFormat object used to represent a date (without a time) with the given style and the default locale. 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.getDatelnstance Method (Int32, Locale) 


Creates a new instance of a DateFormat object used to represent a date (without a time) with the given style and locale. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final java.text.DateFormat getDateInstance( 
int style, 
java.util.Locale loc); 


Parameters 
style 


The style used when formatting the date. This can be one of the four style constants defined by DateFormat class -- SHORT, 
MEDIUM, LONG, and FULL. 


loc 
A Locale object representing the locale used when formatting the date. 
Return Value 
A new instance of a DateFormat object used to represent a date (without a time) with the given style and locale. 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.getDateTimelnstance Method 


Creates a new instance of a DateFormat object used to represent a date and a time. 


Overload List 
Name Description 


DateFormat.getDateTimelnstance () Creates a new instance of a DateFormat object used to represent a date and 
a time with the default style and locale. 





DateFormat.getDateTimelnstance (int, int) Creates a new instance of a DateFormat object used to represent a date and 
a time with the given styles and the default locale. 


DateFormat.getDateTimelnstance (int, int, Locale)|Creates a new instance of a DateFormat object used to represent a date and 
a time with the given styles and locale. 





See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.getDateTimelnstance Method () 


Creates a new instance of a DateFormat object used to represent a date and a time with the default style and locale. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final java.text.DateFormat getDateTimeInstance(); 


Return Value 
A new instance of a DateFormat object used to represent a date and a time with the default style and locale. 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.getDateTimelnstance Method (Int32, Int32) 


Creates a new instance of a DateFormat object used to represent a date and a time with the given styles and the default locale. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final java.text.DateFormat getDateTimeInstance( 
int dateStyle, 
int timeStyle); 


Parameters 


dateStyle 


The style used when formatting the date. This can be one of the four style constants defined by DateFormat class -- SHORT, 
MEDIUM, LONG, and FULL. 


timeStyle 


The style used when formatting the time. This can be one of the four style constants defined by DateFormat class -- SHORT, 
MEDIUM, LONG, and FULL. 


Return Value 
A new instance of a DateFormat object used to represent a date and a time with the given styles and the default locale. 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.getDateTimelnstance Method (Int32, Int32, Locale) 


Creates a new instance of a DateFormat object used to represent a date and a time with the given styles and locale. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final java.text.DateFormat getDateTimeInstance( 
int dateStyle, 
int timeStyle, 
java.util.Locale loc); 


Parameters 


dateStyle 


The style used when formatting the date. This can be one of the four style constants defined by DateFormat class -- SHORT, 
MEDIUM, LONG, and FULL. 


timeStyle 


The style used when formatting the time. This can be one of the four style constants defined by DateFormat class -- SHORT, 
MEDIUM, LONG, and FULL. 


loc 
A Locale object representing the locale used when formatting the date and time. 
Return Value 
A new instance of a DateFormat object used to represent a date and a time with the given styles and locale. 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.hashCode Method 


Serves as a hash function for a particular type, suitable for use in hashing algorithms and data structures like a hash table. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public int hashCode(); 


Return Value 
A hash code for the current object. 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.getInstance Method 


Creates a new instance of a DateFormat object used to represent a date and a time with the default locale. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final java.text.DateFormat getInstance(); 


Return Value 
A new instance of a DateFormat object used to represent a date and a time with the default locale. 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.getNumberFormat Method 


Gets the NumberFormat object used by this formatter to format and/or parse various components of dates and times. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.text.NumberFormat getNumberFormat(); 


Return Value 
The NumberFormat object used to format and parse a date and a time. 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.getTimelnstance Method 


Creates a new instance of a DateFormat object used to represent a time (without a date). 


Overload List 
Name Description 


DateFormat.getTimelnstance () Creates a new instance of a DateFormat object used to represent a time (without a da 
te) with the default style and locale. 





DateFormat.getTimelnstance (int) Creates a new instance of a DateFormat object used to represent a time (without a da 
te) with the given style and the default locale. 


DateFormat.getTimelnstance (int, Locale)|Creates a new instance of a DateFormat object used to represent a time (without a da 
te) with the given style and locale. 








See Also 

Reference 
DateFormat Class 
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DateFormat Members 
java.text Package 
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DateFormat.getTimelnstance Method () 


Creates a new instance of a DateFormat object used to represent a time (without a date) with the default style and locale. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final java.text.DateFormat getTimeInstance(); 


Return Value 
A new instance of a DateFormat object used to represent a time (without a date) with the default style and locale. 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.getTimelnstance Method (Int32) 


Creates a new instance of a DateFormat object used to represent a time (without a date) with the given style and the default 
locale. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final java.text.DateFormat getTimeInstance( 
int style); 


Parameters 
style 


The style used when formatting the time. This can be one of the four style constants defined by DateFormat class -- SHORT, 
MEDIUM, LONG, and FULL. 


Return Value 
A new instance of a DateFormat object used to represent a time (without a date) with the given style and the default locale. 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.getTimelnstance Method (Int32, Locale) 


Creates a new instance of a DateFormat object used to represent a time (without a date) with the given style and locale. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final java.text.DateFormat getTimeInstance( 
int style, 
java.util.Locale loc); 


Parameters 
style 


The style used when formatting the time. This can be one of the four style constants defined by DateFormat class -- SHORT, 
MEDIUM, LONG, and FULL. 


loc 
A Locale object representing the locale used when formatting the time. 
Return Value 
A new instance of a DateFormat object used to represent a time (without a date) with the given style and locale. 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.getTimeZone Method 


Gets the TimeZone object associated with the Calendar object of this instance. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.util.TimeZone getTimeZone(); 


Return Value 
The TimeZone object associated with the Calendar object of this instance. 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.isLenient Method 


Determines whether parsing is set to lenient for this DateFormat object. Leniency is determined by the Calendar object 
associated with this instance. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public boolean isLenient(); 
| 


Return Value 
true if parsing is set to lenient for this DateFormat object; false otherwise. 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.parse Method 


Parses a string into a Date object. 


Overload List 


DateFormat.parse (String) Parses a string into a Date object. 





DateFormat.parse (String, ParsePosition) Parses a string into a Date object. 


See Also 

Reference 
DateFormat Class 
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DateFormat Members 
java.text Package 
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DateFormat.parse Method (String) 


Parses a string into a Date object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.util.Date parse( 
java.lang.String sourceStr) throws java.text.ParseException; 


Parameters 
sourceStr 


The string to be parsed into a Date object. 
Return Value 
A Date object containing the date represented by the string. 
Example 


The following example shows how to parse a string into a formatted date. 


// dateformat_parse.jsl 


import java.text.*; 
import java.util.Date; 


public class Program 


{ 


public static void main(String[] args) 


{ 
// Create a SimpleDateFormat object. 


String pattern = "dd-MMM-yyyy HH:mm:ss.SSS"; 
SimpleDateFormat sdf = new SimpleDateFormat (pattern) ; 


// Parse a sample date starting at position @. 
String sampleDateStr = "@4-Jul-1776 22:00:00.000"; 
Date sampleDate = null; 

try 


{ 
sampleDate = sdf.parse(sampleDateStr) ; 


catch (ParseException ex) 


i 
} 


// Print out the date using the supplied pattern. 
System.out.println(sdf.format(sampleDate) ) ; 


System.out.println(ex.toString()); 


} 


/* 

Sample Output: 
Q@4-Jul-1776 22:00:00.e00 
*/ 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 


java.text Package 
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DateFormat.parse Method (String, ParsePosition) 


Parses a string into a Date object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public abstract java.util.Date parse( 
java.lang.String sourceStr, 
java.text.ParsePosition pos); 


Parameters 
sourceStr 


The string to be parsed into a Date object. 
pos 

Used to indicate the first position in the string to be parsed. 
Return Value 
A Date object containing the date represented by the string. 
Example 


The following example shows how to parse a string into a formatted date. 


// dateformat_parse1.jsl 


import java.text.*; 
import java.util.Date; 


public class Program 


{ 


public static void main(String[] args) 


if 
// Create a SimpleDateFormat object. 


String pattern = "dd-MMM-yyyy HH:mm:ss.SSS"; 
SimpleDateFormat sdf = new SimpleDateFormat (pattern) ; 


// Parse a sample date starting at position @. 
String sampleDateStr = "@4-Jul-1776 22:00:00.000"; 
ParsePosition pos = new ParsePosition(@); 

Date sampleDate = sdf.parse(sampleDateStr, pos); 


// Print out the date using the supplied pattern. 
System.out.println(sdf.format(sampleDate) ) ; 


} 


/* 

Sample Output: 
04-Jul-1776 22:00:00.e00 
A 


See Also 

Reference 
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DateFormat Members 
java.text Package 
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DateFormat.parseObject Method 


Parses a string into an Object. 


Overload List 


DateFormat.parseObject (String) Parses a string into an Object. 





DateFormat.parseObject (String, ParsePosition) Parses a string into an Object. 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.parseObject Method (String, ParsePosition) 


Parses a string into an Object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object parseObject( 
java.lang.String sourceStr, 
java.text.ParsePosition pos); 


Parameters 
sourceStr 


The string to be parsed into an Object. 
pos 

Used to indicate the first position in the string to be parsed. 
Return Value 
An Object containing the date represented by the string. 
Example 


The following example shows how to parse a string into a formatted date. 


// dateformat_parseobject.jsl 


import java.text.*; 
import java.util.Date; 


public class Program 


{ 


public static void main(String[] args) 


if 
// Create a SimpleDateFormat object. 


String pattern = "dd-MMM-yyyy HH:mm:ss.SSS"; 
SimpleDateFormat sdf = new SimpleDateFormat (pattern) ; 


// Parse a sample date starting at position @. 

String sampleDateStr = "@4-Jul-1776 22:00:00.000"; 
ParsePosition pos = new ParsePosition(@); 

Date sampleDate = (Date)sdf.parseObject(sampleDateStr, pos); 


// Print out the date using the supplied pattern. 
System.out.printiln(sdf.format(sampleDate) ) ; 


} 


/* 

Sample Output: 
04-Jul-1776 22:00:00.e00 
A 


See Also 
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Concepts 
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java.text Package 
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DateFormat.setCalendar Method 


Sets the Calendar object that is being used. The calendar is used to determine the format of a date. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setCalendar ( 
java.util.Calendar newCalendar) ; 


Parameters 
newCalendar 


The Calendar object that is being used. 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.setLenient Method 


Sets a value that determines whether parsing is set to lenient for this DateFormat object. Leniency is determined by the 
Calendar object associated with this instance. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setLenient( 
boolean lenient); 


Parameters 
lenient 


A value that determines whether parsing is set to lenient for this DateFormat object. 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.setNumberFormat Method 


Sets the NumberFormat object used to format and parse a date and a time. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setNumberFormat ( 
java.text.NumberFormat numFormat) ; 


Parameters 
numFormat 


The NumberFormat object used to format and parse a date and a time. 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormat.setTimeZone Method 


Sets a TimeZone object to be associated with the Calendar object of this instance. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setTimeZone( 
java.util.TimeZone zone); 


Parameters 
zone 


A TimeZone object to be associated with the Calendar object of this instance. 


See Also 

Reference 
DateFormat Class 
Concepts 

DateFormat Members 
java.text Package 
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DateFormatSymbols Class 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public class java.text.DateFormatSymbols 
extends java.lang.Object 
implements java.io.Serializable, java.lang.Cloneable 


Inheritance Hierarchy 
java.lang.Object 
java.text.DateFormatSymbols 


See Also 

Concepts 

DateFormatSymbols Members 
java.text Package 
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DateFormatSymbols Members 


The following tables list the members exposed by the DateFormatSymbols type. 


Public Constructors 
Name 


DateFormatSymbols 


Public Methods 


Description 








Name 


Description 








getLocalPatternChars 


getMonths 


getShortMonths 


getShortWeekdays 


getClass 


getWeekdays 


getZoneStrings 


MemberwiseClone 


setAmPmStrings 


setEras 


setLocalPatternChars 


setMonths 


setShortMonths 


equals Overridden. 
getAmPmStrings 

getEras 

hashCode Overridden. 


(inherited from Object ) 


Performs a shallow copy of the members. 





setShortWeekdays 





setWeekdays 





setZoneStrings 





toString 





Overridden. 








Protected Methods 





See Also 

Reference 
DateFormatSymbols Class 
Concepts 

java.text Package 
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DateFormatSymbols Constructor 


Overload List 





Name Description 





DateFormatSymbols () 





DateFormatSymbols (Locale) 











See Also 

Reference 
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DateFormatSymbols Constructor () 


Initializes a new instance of the DateFormatSymbols Class . 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.text.DateFormatSymbols(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
DateFormatSymbols Class 
Concepts 

DateFormatSymbols Members 
java.text Package 
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DateFormatSymbols Constructor (Locale) 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.text.DateFormatSymbols( 
java.util.Locale loc); 


Parameters 
loc 


See Also 

Reference 
DateFormatSymbols Class 
Concepts 

DateFormatSymbols Members 
java.text Package 
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DateFormatSymbols Methods 


Public Methods 





Name 


Description 














equals Overridden. 
getAmPmStrings 

getEras 

hashCode Overridden. 





getLocalPatternChars 


getMonths 


getShortMonths 


getShortWeekdays 


getClass 


getWeekdays 


getZoneStrings 


MemberwiseClone 


setAmPmStrings 


setEras 


setLocalPatternChars 


setMonths 


setShortMonths 


setShortWeekdays 


setWeekdays 


setZoneStrings 


(inherited from Object ) 


Performs a shallow copy of the members. 





toString 


Overridden. 





Name 


finalize 





See Also 


Protected Methods 





Description 


(inherited from Object ) 





Reference 
DateFormatSymbols Class 
Concepts 

java.text Package 
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DateFormatSymbols.clone Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


See Also 

Reference 
DateFormatSymbols Class 
Concepts 

DateFormatSymbols Members 
java.text Package 
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DateFormatSymbols.equals Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public boolean equals( 
java.lang.Object obj); 


Parameters 


obj 


See Also 

Reference 
DateFormatSymbols Class 
Concepts 

DateFormatSymbols Members 
java.text Package 
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DateFormatSymbols.getAmPmStrings Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String[] getAmPmStrings(); 


See Also 

Reference 
DateFormatSymbols Class 
Concepts 

DateFormatSymbols Members 
java.text Package 
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DateFormatSymbols.getEras Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String[] getEras(); 


See Also 

Reference 
DateFormatSymbols Class 
Concepts 

DateFormatSymbols Members 
java.text Package 
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DateFormatSymbols.hashCode Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public int hashCode(); 


See Also 

Reference 
DateFormatSymbols Class 
Concepts 

DateFormatSymbols Members 
java.text Package 


Visual J# Reference 


DateFormatSymbols.getLocalPatternChars Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getLocalPatternChars(); 


See Also 

Reference 
DateFormatSymbols Class 
Concepts 

DateFormatSymbols Members 
java.text Package 
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DateFormatSymbols.getMonths Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String[] getMonths(); 


See Also 

Reference 
DateFormatSymbols Class 
Concepts 

DateFormatSymbols Members 
java.text Package 
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DateFormatSymbols.getShortMonths Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String[] getShortMonths(); 


See Also 

Reference 
DateFormatSymbols Class 
Concepts 

DateFormatSymbols Members 
java.text Package 
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DateFormatSymbols.getShortWeekdays Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String[] getShortWeekdays(); 


See Also 

Reference 
DateFormatSymbols Class 
Concepts 

DateFormatSymbols Members 
java.text Package 
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DateFormatSymbols.getWeekdays Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String[] getweekdays(); 


See Also 

Reference 
DateFormatSymbols Class 
Concepts 

DateFormatSymbols Members 
java.text Package 
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DateFormatSymbols.getZoneStrings Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public [Ljava.lang.String;[] getZoneStrings(); 


See Also 

Reference 
DateFormatSymbols Class 
Concepts 

DateFormatSymbols Members 
java.text Package 
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DateFormatSymbols.setAmPmStrings Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setAmPmStrings( 
java.lang.String[] newAmPms) ; 


Parameters 
newAmPms 


See Also 

Reference 
DateFormatSymbols Class 
Concepts 

DateFormatSymbols Members 
java.text Package 
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DateFormatSymbols.setEras Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setEras( 
java.lang.String[] newEras); 


Parameters 
newEras 


See Also 

Reference 
DateFormatSymbols Class 
Concepts 

DateFormatSymbols Members 
java.text Package 
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DateFormatSymbols.setLocalPatternChars Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setLocalPatternChars( 
java.lang.String newLocalPatternChars) ; 


Parameters 
newLocalPatternChars 


See Also 

Reference 
DateFormatSymbols Class 
Concepts 

DateFormatSymbols Members 
java.text Package 
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DateFormatSymbols.setMonths Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setMonths( 
java. lang.String[] newMonths) ; 


Parameters 
newMonths 


See Also 

Reference 
DateFormatSymbols Class 
Concepts 

DateFormatSymbols Members 
java.text Package 
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DateFormatSymbols.setShortMonths Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setShortMonths( 
java.lang.String[] newShortMonths) ; 


Parameters 
newShortMonths 


See Also 

Reference 
DateFormatSymbols Class 
Concepts 

DateFormatSymbols Members 
java.text Package 
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DateFormatSymbols.setShortWeekdays Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setShortWeekdays( 
java.lang.String[] newShortwWeekdays ) ; 


Parameters 
newShortWeekdays 


See Also 

Reference 
DateFormatSymbols Class 
Concepts 

DateFormatSymbols Members 
java.text Package 
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DateFormatSymbols.setWeekdays Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setWeekdays( 
java.lang.String[] newWeekdays) ; 


Parameters 
newWeekdays 


See Also 

Reference 
DateFormatSymbols Class 
Concepts 

DateFormatSymbols Members 
java.text Package 
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DateFormatSymbols.setZoneStrings Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setZoneStrings( 
[Ljava.lang.String;[] newZoneStrings) ; 


Parameters 
newZoneStrings 


See Also 

Reference 
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DecimalFormat Class 


Contains methods and properties used to format a number as a string and to parse a string into a number. This class provides 
a default implementation of the abstract class NumberFormat. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public class java.text.DecimalFormat 
extends java.text.NumberFormat 


Example 


The following example demonstrates the applyPattern,format, and parse methods of the DecimalFormat class. 


// decimalformat_overview.jsl 
import java.text.*; 


public class Program 


{ 


public static void main(String[] args) 

{ 
// Create a DecimalFormat object and set it's pattern. 
DecimalFormat decForm = new DecimalFormat(); 
decForm.applyPattern("#.Q0###" ) ; 


// Format some decimals using the pattern supplied above. 
StringBuffer dest1 = new StringBuffer(24) ; 
StringBuffer dest2 = new StringBuffer(24) ; 
FieldPosition posi = 

new FieldPosition(NumberFormat.FRACTION_FIELD) ; 
FieldPosition pos2 = 

new FieldPosition(NumberFormat.INTEGER_FIELD); 


dest1 = decForm.format(22.3423D, dest1, posi); 
System.out.println("dest1 = " + dest1); 
System.out.println("FRACTION is at: " + pos1.getBeginIndex() + 


; + pos1.getEndIndex()); 


dest2 = decForm.format(640@@D, dest2, pos2); 
System.out.println("dest2 = " + dest2); 
System.out.println("INTEGER portion is at: " + 


pos2.getBeginIndex() + ", " + pos2.getEndIndex()); 


// Parse the decimal starting at position 8. 
ParsePosition pos3 = new ParsePosition(8); 
Number n = decForm.parse("123456789.14", pos3); 


System.out.println("Number = " + n); 


} 


/* 

Output: 

dest1 = 22.3423 

FRACTION is at: 3, 7 

dest2 = 64000.00 

INTEGER portion is at: @, 5 
Number = 9.14 

*/ 


Inheritance Hierarchy 


java.lang.Object 
java.text.Format 
java.text.NumberFormat 
java.text.DecimalFormat 


See Also 
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DecimalFormat Members 
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DecimalFormat Members 


Contains methods and properties used to format a number as a string and to parse a string into a number. This class provides 
a default implementation of the abstract class NumberFormat. 


The following tables list the members exposed by the DecimalFormat type. 


Public Constructors 


DecimalFormat 





Public Methods 


Overloaded. Initializes a new instance of a DecimalFormat object. 





Name 


Description 





applyLocalizedPattern 


Changes the pattern that an instance of a DecimalFormat object is using after it is created. 
Localization of the pattern is currently not supported by the J# Class Libraries. 











applyPattern Changes the pattern that an instance of a DecimalFormat object is using after it is created. 
equals Overridden. Determines whether two DecimalFormat objects are equal. 
format Overloaded. Formats a decimal into a string. 





getDecimalFormatSymbols 


getGroupingSize 


hashCode 


Gets the number of characters that are grouped together between grouping separators. 


Gets the DecimalFormatSymbols object that contains the symbols used when formatting a 
decimal. 


Overridden. Serves as a hash function for a particular type, suitable for use in hashing algo 
rithms and data structures like a hash table. 





getMaximumFractionDigits 


getMaximumInteger Digits 


Gets a value representing the maximum number of digits displayed in the fractional part of 
the number. (inherited from NumberFormat) 


Gets a value representing the maximum number of digits displayed in the integer part of t 
he number. (inherited from NumberFormat) 





getMinimumFractionDigits 


getMinimumIntegerDigits 


Gets a value representing the minimum number of digits displayed in the fractional part of 
the number. (inherited from NumberFormat) 


Gets a value representing the minimum number of digits displayed in the integer part of th 
e number. (inherited from NumberFormat) 








getPositivePrefix 


getPositiveSuffix 





getClass 


getMultiplier Gets the multiplier used for calculating percents or permills. 
getNegativePrefix Gets the symbol that is prefixed to a negative number. 
getNegativeSuffix 


Gets the symbol that is appended to a negative number. 
Gets the symbol that is prefixed to a positive number. 


Gets the symbol that is appended to a positive number. 


(inherited from Object ) 











isDecimalSeparatorAlwaysShown 


isGroupingUsed 


isParselntegerOnly 


Determines whether the decimal separator is shown with integers. 


Determines whether digits are being grouped together. (inherited from NumberFormat) 


Determines whether only the integer portion of the number is being parsed or if the fractio 
nal part is also included. (inherited from NumberFormat) 











clone Creates a shallow copy of the current DecimalFormat object. 
) 
parse Overloaded. Parses a string into a decimal. 
parseObject Overloaded. Parses a string into an Object. (inherited from NumberFormat) 





setDecimalFormatSymbols 


Sets a DecimalFormatSymbols object that contains the symbols used when formatting a de 
cimal. 





setDecimalSeparatorAlwaysShown 


Sets a value indicating whether the decimal separator is shown with integers. 





setGroupingSize 


Sets the number of characters that are grouped together between grouping separators. 





setGroupingUsed 


setMaximumFractionDigits 


Sets a value determining whether digits are being grouped together. (inherited from 
NumberFormat) 


Sets the value representing the maximum number of digits displayed in the fractional part 
of the number. (inherited from NumberFormat) 








setMaximum|ntegerDigits 


setMinimumFractionDigits 


Sets the value representing the maximum number of digits displayed in the integer part of 
the number. (inherited from NumberFormat) 


Sets the value representing the minimum number of digits displayed in the fractional part 
of the number. (inherited from NumberFormat) 





setMinimumIntegerDigits 


setMultiplier 


setNegativePrefix 


setNegativeSuffix 


setParselntegerOnly 


Sets the value representing the minimum number of digits displayed in the integer part of 
the number. (inherited from NumberFormat) 


Sets the multiplier used for calculating percents or permills. 
Sets the symbol that is prefixed to a negative number. 
Sets the symbol that is appended to a negative number. 


Sets a value determining whether only the integer portion of the number is being parsed o 
r if the fractional part is also included. (inherited from NumberFormat) 





setPositivePrefix 


setPositiveSuffix 


toLocalizedPattern 


Sets the symbol that is prefixed to a positive number. 
Sets the symbol that is appended to a positive number. 


Applies the previously set pattern to the string for an instance of a DecimalFormat object. L 
ocalization of the pattern is currently not supported by the J# Class Libraries. 





toPattern 


Applies the previously set pattern to the string for an instance of a DecimalFormat object. 





toString 


Displays a human-readable representation of a Format object. (inherited from Format) 











Protected Methods 





See Also 
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DecimalFormat Constructor 


Initializes a new instance of a DecimalFormat object. 


Overload List 


Name Description 
DecimalFormat () Initializes a new instance of a DecimalFormat object. 
DecimalFormat (String) Initializes a new instance of a DecimalFormat object. The decimal will be form 


atted into a string using the pattern provided. 





DecimalFormat (String, DecimalFormatSymbols)|Initializes a new instance of a DecimalFormat object. The decimal will be form 
atted into a string using the pattern and format symbols provided. 








See Also 

Reference 
DecimalFormat Class 
Concepts 

DecimalFormat Members 
java.text Package 
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DecimalFormat Constructor () 


Initializes a new instance of a DecimalFormat object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 





public java.text.DecimalFormat(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
DecimalFormat Class 
Concepts 

DecimalFormat Members 
java.text Package 
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DecimalFormat Constructor (String) 


Initializes 


a new instance of a DecimalFormat object. The decimal will be formatted into a string using the pattern provided. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 





public java.text.DecimalFormat( 
java.lang.String pattern); 





Parameters 


pattern 


The pattern describing how to format the decimal as a string. 


Remarks 


Valid characters for the pattern string include "#", "0", ".","","%","s", and "\u2030" (the permill operator). As positive and 
negative numbers may have a different format, two different patters can be specified by this pattern string with a semicolon 

















separator in between the two patterns. Following are short descriptions for each of the pattern characters: 

Characte|Definition 

: 

# Place holder for a digit. Ignored if the number being formatted does not contain a digit to place at this position. 

0 Place holder for a digit. If the number being formatted does not contain a digit to place at this position, a zero is place 
d there. 
Place holder for a decimal separator. 

; Place holder for a grouping separator. 

% Indicator for a percentage pattern. If present, the formatter will divide the number by 100 and show the percent sym 
bol. 

\u2030 {Indicator for a permill pattern. If present, the formatter will divide the number by 1000 and show the permill symbol. 

; Separates positive and negative format patterns. 

See Also 

Reference 


DecimalFormat Class 


Concepts 


DecimalFormat Members 
java.text Package 
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DecimalFormat Constructor (String, DecimalFormatSymbols) 


Initializes a new instance of a DecimalFormat object. The decimal will be formatted into a string using the pattern and format 
symbols provided. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.text.DecimalFormat( 


java.lang.String pattern, 
java.text.DecimalFormatSymbols symbols); 








Parameters 
pattern 


The pattern describing how to format the decimal as a string. 
symbols 

A DecimalFormatSymbols object describing the symbols to use in formatting the decimal as a string. 
Remarks 


Valid characters for the pattern string include "#", "0", ".",",","%","s", and "\u2030" (the permill operator). As positive and 
negative numbers may have a different format, two different patters can be specified by this pattern string with a semicolon 
separator in between the two patterns. Following are short descriptions for each of the pattern characters: 





Characte|Definition 
5 


# Place holder for a digit. Ignored if the number being formatted does not contain a digit to place at this position. 
0 Place holder for a digit. If the number being formatted does not contain a digit to place at this position, a zero is place 
d there. 





Place holder for a decimal separator. 





f Place holder for a grouping separator. 





% Indicator for a percentage pattern. If present, the formatter will divide the number by 100 and show the percent sym 
bol. 


\u2030 |Indicator for a permill pattern. If present, the formatter will divide the number by 1000 and show the permill symbol. 


: Separates positive and negative format patterns. 








See Also 
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DecimalFormat Methods 


Public Methods 





Name 


Description 





applyLocalizedPattern 


applyPattern 


equals 


format 


getDecimalFormatSymbols 


getGroupingSize 


hashCode 


Changes the pattern that an instance of a DecimalFormat object is using after it is created. 
Localization of the pattern is currently not supported by the J# Class Libraries. 


Changes the pattern that an instance of a DecimalFormat object is using after it is created. 


Overridden. Determines whether two DecimalFormat objects are equal. 


Overloaded. Formats a decimal into a string. 


Gets the DecimalFormatSymbols object that contains the symbols used when formatting a 
decimal. 


Gets the number of characters that are grouped together between grouping separators. 


Overridden. Serves as a hash function for a particular type, suitable for use in hashing algo 
rithms and data structures like a hash table. 





getMaximumF ractionDigits 


getMaximumInteger Digits 


Gets a value representing the maximum number of digits displayed in the fractional part of 
the number. (inherited from NumberFormat ) 


Gets a value representing the maximum number of digits displayed in the integer part of t 
he number. (inherited from NumberFormat ) 





getMinimumFractionDigits 


getMinimumIntegerDigits 


Gets a value representing the minimum number of digits displayed in the fractional part of 
the number. (inherited from NumberFormat ) 


Gets a value representing the minimum number of digits displayed in the integer part of th 
e number. (inherited from NumberFormat ) 











getMultiplier Gets the multiplier used for calculating percents or permills. 
getNegativePrefix Gets the symbol that is prefixed to a negative number. 
getNegativeSuffix Gets the symbol that is appended to a negative number. 





getPositivePrefix 


Gets the symbol that is prefixed to a positive number. 





getPositiveSuffix 


Gets the symbol that is appended to a positive number. 





getClass 


isDecimalSeparatorAlwaysShown 


isGroupingUsed 


isParselntegerOnly 





(inherited from Object ) 
Determines whether the decimal separator is shown with integers. 
Determines whether digits are being grouped together. (inherited from NumberFormat ) 


Determines whether only the integer portion of the number is being parsed or if the fractio 
nal part is also included. (inherited from NumberFormat ) 




















clone Creates a shallow copy of the current DecimalFormat object. 
parse Overloaded. Parses a string into a decimal. 
parseObject Overloaded. Parses a string into an Object. (inherited from NumberFormat ) 





setDecimalFormatSymbols 


setDecimalSeparatorAlwaysShown 


setGroupingSize 


setGroupingUsed 


setMaximumFractionDigits 


Sets a DecimalFormatSymbols object that contains the symbols used when formatting a de 
cimal. 


Sets a value indicating whether the decimal separator is shown with integers. 


Sets the number of characters that are grouped together between grouping separators. 


Sets a value determining whether digits are being grouped together. (inherited from 
NumberFormat ) 


Sets the value representing the maximum number of digits displayed in the fractional part 
of the number. (inherited from NumberFormat ) 





setMaximumI|ntegerDigits 


setMinimumFractionDigits 


Sets the value representing the maximum number of digits displayed in the integer part of 
the number. (inherited from NumberFormat ) 


Sets the value representing the minimum number of digits displayed in the fractional part 
of the number. (inherited from NumberFormat ) 





setMinimumIntegerDigits 


setMultiplier 


setNegativePrefix 


setNegativeSuffix 


setParselntegerOnly 


Sets the value representing the minimum number of digits displayed in the integer part of 
the number. (inherited from NumberFormat ) 


Sets the multiplier used for calculating percents or permills. 


Sets the symbol that is prefixed to a negative number. 


Sets the symbol that is appended to a negative number. 


Sets a value determining whether only the integer portion of the number is being parsed o 
r if the fractional part is also included. (inherited from NumberFormat ) 





setPositivePrefix 


Sets the symbol that is prefixed to a positive number. 





setPositiveS uffix 


Sets the symbol that is appended to a positive number. 





toLocalizedPattern 


toPattern 


Applies the previously set pattern to the string for an instance of a DecimalFormat object. L 
ocalization of the pattern is currently not supported by the J# Class Libraries. 


Applies the previously set pattern to the string for an instance of a DecimalFormat object. 





toString 





Displays a human-readable representation of a Format object. (inherited from Format ) 





Protected Methods 
Name 


finalize 





See Also 
Reference 





(inherited from Object ) 
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DecimalFormat.applyLocalizedPattern Method 


Changes the pattern that an instance of a DecimalFormat object is using after it is created. Localization of the pattern is 
currently not supported by the J# Class Libraries. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void applyLocalizedPattern( 
java.lang.String pattern); 


Parameters 
pattern 


Specifies the style used to format to or parse from number strings. 
Example 


The following example shows how to format two decimals using a localized pattern. 


// decimalformat_applylocalizedpattern.jsl 
import java.text.*; 


public class Program 


{ 


public static void main(String[] args) 


{ 


// Create a DecimalFormat object and set it's pattern. 
DecimalFormat decForm = new DecimalFormat(); 
decForm. applyLocalizedPattern("#. OO###" ) ; 


// Format some decimals using the pattern supplied above. 
StringBuffer dest1 = new StringBuffer(24) ; 

StringBuffer dest2 = new StringBuffer(24) ; 

FieldPosition pos = new FieldPosition(NumberFormat. FRACTION FIELD) ; 


dest1 = decForm.format(22.3423D, dest1, pos); 
System.out.println("dest1 = " + dest1); 


dest2 = decForm.format(6400@D, dest2, pos); 
System.out.println("dest2 = " + dest2); 


} 


/* 

Output: 

dest1 = 22.3423 
dest2 = 64000.00 


Remarks 


Localization of the pattern is currently not supported by the J# Class Libraries. Calling this method has the same effect as 
calling applyPattern. 


Valid characters for the pattern string include "#", "0", ".",",","%","s", and "\u2030" (the permill operator). As positive and 
negative numbers may have a different format, two different patters can be specified by this pattern string with a semicolon 
separator in between the two patterns. Following are short descriptions for each of the pattern characters: 











# Place holder for a digit. Ignored if the number being formatted does not contain a digit to place at this position. 


Place holder for a digit. If the number being formatted does not contain a digit to place at this position, a zero is place 
d there. 





Place holder for a decimal separator. 





Place holder for a grouping separator. 





Indicator for a percentage pattern. If present, the formatter will divide the number by 100 and show the percent sym 
bol. 


% 


\u2030 |Indicator for a permill pattern. If present, the formatter will divide the number by 1000 and show the permill symbol. 





Separates positive and negative format patterns. 








See Also 
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DecimalFormat.applyPattern Method 


Changes the pattern that an instance of a DecimalFormat object is using after it is created. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void applyPattern( 


java.lang.String pattern); 
| 


Parameters 
pattern 


Specifies the style used to format to or parse from number strings. 
Example 


The following example shows how to format two decimals using a localized pattern. 


// decimalformat_applypattern.jsl 
import java.text.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
// Create a DecimalFormat object and set it's pattern. 
DecimalFormat decForm = new DecimalFormat(); 
decForm.applyPattern("#. Q0###" ) ; 
// Format some decimals using the pattern supplied above. 
StringBuffer dest1 = new StringBuffer(24) ; 
StringBuffer dest2 = new StringBuffer(24) ; 
FieldPosition pos = new FieldPosition(NumberFormat. FRACTION FIELD); 
dest1 = decForm.format(22.3423D, dest1, pos); 
System.out.println("dest1 = " + dest1); 
dest2 = decForm.format(6400@D, dest2, pos); 
System.out.println("dest2 = " + dest2); 
} 
} 
/* 
Output: 
dest1 = 22.3423 
dest2 = 64000.00 
*/ 
Remarks 
Valid characters for the pattern string include "#", "0", ".",",","%","s", and "\u2030" (the permill operator). As positive and 


negative numbers may have a different format, two different patters can be specified by this pattern string with a semicolon 
separator in between the two patterns. Following are short descriptions for each of the pattern characters: 





Characte|Definition 





# Place holder for a digit. Ignored if the number being formatted does not contain a digit to place at this position. 














0 Place holder for a digit. If the number being formatted does not contain a digit to place at this position, a zero is place 
d there. 





Place holder for a decimal separator. 





; Place holder for a grouping separator. 





% Indicator for a percentage pattern. If present, the formatter will divide the number by 100 and show the percent sym 
bol. 


\u2030 |Indicator for a permill pattern. If present, the formatter will divide the number by 1000 and show the permill symbol. 





Separates positive and negative format patterns. 








See Also 
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DecimalFormat.clone Method 


Creates a shallow copy of the current DecimalFormat object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object clone(); 


Return Value 
A shallow copy of the current DecimalFormat object. 


See Also 

Reference 
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DecimalFormat.equals Method 


Determines whether two DecimalFormat objects are equal. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public boolean equals( 
java.lang.Object obj); 


Parameters 


obj 

A DecimalFormat object to compare with the current DecimalFormat object for equality. 
Return Value 
true if the two DecimalFormat objects are equal; false otherwise. 


See Also 

Reference 
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DecimalFormat.format Method 


Formats a decimal into a string. 


Overload List 
Name 


DecimalFormat.format (double) 


DecimalFormat.format (long) 


DecimalFormat.format (Object) 


DecimalFormat.format (double, StringBuffer, FieldPosition) 


Description 


Formats a double into a string. 
Formats a long into a string. 
Formats an object into a string. 


Formats a double and appends it to a StringBuffer object. 





DecimalFormat.format (long, StringBuffer, FieldPosition) 


Formats a long and appends it to a StringBuffer object. 





DecimalFormat.format (Object, StringBuffer, FieldPosition) 





Formats an Object and appends it to a StringBuffer object. 





See Also 

Reference 
DecimalFormat Class 
Concepts 

DecimalFormat Members 
java.text Package 





Visual J# Reference 


DecimalFormat.format Method (Double, StringBuffer, 
FieldPosition) 


Formats a double and appends it to a StringBuffer object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.StringBuffer format( 
double dblnum, 
java.lang.StringBuffer dest, 
java.text.FieldPosition pos); 


Parameters 


dblnum 
The double to be formatted into a string. 
dest 
A StringBuffer object to be appended with the double formatted into a string. 
pos 
Used to find start and end indices of a particular field of the number in the formatted string. 
Return Value 
A StringBuffer object appended with the double formatted into a string. 
Example 


The following example formats a decimal value and prints out the beginning and ending indices of the fraction part of the 
decimal. 


// decimalformat_format.jsl 
import java.text.*; 


public class Program 


{ 


public static void main(String[] args) 

if 
// Create a DecimalFormat object and set it's pattern. 
DecimalFormat decForm = new DecimalFormat(); 
decForm.applyPattern("#.Q0###" ) ; 


// Format some decimals using the pattern supplied above. 
StringBuffer dest1 = new StringBuffer(24) ; 

StringBuffer dest2 = new StringBuffer(24) ; 

FieldPosition pos = new FieldPosition(NumberFormat. FRACTION FIELD); 


dest1 = decForm.format(22.3423D, dest1, pos); 
System.out.println("dest1 = " + dest1); 
System.out.println("FRACTION is at: " + pos.getBeginIndex() + 


» " + pos.getEndIndex()); 


dest2 = decForm.format(6400@D, dest2, pos); 

System.out.println("dest2 = " + dest2); 

System.out.println("FRACTION is at: " + pos.getBeginIndex() + 
", " + pos.getEndIndex()); 


/* 

Output: 

dest1 = 22.3423 
FRACTION is at: 3, 7 
dest2 = 64000.00 
FRACTION is at: 6, 8 
*/ 











See Also 
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DecimalFormat.format Method (Int64, StringBuffer, 
FieldPosition) 


Formats a long and appends it to a StringBuffer object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.StringBuffer format( 
long number, 
java.lang.StringBuffer dest, 
java.text.FieldPosition pos); 


Parameters 
number 


The long to be formatted into a string. 
dest 
A StringBuffer object to be appended with the long formatted into a string. 
pos 
Used to find start and end indices of a particular field of the number in the formatted string. 
Return Value 
A StringBuffer object appended with the long formatted into a string. 
Example 


The following example formats a long value and prints out the beginning and ending indices of the integer part of the long. 


// decimalformat_format_2.js1l 
import java.text.*; 


public class Program 
4 
public static void main(String[] args) 
{ 
// Create a DecimalFormat object and set it's pattern. 
DecimalFormat decForm = new DecimalFormat(); 
decForm.applyPattern("#. Q0###" ) ; 


// Format some decimals using the pattern supplied above. 
StringBuffer dest1 = new StringBuffer(24) ; 

StringBuffer dest2 = new StringBuffer(24) ; 

FieldPosition pos = new FieldPosition(NumberFormat.INTEGER_FIELD); 


dest1 = decForm.format(223423L, dest1, pos); 

System.out.println("dest1 = " + dest1); 

System.out.println("INTEGER fields are at: " + pos.getBeginIndex() + 
", " + pos.getEndIndex()); 


dest2 = decForm.format(640@@L, dest2, pos); 

System.out.println("dest2 = " + dest2); 

System.out.println("INTEGER fields are at: " + pos.getBeginIndex() + 
", " + pos.getEndIndex()); 


/* 


Output: 

dest1 = 223423.00 

INTEGER fields are at: 0, 6 
dest2 = 64000.00 

INTEGER fields are at: 90, 5 
af 





See Also 
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DecimalFormat.getDecimalFormatSymbols Method 


Gets the DecimalFormatSymbols object that contains the symbols used when formatting a decimal. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.text.DecimalFormatSymbols getDecimalFormatSymbols(); 


Return Value 
The DecimalFormatSymbols object that contains the symbols used when formatting a decimal. 
Example 


The following example shows the various properties of the DecimalFormatSymbols object. 


// decimalformat_getdecimalformatsymbols.js1l 
import java.text.*; 


public class Program 


{ 


public static void main(String[] args) 

if 
// Create a new DecimalFormat object. 
DecimalFormat decForm = new DecimalFormat(); 


// Display the various properties of the 
// DecimalFormatSymbols object. 
DecimalFormatSymbols dfs = 
decForm.getDecimalFormatSymbols() ; 
System.out.println("DecimalFormatSymbols.getDecimalSeparator: " + 
dfs.getDecimalSeparator()); 
System.out.println("DecimalFormatSymbols.getDigit: " + 
dfs.getDigit()); 
System.out.println("DecimalFormatSymbols.getGroupingSeparator: " + 
dfs.getGroupingSeparator()); 
System.out.println("DecimalFormatSymbols.getInfinity: " + 
dfs.getInfinity()); 
System.out.println("DecimalFormatSymbols.getMinusSign: " + 
dfs.getMinusSign()); 
System.out.println("DecimalFormatSymbols.getNaN: " + 
dfs.getNaN()); 
System.out.println("DecimalFormatSymbols.getPatternSeparator: " + 
dfs.getPatternSeparator()); 
System.out.println("DecimalFormatSymbols.getPercent: " + 
dfs.getPercent()); 
System.out.printin("DecimalFormatSymbols.getPerMill: " + 
dfs.getPerMill()); 
System.out.println("DecimalFormatSymbols.getZeroDigit: " + 
dfs.getZeroDigit()); 


} 


/* 

Output: 
DecimalFormatSymbols.getDecimalSeparator: 
DecimalFormatSymbols.getDigit: # 
DecimalFormatSymbols.getGroupingSeparator: , 
DecimalFormatSymbols.getInfinity: 8 
DecimalFormatSymbols.getMinusSign: - 
DecimalFormatSymbols.getNaN: ? 


DecimalFormatSymbols.getPatternSeparator: 
DecimalFormatSymbols.getPercent: % 
DecimalFormatSymbols.getPerMill: 6 
DecimalFormatSymbols.getZeroDigit: @ 

a 


I 
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DecimalFormat.getGroupingSize Method 


Gets the number of characters that are grouped together between grouping separators. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public int getGroupingSize(); 


Return Value 
The number of characters that are grouped together between grouping separators. 
Example 
The following example displays the default grouping size for decimals. 
// decimalformat_getgroupingsize.jsl 
import java.text.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a new DecimalFormat object. 
DecimalFormat decForm = new DecimalFormat(); 
// Display the various properties of the DecimalFormat 
// object. 
System.out.println("Grouping Size: " + 
decForm. getGroupingSize()); 
} 
} 
/* 
Output: 
Grouping Size: 3 
m7 
See Also 
Reference 
DecimalFormat Class 
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DecimalFormat Members 
java.text Package 
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DecimalFormat.hashCode Method 


Serves as a hash function for a particular type, suitable for use in hashing algorithms and data structures like a hash table. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public int hashCode(); 


Return Value 
A hash code for the current object. 


See Also 

Reference 
DecimalFormat Class 
Concepts 

DecimalFormat Members 
java.text Package 


Visual J# Reference 


DecimalFormat.getMultiplier Method 


Gets the multiplier used for calculating percents or permills. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public int getMultiplier(); 


Return Value 
The multiplier used for calculating percents or permills. 
Example 


The following example displays the default multiplier for decimals. 


// decimalformat_getmultiplier.jsl 
import java.text.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a new DecimalFormat object. 
DecimalFormat decForm = new DecimalFormat(); 
// Display the various properties of the DecimalFormat 
// object. 
System.out.println("Multiplier: " + 
decForm.getMultiplier()); 
} 
} 
/* 
Output: 
Multiplier: 1 
A 
See Also 
Reference 
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DecimalFormat Members 
java.text Package 
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DecimalFormat.getNegativePrefix Method 


Gets the symbol that is prefixed to a negative number. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getNegativePrefix(); 


Return Value 

The symbol that is prefixed to a negative number. 

Example 

The following example displays the default negative prefix for decimals. 
// decimalformat_getnegativeprefix.jsl 
import java.text.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a new DecimalFormat object. 
DecimalFormat decForm = new DecimalFormat(); 
// Display the various properties of the DecimalFormat 
// object. 
System.out.println("Negative Prefix: " + 
decForm. getNegativePrefix()); 
} 
} 
/* 
Output: 
Negative Prefix: - 
*/ 
See Also 
Reference 
DecimalFormat Class 
Concepts 


DecimalFormat Members 
java.text Package 


Visual J# Reference 


DecimalFormat.getNegativeSuffix Method 


Gets the symbol that is appended to a negative number. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getNegativeSuffix(); 


Return Value 

The symbol that is appended to a negative number. 

Example 

The following example displays a common negative suffix for decimals. 
// decimalformat_getnegativesuffix.jsl 
import java.text.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a new DecimalFormat object. 
DecimalFormat decForm = new DecimalFormat("@.00;0.00-"); 
// Display the various properties of the DecimalFormat 
// object. 
System.out.println("Negative Suffix: " + 
decForm. getNegativeSuffix()); 
} 
} 
/* 
Output: 
Negative Suffix: - 
*/ 
See Also 
Reference 
DecimalFormat Class 
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DecimalFormat Members 
java.text Package 


Visual J# Reference 


DecimalFormat.getPositivePrefix Method 


Gets the symbol that is prefixed to a positive number. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getPositivePrefix(); 


Return Value 

The symbol that is prefixed to a positive number. 

Example 

The following example displays a common positive prefix for decimals. 
// decimalformat_getpositiveprefix.jsl 
import java.text.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a new DecimalFormat object. 
DecimalFormat decForm = new DecimalFormat("+0.00") ; 
// Display the various properties of the DecimalFormat 
// object. 
System.out.println("Positive Prefix: " + 
decForm.getPositivePrefix()); 
} 
} 
/* 
Output: 
Positive Prefix: + 
a 
See Also 
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DecimalFormat Members 
java.text Package 
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DecimalFormat.getPositiveSuffix Method 


Gets the symbol that is appended to a positive number. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getPositiveSuffix(); 


Return Value 

The symbol that is appended to a positive number. 

Example 

The following example displays a common positive suffix for decimals. 
// decimalformat_getpositivesuffix.jsl 
import java.text.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a new DecimalFormat object. 
DecimalFormat decForm = new DecimalFormat("@.00+") ; 
// Display the various properties of the DecimalFormat 
// object. 
System.out.println("Positive Suffix: " + 
decForm. getPositiveSuffix()); 
} 
} 
/* 
Output: 
Positive Suffix: + 
a 
See Also 
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DecimalFormat Members 
java.text Package 
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DecimalFormat.isDecimalSeparatorAlwaysShown Method 


Determines whether the decimal separator is shown with integers. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public boolean isDecimalSeparatorAlwaysShown() ; 


Return Value 
true if the decimal separator is shown with integers; false otherwise. 
Example 


The following example displays the default value that determines whether the decimal separator is shown for decimals. 


// decimalformat_isdecialseparatoralwaysshown. jsl 
import java.text.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a new DecimalFormat object. 
DecimalFormat decForm = new DecimalFormat(); 
// Display the various properties of the DecimalFormat 
// object. 
System.out.printin("Is Decimal Separator Always Shown? " + 
decForm. isDecimalSeparatorAlwaysShown() ) ; 
} 
} 
/* 
Output: 
Is Decimal Separator Always Shown? false 
a 
See Also 
Reference 
DecimalFormat Class 
Concepts 


DecimalFormat Members 
java.text Package 
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DecimalFormat.parse Method 


Parses a string into a decimal. 


Overload List 


Name Description 


DecimalFormat.parse (String) Parses a string into a number represented by a Number object. 





DecimalFormat.parse (String, ParsePosition) Parses a string into a decimal represented by a Number object. 


See Also 

Reference 
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DecimalFormat Members 
java.text Package 
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DecimalFormat.parse Method (String, ParsePosition) 


Parses a string into a decimal represented by a Number object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Number parse( 
java.lang.String str, 
java.text.ParsePosition pos); 


Parameters 
str 


The string to be parsed into a decimal represented by a Number object. 
pos 
Used to indicate the first position in the string to be parsed. 
Return Value 
A Number object containing the string parsed into a decimal. 
Example 


The following example parses a string starting at position 8 into a number and displays the result to the Console. 


// decimalformat_parse.jsl 
import java.text.*; 


public class Program 
{ 
public static void main(String[] args) 
ii 
// Create a new DecimalFormat object. 
DecimalFormat decForm = new DecimalFormat(); 


// Parse the decimal starting at position 8. 

ParsePosition pos = new ParsePosition(8); 

Number n = decForm.parse("123456789.14", pos); 

System.out.println("Number = " + n); 

System.out.println("Position after parse = " + 
pos.getIndex()); 


/* 

Output: 

Number = 9.14 

Position after parse = 12 


a 


See Also 

Reference 
DecimalFormat Class 
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DecimalFormat.setDecimalFormatSymbols Method 


Sets a DecimalFormatSymbols object that contains the symbols used when formatting a decimal. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setDecimalFormatSymbol1s ( 
java.text.DecimalFormatSymbols newSymbols) ; 


Parameters 
newSymbols 


A DecimalFormatSymbols object that contains the symbols used when formatting a decimal. 


Example 


The following example sets the DecimalFormatSymbols object to a default instance of a DecimalFormatSymbols object. 


// decimalformat_setdecimalformatsymbols.js1l 


import java.text.*; 


public class Program 


public static void main(String[] args) 


{ 

} 
} 
/* 
Output: 


// Create a new DecimalFormat object. 


DecimalFormat decForm = new DecimalFormat() ; 


// Set the DecimalFormatSymbols to a default instance 


// of the DecimalFormatSymbols class. 
DecimalFormatSymbols dfs = 
decForm.setDecimalFormatSymbols (dfs) ; 


// Display the various properties of the 
// DecimalFormatSymbols object. 


System.out.println("DecimalFormatSymbols. 


dfs.getDecimalSeparator()); 


System.out.println("DecimalFormatSymbols. 


dfs.getDigit()); 


System.out.println("DecimalFormatSymbols. 


dfs.getGroupingSeparator()); 


System.out.println("DecimalFormatSymbols. 


dfs.getInfinity()); 


System.out.println("DecimalFormatSymbols. 


dfs.getMinusSign()); 


System.out.println("DecimalFormatSymbols. 


dfs.getNaN()); 


System.out.println("DecimalFormatSymbols. 


dfs.getPatternSeparator()); 


System.out.println("DecimalFormatSymbols. 


dfs.getPercent()); 


System.out.println("DecimalFormatSymbols. 


dfs.getPerMill()); 


System.out.println("DecimalFormatSymbols. 


dfs.getZeroDigit()); 


DecimalFormatSymbols.getDecimalSeparator: 
DecimalFormatSymbols.getDigit: # 


new DecimalFormatSymbols(); 


getDecimalSeparator: + 


getDigit: + 


getGroupingSeparator: " + 
getInfinity: " + 
getMinusSign: " + 

getNaN: " + 
getPatternSeparator: " + 
getPercent: " + 


getPerMill: " + 


getZeroDigit: + 


DecimalFormatSymbols.getGroupingSeparator: , 
DecimalFormatSymbols.getInfinity: 8 
DecimalFormatSymbols.getMinusSign: - 
DecimalFormatSymbols.getNaN: ? 
DecimalFormatSymbols.getPatternSeparator: ; 
DecimalFormatSymbols.getPercent: % 
DecimalFormatSymbols.getPerMill: 6 
DecimalFormatSymbols.getZeroDigit: @ 

*/ 
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DecimalFormat.setDecimalSeparatorAlwaysShown Method 


Sets a value indicating whether the decimal separator is shown with integers. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setDecimalSeparatorAlwaysShown( 
boolean newValue) ; 


Parameters 
newValue 


true to display the decimal separator with integers; false otherwise. 
Example 


The following example sets a value indicating that the decimal separator should always be shown for decimals. 
// decimalformat_setdecialseparatoralwaysshown.jsl 
import java.text.*; 
public class Program 


public static void main(String[] args) 


{ 
// Create a new DecimalFormat object. 
DecimalFormat decForm = new DecimalFormat(); 
// Make the decimal separator always shown. 
decForm. setDecimalSeparatorAlwaysShown(true) ; 
System.out.println("Is Decimal Separator Always Shown? " + 
decForm. isDecimalSeparatorAlwaysShown() ) ; 
} 
; 
/* 
Output: 
Is Decimal Separator Always Shown? true 
*/ 
See Also 
Reference 
DecimalFormat Class 
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java.text Package 
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DecimalFormat.setGroupingSize Method 


Sets the number of characters that are grouped together between grouping separators. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setGroupingSize( 
int groupSize); 


Parameters 
groupSize 


The number of characters that are grouped together between grouping separators. 
Example 
The following example sets the grouping size for decimals to the value 3. 
// decimalformat_setgroupingsize.jsl 
import java.text.*; 
public class Program 


public static void main(String[] args) 


{ 
// Create a new DecimalFormat object. 
DecimalFormat decForm = new DecimalFormat(); 
// Set the grouping size to groups of 3. 
decForm. setGroupingSize(3) ; 
System.out.println("Grouping Size: " + 
decForm. getGroupingSize() ); 
} 
; 
/* 
Output: 
Grouping Size: 3 
*/ 
See Also 
Reference 
DecimalFormat Class 
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DecimalFormat Members 
java.text Package 
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DecimalFormat.setMultiplier Method 


Sets the multiplier used for calculating percents or permills. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setMultiplier( 
int newValue); 


Parameters 
newValue 


The multiplier used for calculating percents or permills. 
Example 


The following example sets the multiplier for percents and permills to 2. 
// decimalformat_setmultiplier.jsl 
import java.text.*; 
public class Program 


public static void main(String[] args) 


{ 
// Create a new DecimalFormat object. 
DecimalFormat decForm = new DecimalFormat(); 
// Set the multiplier for percents and permills 
// to 2. 
decForm.setMultiplier(2) ; 
System.out.println( "Multiplier: " + 
decForm.getMultiplier()); 
} 
z 
/* 
Output: 
Multiplier: 2 
7, 
See Also 
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DecimalFormat.setNegativePrefix Method 


Sets the symbol that is prefixed to a negative number. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setNegativePrefix( 
java.lang.String newValue) ; 


Parameters 
newValue 


The symbol that is prefixed to a negative number. 
Example 


The following example sets the negative prefix and the negative suffix to "(" and ")", respectively. 


// decimalformat_setnegativeprefix.jsl 
import java.text.*; 
public class Program 


public static void main(String[] args) 

{ 
// Create a new DecimalFormat object. 
DecimalFormat decForm = new DecimalFormat() ; 


// Set the negative prefix to "(" and the negative 
// suffix to ")". 
decForm. setNegativePrefix("("); 
decForm. setNegativeSuffix(")"); 
System.out.println("Negative Prefix: + 

decForm. getNegativePrefix()); 
System.out.println("Negative Suffix: + 

decForm. getNegativeSuffix() ); 


} 


/* 

Output: 

Negative Prefix: ( 
Negative Suffix: ) 
arf 
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DecimalFormat.setNegativeSuffix Method 


Sets the symbol that is appended to a negative number. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setNegativeSuffix( 
java.lang.String newValue); 


Parameters 
newValue 


The symbol that is appended to a negative number. 
Example 


The following example sets the negative prefix and the negative suffix to "(" and ")", respectively. 


// decimalformat_setnegativesuffix.jsl 
import java.text.*; 
public class Program 


public static void main(String[] args) 

{ 
// Create a new DecimalFormat object. 
DecimalFormat decForm = new DecimalFormat() ; 


// Set the negative prefix to "(" and the negative 
// suffix to ")". 
decForm. setNegativePrefix("("); 
decForm. setNegativeSuffix(")"); 
System.out.println("Negative Prefix: + 

decForm. getNegativePrefix()); 
System.out.println("Negative Suffix: + 

decForm. getNegativeSuffix() ); 


} 


/* 

Output: 

Negative Prefix: ( 
Negative Suffix: ) 
arf 


See Also 
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DecimalFormat Class 
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DecimalFormat.setPositivePrefix Method 


Sets the symbol that is prefixed to a positive number. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setPositivePrefix( 
java.lang.String newValue); 


Parameters 
newValue 


The symbol that is prefixed to a positive number. 


Example 


The following example sets the positive prefix to an empty string and the positive suffix to "+". 


// decimalformat_setpositiveprefix.jsl 
import java.text.*; 
public class Program 


public static void main(String[] args) 
{ 
// Create a new DecimalFormat object. 
DecimalFormat decForm = new DecimalFormat(); 
// Set the positive prefix to "" 
// suffix to "+". 
decForm.setPositivePrefix(""); 
decForm. setPositiveSuffix("+"); 
System.out.println("Positive Prefix: + 
decForm. getPositivePrefix()); 
System.out.println("Positive Suffix: + 
decForm. getPositiveSuffix() ); 


and the positive 


} 


/* 

Output: 

Positive Prefix: 
Positive Suffix: + 


*/ 
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DecimalFormat.setPositiveSuffix Method 


Sets the symbol that is appended to a positive number. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setPositiveSuffix( 
java.lang.String newValue); 


Parameters 
newValue 


The symbol that is appended to a positive number. 


Example 


The following example sets the positive prefix to an empty string and the positive suffix to "+". 


// decimalformat_setpositivesuffix.jsl 
import java.text.*; 
public class Program 


public static void main(String[] args) 
{ 
// Create a new DecimalFormat object. 
DecimalFormat decForm = new DecimalFormat(); 
// Set the positive prefix to "" 
// suffix to "+". 
decForm.setPositivePrefix(""); 
decForm. setPositiveSuffix("+"); 
System.out.println("Positive Prefix: + 
decForm. getPositivePrefix()); 
System.out.println("Positive Suffix: + 
decForm. getPositiveSuffix() ); 


and the positive 


} 


/* 

Output: 

Positive Prefix: 
Positive Suffix: + 


*/ 


See Also 
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DecimalFormat.toLocalizedPattern Method 


Applies the previously set pattern to the string for an instance of a DecimalFormat object. Localization of the pattern is 
currently not supported by the J# Class Libraries. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toLocalizedPattern(); 


Return Value 
The string representation of the decimal formatted using the previously set pattern. 
Example 
The following example displays the default localized pattern of a DecimalFormat object. 
// decimalformat_tolocalizedpattern.jsl 
import java.text.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Display the default localized pattern for a 
// DecimalFormat object. 
DecimalFormat decForm = new DecimalFormat(); 
System.out.println("Default Localized Pattern: " + 
decForm.toLocalizedPattern()); 
} 
} 
/* 
Output: 
Default Localized Pattern: #,##0.### 
=] 
Remarks 


Localization of the pattern is currently not supported by the J# Class Libraries. Calling this method has the same effect as 
calling toPattern. 
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DecimalFormat.toPattern Method 


Applies the previously set pattern to the string for an instance of a DecimalFormat object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toPattern(); 


Return Value 
The string representation of the decimal formatted using the previously set pattern. 
Example 


The following example displays the default pattern of a DecimalFormat object. 


// decimalformat_topattern.jsl 
import java.text.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Display the default localized pattern for a 
// DecimalFormat object. 
DecimalFormat decForm = new DecimalFormat(); 
System.out.println("Default Pattern: " + 
decForm.toPattern()); 
} 
} 
/* 
Output: 
Default Pattern: #,##0.### 
ef 
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Concepts 


DecimalFormat Members 
java.text Package 


Visual J# Reference 


DecimalFormatSymbols Class 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public final class java.text.DecimalFormatSymbols 
extends java.lang.Object 
implements java.lang.Cloneable, java.io.Serializable 


Inheritance Hierarchy 
java.lang.Object 
java.text.DecimalFormatSymbols 


See Also 

Concepts 

DecimalFormatSymbols Members 
java.text Package 


Visual J# Reference 


DecimalFormatSymbols Members 


The following tables list the members exposed by the DecimalFormatSymbols type. 


Public Constructors 


Name Description 


DecimalFormatSymbols 





Public Methods 





Name Description 





equals Overridden. 





getDecimalSeparator 

getDigit 

getGroupingSeparator 

hashCode Overridden. 

getinfinity 

getMinusSign 

getNaN 

getPatternSeparator 

getPercent 

getPerMill 

getClass (inherited from Object ) 
getZeroDigit 

MemberwiseClone Performs a shallow copy of the members. 
setDecimalSeparator 

setDigit 


setGroupingSeparator 





setinfinity 





setMinusSign 





setNaN 





setPatternSeparator 














setPercent 





setPerMill 





setZeroDigit 





toString 





Overridden. 





See Also 

Reference 
DecimalFormatSymbols Class 
Concepts 

java.text Package 





Visual J# Reference 


DecimalFormatSymbols Constructor 


Overload List 





Name Description 





DecimalFormatSymbols () 





DecimalFormatSymbols (Locale) 











See Also 

Reference 
DecimalFormatSymbols Class 
Concepts 

DecimalFormatSymbols Members 
java.text Package 


Visual J# Reference 


DecimalFormatSymbols Constructor () 


Initializes a new instance of the DecimalFormatSymbols Class . 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.text.DecimalFormatSymbols(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
DecimalFormatSymbols Class 
Concepts 

DecimalFormatSymbols Members 
java.text Package 


Visual J# Reference 


DecimalFormatSymbols Constructor (Locale) 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.text.DecimalFormatSymbols( 
java.util.Locale loc); 


Parameters 
loc 


See Also 

Reference 
DecimalFormatSymbols Class 
Concepts 

DecimalFormatSymbols Members 
java.text Package 
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DecimalFormatSymbols Methods 


Public Methods 





Name 


Description 





equals 


Overridden. 





getDecimalSeparator 





getDigit 





getGroupingSeparator 





hashCode 


getinfinity 


getMinusSign 


getNaN 


getPatternSeparator 


getPercent 


getPerMill 


getClass 


getZeroDigit 


MemberwiseClone 


setDecimalSeparator 


setDigit 


setGroupingSeparator 


setinfinity 


setMinusSign 


setNaN 


Overridden. 


(inherited from Object ) 


Performs a shallow copy of the members. 





setPatternSeparator 





setPercent 





setPerMill 





setZeroDigit 














toString Overridden. 











See Also 

Reference 
DecimalFormatSymbols Class 
Concepts 

java.text Package 
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DecimalFormatSymbols.clone Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


See Also 

Reference 
DecimalFormatSymbols Class 
Concepts 

DecimalFormatSymbols Members 
java.text Package 


Visual J# Reference 


DecimalFormatSymbols.equals Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public boolean equals( 
java.lang.Object obj); 


Parameters 


obj 


See Also 

Reference 
DecimalFormatSymbols Class 
Concepts 

DecimalFormatSymbols Members 
java.text Package 


Visual J# Reference 


DecimalFormatSymbols.getDecimalSeparator Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public char getDecimalSeparator(); 


See Also 

Reference 
DecimalFormatSymbols Class 
Concepts 

DecimalFormatSymbols Members 
java.text Package 


Visual J# Reference 


DecimalFormatSymbols.getDigit Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public char getDigit(); 


See Also 

Reference 
DecimalFormatSymbols Class 
Concepts 

DecimalFormatSymbols Members 
java.text Package 


Visual J# Reference 


DecimalFormatSymbols.getGroupingSeparator Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public char getGroupingSeparator(); 


See Also 

Reference 
DecimalFormatSymbols Class 
Concepts 

DecimalFormatSymbols Members 
java.text Package 


Visual J# Reference 


DecimalFormatSymbols.hashCode Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public int hashCode(); 


See Also 

Reference 
DecimalFormatSymbols Class 
Concepts 

DecimalFormatSymbols Members 
java.text Package 


Visual J# Reference 


DecimalFormatSymbols.getinfinity Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getInfinity(); 


See Also 

Reference 
DecimalFormatSymbols Class 
Concepts 

DecimalFormatSymbols Members 
java.text Package 


Visual J# Reference 


DecimalFormatSymbols.getMinusSign Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public char getMinusSign(); 


See Also 

Reference 
DecimalFormatSymbols Class 
Concepts 

DecimalFormatSymbols Members 
java.text Package 


Visual J# Reference 


DecimalFormatSymbols.getNaN Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getNaN(); 


See Also 

Reference 
DecimalFormatSymbols Class 
Concepts 

DecimalFormatSymbols Members 
java.text Package 


Visual J# Reference 


DecimalFormatSymbols.getPatternSeparator Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public char getPatternSeparator(); 


See Also 

Reference 
DecimalFormatSymbols Class 
Concepts 

DecimalFormatSymbols Members 
java.text Package 


Visual J# Reference 


DecimalFormatSymbols.getPercent Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public char getPercent(); 


See Also 

Reference 
DecimalFormatSymbols Class 
Concepts 

DecimalFormatSymbols Members 
java.text Package 


Visual J# Reference 


DecimalFormatSymbols.getPerMill Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public char getPerMill(); 


See Also 

Reference 
DecimalFormatSymbols Class 
Concepts 

DecimalFormatSymbols Members 
java.text Package 


Visual J# Reference 


DecimalFormatSymbols.getZeroDigit Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public char getZeroDigit(); 


See Also 

Reference 
DecimalFormatSymbols Class 
Concepts 

DecimalFormatSymbols Members 
java.text Package 


Visual J# Reference 


DecimalFormatSymbols.setDecimalSeparator Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setDecimalSeparator ( 
char decimalSep) ; 


Parameters 
decimalSep 


See Also 

Reference 
DecimalFormatSymbols Class 
Concepts 

DecimalFormatSymbols Members 
java.text Package 


Visual J# Reference 


DecimalFormatSymbols.setDigit Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setDigit( 
char digit); 


Parameters 


digit 


See Also 

Reference 
DecimalFormatSymbols Class 
Concepts 

DecimalFormatSymbols Members 
java.text Package 


Visual J# Reference 


DecimalFormatSymbols.setGroupingSeparator Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setGroupingSeparator( 
char groupSep); 


Parameters 


groupSep 


See Also 

Reference 
DecimalFormatSymbols Class 
Concepts 

DecimalFormatSymbols Members 
java.text Package 


Visual J# Reference 


DecimalFormatSymbols.setinfinity Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setInfinity( 
java.lang.String infinity); 


Parameters 
infinity 


See Also 

Reference 
DecimalFormatSymbols Class 
Concepts 

DecimalFormatSymbols Members 
java.text Package 


Visual J# Reference 


DecimalFormatSymbols.setMinusSign Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setMinusSign( 
char minusSign) ; 


Parameters 
minusSign 


See Also 

Reference 
DecimalFormatSymbols Class 
Concepts 

DecimalFormatSymbols Members 
java.text Package 


Visual J# Reference 


DecimalFormatSymbols.setNaN Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setNaN( 
java.lang.String nan); 


Parameters 
nan 


See Also 

Reference 
DecimalFormatSymbols Class 
Concepts 

DecimalFormatSymbols Members 
java.text Package 


Visual J# Reference 


DecimalFormatSymbols.setPatternSeparator Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setPatternSeparator ( 
char patternSep) ; 


Parameters 
patternSep 


See Also 

Reference 
DecimalFormatSymbols Class 
Concepts 

DecimalFormatSymbols Members 
java.text Package 


Visual J# Reference 


DecimalFormatSymbols.setPercent Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setPercent( 
char percent); 


Parameters 
percent 


See Also 

Reference 
DecimalFormatSymbols Class 
Concepts 

DecimalFormatSymbols Members 
java.text Package 


Visual J# Reference 


DecimalFormatSymbols.setPerMill Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setPerMil1( 
char perMill); 


Parameters 


perMill 


See Also 

Reference 
DecimalFormatSymbols Class 
Concepts 

DecimalFormatSymbols Members 
java.text Package 


Visual J# Reference 


DecimalFormatSymbols.setZeroDigit Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setZeroDigit( 
char zeroDigit) ; 


Parameters 
zeroDigit 


See Also 

Reference 
DecimalFormatSymbols Class 
Concepts 

DecimalFormatSymbols Members 
java.text Package 


Visual J# Reference 


FieldPosition Class 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public class java.text.FieldPosition 
extends java.lang.Object 





Inheritance Hierarchy 
java.lang.Object 
java.text.FieldPosition 


See Also 

Concepts 

FieldPosition Members 
java.text Package 


Visual J# Reference 


FieldPosition Members 


The following tables list the members exposed by the FieldPosition type. 


Public Constructors 
Name 


FieldPosition 





Public Methods 





Name Description 





equals (inherited from Object ) 





getBeginIndex 


getEndIndex 


getField 

hashCode (inherited from Object ) 
getClass (inherited from Object ) 
toString Overridden. 








Protected Methods 








Name Description 





finalize (inherited from Object ) 





MemberwiseClone Performs a shallow copy of the members. 











See Also 
Reference 
FieldPosition Class 
Concepts 

java.text Package 


Visual J# Reference 


FieldPosition Constructor 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.text.FieldPosition( 


int field); 





Parameters 


field 


See Also 

Reference 
FieldPosition Class 
Concepts 

FieldPosition Members 
java.text Package 
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FieldPosition Methods 


Public Methods 





Name Description 





equals (inherited from Object ) 





getBeginIndex 





getEndIndex 








getField 

hashCode (inherited from Object ) 
getClass (inherited from Object ) 
toString Overridden. 





Protected Methods 





Name Description 





finalize (inherited from Object ) 





MemberwiseClone Performs a shallow copy of the members. 











See Also 
Reference 
FieldPosition Class 
Concepts 

java.text Package 


Visual J# Reference 


FieldPosition.getBeginIndex Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public int getBeginIndex(); 


See Also 

Reference 
FieldPosition Class 
Concepts 

FieldPosition Members 
java.text Package 


Visual J# Reference 


FieldPosition.getEndIndex Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public int getEndIndex(); 


See Also 

Reference 
FieldPosition Class 
Concepts 

FieldPosition Members 
java.text Package 


Visual J# Reference 


FieldPosition.getField Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public int getField(); 


See Also 

Reference 
FieldPosition Class 
Concepts 

FieldPosition Members 
java.text Package 


Visual J# Reference 


Format Class 


An abstract class used as the base class for the rest of the format classes in the java.text package. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public abstract class java.text.Format 
extends java.lang.Object 
implements java.io.Serializable, java.lang.Cloneable 


Example 


The following example demonstrates the format and parseObject methods of the Format class. This example uses the 
NumberFormat class, which is a specialization of the abstract Format class. 


// format_overview.jsl 


import java.math.BigDecimal; 
import java.text.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
try 
{ 
// Get a default NumberFormat instance. 
NumberFormat numForm = NumberFormat.getInstance(); 
// Format some decimals using the pattern supplied above. 
BigDecimal bd1 = new BigDecimal(22.3423D); 
String dest1 = numForm.format(bd1) ; 
System.out.println("dest1 = " + dest1); 
BigDecimal bd2 = new BigDecimal(64@@@D) ; 
String dest2 = numForm.format(bd2) ; 
System.out.println("dest2 = " + dest2); 
// Parse the decimal string. 
Object o = numForm. parseObject("123456789.14"); 
System.out.println("Number = " + o.toString()); 
} 
catch (ParseException ex) 
{ 
System.out.println(ex.toString()); 
} 
} 
i 
/* 
Output: 


dest1 = 22.342 
dest2 = 64,000 
Number = 1.2345678914E8 
*/ 
Inheritance Hierarchy 


java.lang.Object 


java.text.Format 


java.text.DateFormat 
java.text.MessageFormat 
java.text.NumberFormat 


See Also 
Concepts 
Format Members 
java.text Package 
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Format Members 


An abstract class used as the base class for the rest of the format classes in the java.text package. 


The following tables list the members exposed by the Format type. 


Public Constructors 





Name Description 





Format Initializes a new instance of a Format object. 





Public Methods 
Name 





Description 




















equals (inherited from Object ) 

format Overloaded. Formats an object into a string. 

hashCode (inherited from Object ) 

getClass (inherited from Object ) 

MemberwiseClone Performs a shallow copy of the members. 

parseObject Overloaded. Parses a string into an Object. 

toString Overridden. Displays a human-readable representation of a Format object. 





Protected Methods 


Name Description 


finalize 





(inherited from Object ) 





See Also 
Reference 
Format Class 
Concepts 
java.text Package 
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Format Constructor 


Initializes a new instance of a Format object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 





public java.text.Format(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 
Reference 
Format Class 
Concepts 

Format Members 
java.text Package 
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Format Methods 


Public Methods 





Name 


Description 














equals (inherited from Object ) 
format Overloaded. Formats an object into a string. 
hashCode (inherited from Object ) 
getClass (inherited from Object ) 





MemberwiseClone 


parseObject 


toString 


Protected Methods 





Performs a shallow copy of the members. 
Overloaded. Parses a string into an Object. 


Overridden. Displays a human-readable representation of a Format object. 





Name 


Description 





finalize 





(inherited from Object ) 








See Also 
Reference 
Format Class 
Concepts 
java.text Package 
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Format.clone Method 


Creates an instance of a Format object that is a deep copy of the existing object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 





Return Value 
An instance of a Format object that is a deep copy of the existing object. 


See Also 
Reference 
Format Class 
Concepts 

Format Members 
java.text Package 
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Format.format Method 


Formats an object into a string. 


Overload List 


Name Description 


Format.format (Object) Formats an object into a string. 





Format.format (Object, StringBuffer, FieldPosition) Formats an object and appends it to a StringBuffer object. 


See Also 
Reference 
Format Class 
Concepts 

Format Members 
java.text Package 
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Format.format Method (Object) 


Formats an object into a string. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public final java.lang.String format( 
java.lang.Object obj); 


Parameters 


obj 

The object to be formatted into a string. 
Return Value 
The object formatted into a string. 
Example 


The following example formats a BigDecimal object. This example uses the NumberFormat class, which is a specialization of 
the abstract Format class. 


// format_format.jsl 


import java.math.BigDecimal; 
import java.text.*; 


public class Program 


{ 


public static void main(String[] args) 


A 


// Get a default NumberFormat instance. 
NumberFormat numForm = NumberFormat.getInstance(); 


// Format some decimals using the pattern supplied above. 
BigDecimal bd1 = new BigDecimal(22.3423D); 

String dest1 = numForm.format(bd1) ; 
System.out.println("dest1 = " + dest1); 


BigDecimal bd2 = new BigDecimal(64@@@D) ; 
String dest2 = numForm.format(bd2) ; 
System.out.println("dest2 = " + dest2); 


dest1 = 22.342 
dest2 = 64,000 


See Also 
Reference 
Format Class 
Concepts 

Format Members 
java.text Package 
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Format.format Method (Object, StringBuffer, FieldPosition) 


Formats an object and appends it to a StringBuffer object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.StringBuffer format( 
java.lang.Object obj, 
java.lang.StringBuffer appendBuf, 
java.text.FieldPosition pos); 


Parameters 


obj 
The object to be formatted into a string. 
appendBuf 
A StringBuffer object to be appended with the given object formatted into a string. 
pos 
Used to find start and end indices of a particular field of the date in the formatted string. 
Return Value 
A StringBuffer object appended with the formatted object provided. 
Example 


The following example formats a BigDecimal object and prints out the beginning and ending indices of the integer part of the 
BigDecimal object. This example uses the NumberFormat class, which is a specialization of the abstract Format class. 


// format_format_2.jsl 


import java.math.BigDecimal; 
import java.text.*; 


public class Program 
if 
public static void main(String[] args) 
si 
// Get a default NumberFormat instance. 
NumberFormat numForm = NumberFormat.getInstance(); 


// Format some decimals using the pattern supplied above. 
StringBuffer dest1 = new StringBuffer(24) ; 

StringBuffer dest2 = new StringBuffer(24) ; 

FieldPosition pos = new FieldPosition(NumberFormat.INTEGER_FIELD) ; 


BigDecimal bd1 = new BigDecimal(22.3423D); 

dest1 = numForm.format(bd1, dest1, pos); 

System.out.println("dest1 = " + dest1); 

System.out.println("INTEGER portion is at: " + pos.getBeginIndex() + 
", " + pos.getEndIndex()); 


BigDecimal bd2 = new BigDecimal(649@@D) ; 

dest2 = numForm.format(bd2, dest2, pos); 

System.out.println("dest2 = " + dest2); 

System.out.println("INTEGER portion is at: " + pos.getBeginIndex() + 
", " + pos.getEndIndex()); 


/* 

Output: 

dest1 = 22.342 

INTEGER portion is at: 9, 2 
dest2 = 64,000 

INTEGER portion is at: 0, 6 
*/ 











See Also 
Reference 
Format Class 
Concepts 

Format Members 
java.text Package 
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Format.parseObject Method 


Parses a string into an Object. 


Overload List 


Name eseription 


Format.parseObject (String) Parses a string into an Object. 





Format.parseObject (String, ParsePosition) Parses a string into an Object. 


See Also 
Reference 
Format Class 
Concepts 

Format Members 
java.text Package 
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Format.parseObject Method (String) 


Parses a string into an Object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object parseObject( 
java.lang.String sourceStr) throws java.text.ParseException; 


Parameters 
sourceStr 
The string to be parsed into an Object. 
Return Value 
An Object containing the date represented by the string. 
Example 
The following example parses a string into an Object and displays the result to the Console. This example uses the 


NumberFormat class, which is a specialization of the abstract Format class. 


// format_parseobject.jsl 
import java.text.*; 


public class Program 


{ 
public static void main(String[] args) 
ii 
try 
{ 
// Get a default NumberFormat instance. 
NumberFormat numForm = NumberFormat.getInstance(); 
// Parse the decimal string. 
Object o = numForm.parseObject("123456789.14"); 
System.out.println("Number = " + o.toString()); 
catch (ParseException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 
} 
/* 
Output: 
Number = 1.2345678914E8 
*/ 
See Also 
Reference 
Format Class 
Concepts 


Format Members 
java.text Package 
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Format.parseObject Method (String, ParsePosition) 


Parses a string into an Object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.Object parseObject( 
java.lang.String sourceStr, 
java.text.ParsePosition pos); 


Parameters 
sourceStr 


The string to be parsed into an Object. 
pos 
Used to indicate the first position in the string to be parsed. 
Return Value 
An Object containing the date represented by the string. 
Example 
The following example parses a string starting at position 8 into an Object and displays the result to the Console. This example 


uses the NumberFormat class, which is a specialization of the abstract Format class. 


// format_parseobject_2.jsl 
import java.text.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
// Get a default NumberFormat instance. 
NumberFormat numForm = NumberFormat.getInstance(); 
// Parse the decimal starting at position 8. 
ParsePosition pos = new ParsePosition(8); 
Object o = numForm.parseObject("123456789.14", pos); 
System.out.println("Number = " + o.toString()); 
} 
i 
/* 
Output: 
Number = 9.14 
7 
See Also 
Reference 
Format Class 
Concepts 


Format Members 
java.text Package 
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MessageFormat Class 


Contains methods and properties used to format a message as a string and to parse a string into a message. A message is 
simply a collection of objects that are formatted according to their type. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public class java.text.MessageFormat 
extends java.text.Format 


Example 


The following example shows how to perform common operations using a MessageFormat object, such as formatting, parsing, 
and applying a pattern and locale. 


// messageformat_overview.jsl 


import java.text.*; 
import java.util.Date; 


public class Program 


public static void main(String[] args) 
{ 
// Create a pattern for our MessageFormat object to use. 
String pattern = "I bought {@,number,#} " + 
"apples for {1,number,currency} " + 
"on {2,date,dd-MMM-yyyy}."; 


// Create a MessageFormat object and apply the pattern 
// to it. 
MessageFormat mFmt = new MessageFormat(pattern) ; 
mFmt.applyPattern(pattern) ; 
Object[] values = null; 
try 
{ 

values = mFmt.parse( 

"I bought 28 apples for $4.18 on 11-Nov-2004."); 

} 


catch (ParseException ex) 


{ 
} 


System.out.println(ex.toString()); 


// Print out the pattern being used for formatting 
// and the formatted output. 
System.out.println(mFmt.toPattern()); 
System.out.println(mFmt.format(values) ); 


} 


/* 

Output: 

I bought {@,number,#} apples for {1,number, currency} on {2,date,dd-MMM-yyyy}. 
I bought 2@ apples for $4.18 on 11-Nov-2004. 

=), 


Inheritance Hierarchy 
java.lang.Object 


java.text.Format 


java.text.MessageFormat 


See Also 

Concepts 

MessageFormat Members 
java.text Package 
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MessageFormat Members 


Contains methods and properties used to format a message as a string and to parse a string into a message. A message is 
simply a collection of objects that are formatted according to their type. 


The following tables list the members exposed by the MessageFormat type. 


Public Constructors 
Name Description 





MessageFormatinitializes a new instance of a MessageFormat object. The message will be formatted into a string using the pa 





Public Methods 
Name Description 





applyPattern|Changes the pattern that an instance of a MessageFormat object is using after it is created. 





equals Overridden. Determines whether two MessageFormat objects are equal. 





format Overloaded. Formats a message into a string. 





getFormats |Gets the array of Format objects that are used on variables in the pattern. 





hashCode __|Overridden. Serves as a hash function for a particular type, suitable for use in hashing algorithms and data struct 
ures like a hash table. 


getLocale _|Gets the Locale object that is being used to format and parse messages. 


getClass (inherited from Object ) 


clone Creates a shallow copy of the current MessageFormat object. 


parse Overloaded. Parses a string into an array of objects. 


parseObject |Overloaded. Parses a string into an object. 


setFormat |Sets the Format object to be used on a variable in the pattern. 


setFormats |Sets all the Format objects to be used on variables in a pattern. 


setLocale [Sets the Locale object that is being used to format and parse messages. 


toPattern __|Applies the previously set pattern to the string for an instance of a MessageFormat object. 


toString Displays a human-readable representation of a Format object. (inherited from Format) 





Protected Methods 


Name Description 


finalize (inherited from Object ) 








See Also 
Reference 


MessageFormat Class 





Concepts 
java.text Package 
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MessageFormat Constructor 


Initializes a new instance of a MessageFormat object. The message will be formatted into a string using the pattern provided. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.text.MessageFormat( 


java.lang.String pattern); 
| 


Parameters 
pattern 


The pattern describing how to format the message as a string. 


See Also 

Reference 
MessageFormat Class 
Concepts 

MessageFormat Members 
java.text Package 
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MessageFormat Methods 


Public Methods 





Name Description 





applyPattern|Changes the pattern that an instance of a MessageFormat object is using after it is created. 





equals Overridden. Determines whether two MessageFormat objects are equal. 





format Overloaded. Formats a message into a string. 





getFormats |Gets the array of Format objects that are used on variables in the pattern. 





hashCode __|Overridden. Serves as a hash function for a particular type, suitable for use in hashing algorithms and data struct 
ures like a hash table. 





getLocale _|Gets the Locale object that is being used to format and parse messages. 





getClass (inherited from Object ) 





clone Creates a shallow copy of the current MessageFormat object. 





parse Overloaded. Parses a string into an array of objects. 





parseObject |Overloaded. Parses a string into an object. 





setFormat |Sets the Format object to be used on a variable in the pattern. 





setFormats |Sets all the Format objects to be used on variables in a pattern. 





setLocale __|Sets the Locale object that is being used to format and parse messages. 





toPattern __|Applies the previously set pattern to the string for an instance of a MessageFormat object. 





toString Displays a human-readable representation of a Format object. (inherited from Format ) 





Protected Methods 


Name Description 


finalize (inherited from Object ) 








See Also 
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MessageFormat.applyPattern Method 


Changes the pattern that an instance of a MessageFormat object is using after it is created. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void applyPattern( 
java.lang.String newPattern) ; 


Parameters 
newPattern 


Specifies the style used to format to or parse from message strings. 
Example 


The following example shows how to apply a pattern to a MessageFormat object. 


// messageformat_applypattern.jsl 


import java.text.*; 
import java.util.Date; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Create a pattern for our MessageFormat object to use. 
String pattern = "I bought {@,number,#} " + 
"apples for {1,number,currency} " + 
"on {2,date,dd-MMM-yyyy}."; 


// Specify which formatters are to be used for each 
// of the placeholders in the pattern above. 
Format[] formats = { new DecimalFormat("#"), 
NumberFormat.getCurrencyInstance(), 
new SimpleDateFormat("MMM/dd/yyyy") }3 


// Create values to populate the position in the pattern. 
Object[] values = { new Integer(5), new Double(7.53), 
new Date("@4-Jul-2004") }; 


// Create a MessageFormat object and apply the pattern 
// to it. 

MessageFormat mFmt = new MessageFormat(pattern) ; 
mFmt.setFormats (formats) ; 

mFmt.applyPattern(pattern) ; 


// Print out the pattern being used for formatting 
// and the formatted output. 
System.out.println(mFmt.toPattern()); 
System.out.println(mFmt.format(values) ); 


} 


/* 

Output: 

I bought {@,number,#} apples for {1,number, currency} on {2,date,dd-MMM-yyyy}. 
I bought 5 apples for $7.53 on 04-Jul-2004. 

*/ 


See Also 
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MessageFormat.clone Method 


Creates a shallow copy of the current MessageFormat object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 





public java.lang.Object clone(); 





Return Value 
A shallow copy of the current MessageFormat object. 


See Also 
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MessageFormat Members 
java.text Package 


Visual J# Reference 


MessageFormat.equals Method 


Determines whether two MessageFormat objects are equal. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public boolean equals( 
java.lang.Object obj); 


Parameters 


obj 

A MessageFormat object to compare with the current MessageFormat object for equality. 
Return Value 
true if the two MessageFormat objects are equal; false otherwise. 


See Also 
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java.text Package 
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MessageFormat.format Method 


Formats a message into a string. 


Overload List 


Name Description 
MessageFormat.format (Object) Formats an object into a string. 
MessageFormat.format (String, Object[]) Formats a message, represented as an array of objects, into a stri 


ng using the given pattern. 





MessageFormat.format (Object, StringBuffer, FieldPosition) |Formats a message, represented as a single object, and appends i 
t to a StringBuffer object. 


MessageFormat.format (Object[], StringBuffer, FieldPosition)|Formats a message, represented as an array of objects, and appe 
nds it to a StringBuffer object. 
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MessageFormat.format Method (String, Object[ ]) 


Formats a message, represented as an array of objects, into a string using the given pattern. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.String format( 
java.lang.String pattern, 
java.lang.Object[] arguments) ; 


Parameters 
pattern 


Specifies the style used to format to or parse from message strings. 
arguments 
The objects to be formatted into a string. 
Return Value 
A string containing the formatted message. 
Example 


The following example shows how to display a formatted string using the MessageFormat object. 


// messageformat_format1.jsl 


import java.text.*; 
import java.util.Date; 


public class Program 


{ 


public static void main(String[] args) 


// Create a pattern for our MessageFormat object to use. 
String pattern = "I bought {@,number,#} " + 

"apples for {1,number,currency} " + 

"on {2,date,dd-MMM-yyyy}."; 


// Specify which formatters are to be used for each 
// of the placeholders in the pattern above. 
Format[] formats = { new DecimalFormat("#"), 
NumberFormat.getCurrencyInstance(), 
new SimpleDateFormat("MMM/dd/yyyy") }3 


// Create values to populate the position in the pattern. 
Object[] values = { new Integer(5), new Double(7.53), 
new Date("@4-Jul-2004") }; 


// Create a MessageFormat object and apply the pattern 
// to it. 

MessageFormat mFmt = new MessageFormat(pattern) ; 
mFmt.setFormats (formats) ; 


// Print out the pattern being used for formatting 
// and the formatted output. 
System.out.println(mFmt.toPattern()); 
System.out.println(mFmt.format(pattern, values) ); 


/* 


Output: 


I bought {@,number,#} apples for {1,number, currency} on {2,date,MMM/dd/yyyy}. 
I bought 5 apples for $7.53 on 04-Jul-2004. 
ef 
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MessageFormat.format Method (Object, StringBuffer, 
FieldPosition) 


Formats a message, represented as a single object, and appends it to a StringBuffer object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public final java.lang.StringBuffer format( 
java.lang.Object singleArg, 
java.lang.StringBuffer appendBuf, 
java.text.FieldPosition ignore); 


Parameters 
singleArg 


The object to be formatted into a string. 
appendBuf 
A StringBuffer object to be appended with the object formatted into a string. 
ignore 
Unused. 
Return Value 
A StringBuffer object appended with the object formatted into a string. 


See Also 
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MessageFormat.format Method (Object[ ], StringBuffer, 
FieldPosition) 


Formats a message, represented as an array of objects, and appends it to a StringBuffer object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public final java.lang.StringBuffer format( 
java.lang.Object[] arguments, 
java.lang.StringBuffer appendBuf, 
java.text.FieldPosition ignore); 


Parameters 
arguments 


The objects to be formatted into a string. 
appendBuf 

A StringBuffer object to be appended with the objects formatted into a string. 
ignore 

Unused. 
Return Value 
A StringBuffer object appended with the objects formatted into a string. 
Example 


The following example shows how to display a formatted string using the MessageFormat object. 


// messageformat_format3.jsl 


import java.text.*; 
import java.util.Date; 


public class Program 


public static void main(String[] args) 
{ 
// Create a pattern for our MessageFormat object to use. 
String pattern = "I bought {@,number,#} " + 
"apples for {1,number,currency} " + 
"on {2,date,dd-MMM-yyyy}."; 


// Specify which formatters are to be used for each 
// of the placeholders in the pattern above. 
Format[] formats = { new DecimalFormat("#"), 
NumberFormat. getCurrencyInstance(), 
new SimpleDateFormat("MMM/dd/yyyy") }3 


// Create values to populate the position in the pattern. 
Object[] values = { new Integer(5), new Double(7.53), 
new Date("04-Jul-2004") }; 


// Create a MessageFormat object and apply the pattern 
// to it. 

MessageFormat mFmt = new MessageFormat(pattern) ; 
mFmt.setFormats (formats) ; 


// Print out the pattern being used for formatting 


// and the formatted output. 
System.out.println(mFmt.toPattern()); 

StringBuffer buf = new StringBuffer(); 
System.out.println(mFmt.format(values, buf, null)); 


} 
} 
/* 
Output: 


I bought {@,number,#} apples for {1,number, currency} on {2,date,MMM/dd/yyyy}. 
I bought 5 apples for $7.53 on Jul/04/2004. 
*/ 
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MessageFormat.getFormats Method 


Gets the array of Format objects that are used on variables in the pattern. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.text.Format[] getFormats(); 


Return Value 
The array of Format objects that are used on variables in the pattern. 
Example 


The following example shows how to get the formatters that were used on a MessageFormat object. 


// messageformat_getformats.jsl 


import java.text.*; 
import java.util.Date; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Create a pattern for our MessageFormat object to use. 
String pattern = "I bought {@,number,#} " + 
"apples for {1,number,currency} " + 
"on {2,date,dd-MMM-yyyy}."; 


// Specify which formatters are to be used for each 
// of the placeholders in the pattern above. 
Format[] formats = { new DecimalFormat("#"), 
NumberFormat.getCurrencyInstance(), 
new SimpleDateFormat("MMM/dd/yyyy") }3 


// Create values to populate the position in the pattern. 
Object[] values = { new Integer(5), new Double(7.53), 
new Date("04-Jul-2004") }; 


// Create a MessageFormat object and apply the pattern 
// to it. 

MessageFormat mFmt = new MessageFormat(pattern) ; 
mFmt.setFormats (formats) ; 


// Print out the pattern being used for formatting 
// and the formatted output. 
System.out.println(mFmt.toPattern()); 
System.out.println(mFmt.format(pattern, values)); 
Format[] newFormats = mFmt.getFormats(); 

for (int i = @; i < newFormats.length; i++) 


{ 
} 


System.out.println(newFormats[i].toString()); 


} 


/* 

Output: 

I bought {@,number,#} apples for {1,number, currency} on {2,date,MMM/dd/yyyy}. 
I bought 5 apples for $7.53 on 04-Jul-2004. 

java.text.DecimalFormat@28d6c 

java.text.DecimalFormat@29380 


java.text.SimpleDateFormat@dca39d3c 
*/ 
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MessageFormat.hashCode Method 


Serves as a hash function for a particular type, suitable for use in hashing algorithms and data structures like a hash table. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public int hashCode(); 


Return Value 
A hash code for the current object. 


See Also 
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MessageFormat.getLocale Method 


Gets the Locale object that is being used to format and parse messages. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.util.Locale getLocale(); 


Return Value 
The Locale object that is being used to format and parse messages. 
Example 


The following example shows how to get the Locale that is being used to format and parse messages. 


// messageformat_getlocale.jsl 


import java.text.*; 
import java.util.Date; 


public class Program 


{ 


public static void main(String[] args) 
{ 
// Create a pattern for our MessageFormat object to use. 
String pattern = "I bought {@,number,#} " + 
"apples for {1,number,currency} " + 
"on {2,date,dd-MMM-yyyy}."; 


// Specify which formatters are to be used for each 
// of the placeholders in the pattern above. 
Format[] formats = { new DecimalFormat("#"), 
NumberFormat.getCurrencyInstance(), 
new SimpleDateFormat("MMM/dd/yyyy") }3 


// Create values to populate the position in the pattern. 
Object[] values = { new Integer(5), new Double(7.53), 
new Date("04-Jul-2004") }; 


// Create a MessageFormat object and apply the pattern 
// to it. 

MessageFormat mFmt = new MessageFormat(pattern) ; 
mFmt.setFormats (formats) ; 

mFmt.applyPattern(pattern) ; 


// Print out the pattern being used for formatting 
// and the formatted output. 
System.out.println(mFmt.toPattern()); 
System.out.printin(mFmt.format(values) ) ; 
System.out.println("Locale = " + mFmt.getLocale()); 


} 


/* 

Output: 

I bought {@,number,#} apples for {1,number, currency} on {2,date,dd-MMM-yyyy}. 
I bought 5 apples for $7.53 on 04-Jul-2004. 

Locale = en_US 


ee 


See Also 


Reference 
MessageFormat Class 
Concepts 

MessageFormat Members 
java.text Package 


Visual J# Reference 


MessageFormat.parse Method 


Parses a string into an array of objects. 


Overload List 


Name eseription 


MessageFormat.parse (String) Parses a string into an array of objects. 





MessageFormat.parse (String, ParsePosition) Parses a string into an array of objects. 


See Also 
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MessageFormat.parse Method (String) 


Parses a string into an array of objects. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object[] parse( 
java.lang.String sourceStr) throws java.text.ParseException; 


Parameters 
sourceStr 


The string to be parsed into an array of objects. 
Return Value 
The objects representing the various parts of the message string. 
Example 


The following example shows how to parse a string into an array of objects. 


// messageformat_parse1.jsl 


import java.text.*; 
import java.util.Date; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Create a pattern for our MessageFormat object to use. 
String pattern = "I bought {@,number,#} " + 
"apples for {1,number,currency} " + 
"on {2,date,dd-MMM-yyyy}."; 


// Create a MessageFormat object and apply the pattern 
// to it. 
MessageFormat mFmt = new MessageFormat (pattern) ; 
Object[] values = null; 
try 
{ 

values = mFmt.parse( 

"I bought 20 apples for $4.18 on 11-Nov-2004."); 


catch (ParseException ex) 


i 
} 


// Print out the pattern being used for formatting 
// and the formatted output. 
System.out.println(mFmt.toPattern()); 
System.out.println(mFmt.format(values) ); 


System.out.println(ex.toString()); 


} 


/* 

Output: 

I bought {@,number,#} apples for {1,number, currency} on {2,date,dd-MMM-yyyy}. 
I bought 2@ apples for $4.18 on 11-Nov-2004. 

*/ 


See Also 
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MessageFormat.parse Method (String, ParsePosition) 


Parses a string into an array of objects. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object[] parse( 
java.lang.String sourceStr, 
java.text.ParsePosition pos); 


Parameters 
sourceStr 


The string to be parsed into an array of objects. 
pos 

Used to indicate the first position in the string to be parsed. 
Return Value 
The objects representing the various parts of the message string. 
Example 


The following example shows how to parse a string into an array of objects. 


// messageformat_parse2.jsl 


import java.text.*; 
import java.util.Date; 


public class Program 


{ 


public static void main(String[] args) 


// Create a pattern for our MessageFormat object to use. 
String pattern = "I bought {@,number,#} " + 

"apples for {1,number,currency} " + 

"on {2,date,dd-MMM-yyyy}."; 


// Create a MessageFormat object and apply the pattern 
// to it. 
MessageFormat mFmt = new MessageFormat(pattern) ; 
Object[] values = mFmt.parse( 
"I bought 2@ apples for $4.18 on 11-Nov-2004.", 
new ParsePosition(@)); 


// Print out the pattern being used for formatting 
// and the formatted output. 
System.out.println(mFmt.toPattern()); 
System.out.printin(mFmt.format(values) ); 


} 


/* 

Output: 

I bought {@,number,#} apples for {1,number, currency} on {2,date,dd-MMM-yyyy}. 
I bought 2@ apples for $4.18 on 11-Nov-2004. 

*/ 


See Also 
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MessageFormat.parseObject Method 


Parses a string into an object. 


Overload List 


MessageFormat.parseObject (String) Parses a string into an Object. 





MessageFormat.parseObject (String, ParsePosition) Parses a string into an array of objects. 
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MessageFormat.parseObject Method (String, ParsePosition) 


Parses a string into an array of objects. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object parseObject( 
java.lang.String sourceStr, 
java.text.ParsePosition pos); 


Parameters 
sourceStr 


The string to be parsed into an object. 
pos 
Used to indicate the first position in the string to be parsed. 
Return Value 
An object representing the parsed message string. 
Example 


The following example shows how to parse a string into an array of objects. 


// messageformat_parseobject.jsl 


import java.text.*; 
import java.util.Date; 


public class Program 


{ 


public static void main(String[] args) 


// Create a pattern for our MessageFormat object to use. 
String pattern = "I bought {@,number,#} " + 

"apples for {1,number,currency} " + 

"on {2,date,dd-MMM-yyyy}."; 


// Create a MessageFormat object and apply the pattern 
// to it. 
MessageFormat mFmt = new MessageFormat (pattern) ; 
Object value = mFmt.parseObject( 
"I bought 2@ apples for $4.18 on 11-Nov-2004.", 
new ParsePosition(@)); 


// Print out the pattern being used for formatting 
// and the formatted output. 
System.out.println(mFmt.toPattern()); 
System.out.println(mFmt. format (value) ) ; 


} 


/* 

Output: 

I bought {@,number,#} apples for {1,number, currency} on {2,date,dd-MMM-yyyy}. 
I bought 2@ apples for $4.18 on 11-Nov-2004. 

*/ 


See Also 
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MessageFormat.setFormat Method 


Sets the Format object to be used on a variable in the pattern. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setFormat( 
int variableNum, 
java.text.Format newFormat) ; 


Parameters 
variableNum 


The index within the pattern that this Format object applies to. 
newFormat 

The Format object to be used on a variable in the pattern. 
Example 


The following example shows how to set the Format object to use for a position in the MessageFormat object. 


// messageformat_setformat.jsl 


import java.text.*; 
import java.util.Date; 


public class Program 


public static void main(String[] args) 
{ 
// Create a pattern for our MessageFormat object to use. 
String pattern = "I bought {@,number,#} " + 
"apples for {1,number,currency} " + 
"on {2,date,dd-MMM-yyyy}."; 


// Specify which formatters are to be used for each 
// of the placeholders in the pattern above. 
Format[] formats = { new DecimalFormat("#"), 
NumberFormat.getCurrencyInstance(), 
new SimpleDateFormat("MMM/dd/yyyy") }3 


// Create values to populate the position in the pattern. 
Object[] values = { new Integer(5), new Double(7.53), 
new Date("@4-Jul-2004") }; 


// Create a MessageFormat object and apply the pattern 
// to it. 

MessageFormat mFmt = new MessageFormat(pattern) ; 
mFmt.setFormat(@, formats[@]); 

mFmt.setFormat(1, formats[1]); 

mFmt.setFormat(2, formats[2]); 


// Print out the pattern being used for formatting 
// and the formatted output. 
System.out.println(mFmt.toPattern()); 
System.out.println(mFmt.format(pattern, values)); 


Output: 


I bought {@,number,#} apples for {1,number, currency} on {2,date,MMM/dd/yyyy}. 
I bought 5 apples for $7.53 on 04-Jul-2004. 
ah 
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MessageFormat.setFormats Method 


Sets all the Format objects to be used on variables in a pattern. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setFormats( 
java.text.Format[] newFormats); 


Parameters 
newFormats 


An array of Format objects to be used on variables in the pattern. 
Example 


The following example shows how to set the Format objects to use for all positions in the MessageFormat object. 


// messageformat_setformats.jsl 


import java.text.*; 
import java.util.Date; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Create a pattern for our MessageFormat object to use. 
String pattern = "I bought {@,number,#} " + 
"apples for {1,number,currency} " + 
"on {2,date,dd-MMM-yyyy}."; 


// Specify which formatters are to be used for each 
// of the placeholders in the pattern above. 
Format[] formats = { new DecimalFormat("#"), 
NumberFormat.getCurrencyInstance(), 
new SimpleDateFormat("MMM/dd/yyyy") }3 


// Create values to populate the position in the pattern. 
Object[] values = { new Integer(5), new Double(7.53), 
new Date("@4-Jul-2004") }; 


// Create a MessageFormat object and apply the pattern 
// to it. 

MessageFormat mFmt = new MessageFormat(pattern) ; 
mFmt.setFormats (formats) ; 


// Print out the pattern being used for formatting 
// and the formatted output. 
System.out.println(mFmt.toPattern()); 
System.out.println(mFmt.format(pattern, values)); 


} 


/* 

Output: 

I bought {@,number,#} apples for {1,number, currency} on {2,date,MMM/dd/yyyy}. 
I bought 5 apples for $7.53 on 04-Jul-2004. 

a7 
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MessageFormat.setLocale Method 


Sets the Locale object that is being used to format and parse messages. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setLocale( 
java.util.Locale loc); 


Parameters 
loc 


The Locale object that is being used to format and parse messages. 
Example 


The following example shows how to change the default locale used for formatting and parsing MessageFormat objects. 


// messageformat_setlocale.jsl 


import java.text.*; 
import java.util.Date; 
import java.util.Locale; 


public class Program 


{ 


public static void main(String[] args) 
{ 
// Create a pattern for our MessageFormat object to use. 
String pattern = "I bought {@,number,#} " + 
"apples for {1,number,currency} " + 
"on {2,date,dd-MMM-yyyy}."; 


// Specify which formatters are to be used for each 
// of the placeholders in the pattern above. 
Format[] formats = { new DecimalFormat("#"), 
NumberFormat.getCurrencyInstance(), 
new SimpleDateFormat("MMM/dd/yyyy") }3 


// Create values to populate the position in the pattern. 
Object[] values = { new Integer(5), new Double(7.53), 
new Date("@4-Jul-2004") }; 


// Create a MessageFormat object and apply the pattern 
// to it. 

MessageFormat mFmt = new MessageFormat(pattern) ; 
mFmt.setFormats(formats) ; 

mFmt.applyPattern(pattern) ; 
mFmt.setLocale(Locale.GERMANY) ; 


// Print out the pattern being used for formatting 
// and the formatted output. 
System.out.println(mFmt.toPattern()); 
System.out.println(mFmt.format(values) ); 
System.out.println("Locale = " + mFmt.getLocale()); 


} 


/* 

Output: 

I bought {@,number,#} apples for {1,number, currency} on {2,date,dd-MMM-yyyy}. 
I bought 5 apples for 7,53a,- on 04-Jul-200 

Locale = de_ DE 


a 
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MessageFormat.toPattern Method 


Applies the previously set pattern to the string for an instance of a MessageFormat object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toPattern(); 


Return Value 
The string representation of the objects comprising the message formatted using the previously set pattern. 
Example 


The following example shows how to display the pattern being used to format MessageFormat objects. 


// messageformat_topattern.jsl 


import java.text.*; 
import java.util.Date; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Create a pattern for our MessageFormat object to use. 
String pattern = "I bought {@,number,#} " + 
"apples for {1,number,currency} " + 
"on {2,date,dd-MMM-yyyy}."; 


// Specify which formatters are to be used for each 
// of the placeholders in the pattern above. 
Format[] formats = { new DecimalFormat("#"), 
NumberFormat.getCurrencyInstance(), 
new SimpleDateFormat("MMM/dd/yyyy") }3 


// Create values to populate the position in the pattern. 
Object[] values = { new Integer(5), new Double(7.53), 
new Date("04-Jul-2004") }; 


// Create a MessageFormat object and apply the pattern 
// to it. 

MessageFormat mFmt = new MessageFormat(pattern) ; 
mFmt.setFormats (formats) ; 


// Print out the pattern being used for formatting 
// and the formatted output. 
System.out.println(mFmt.toPattern()); 
System.out.println(mFmt.format(pattern, values) ); 


/* 

Output: 

I bought {@,number,#} apples for {1,number, currency} on {2,date,MMM/dd/yyyy}. 
I bought 5 apples for $7.53 on 04-Jul-2004. 

*/ 


See Also 
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NumberFormat Class 


Contains methods and properties used to format a number as a string and to parse a string into a number. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public abstract class java.text.NumberFormat 
extends java.text.Format 
implements java.lang.Cloneable 


Example 


The following example demonstrates the format, FRACTION_FIELD, getInstance, INTEGER_FIELD, and parse methods of the 
NumberFormat class. 


// numberformat_overview. jsl 
import java.text.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
try 
{ 
// Get a default NumberFormat instance. 
NumberFormat numForm = NumberFormat.getInstance(); 


// Format some decimals using the pattern supplied above. 
StringBuffer dest1 = new StringBuffer(24) ; 

StringBuffer dest2 = new StringBuffer(24) ; 

FieldPosition posi = new FieldPosition(NumberFormat.INTEGER_FIELD) ; 
FieldPosition pos2 = new FieldPosition(NumberFormat.FRACTION_FIELD) ; 


dest1 = numForm.format(22.3423D, dest1, posi); 
System.out.println("dest1 = " + dest1); 
System.out.println("INTEGER is at: " + posi1.getBeginIndex() + 


F + pos1.getEndIndex()); 


dest2 = numForm.format(6400@D, dest2, pos2); 

System.out.println("dest2 = " + dest2); 

System.out.println("FRACTION is at: " + pos2.getBeginIndex() + 
", " + pos2.getEndIndex()); 


// Parse a decimal value. 
Number n = numForm.parse("123456789.14") ; 
System.out.println("Number = " + n); 


} 


catch (ParseException ex) 


{ 
} 


System.out.println(ex.toString()); 


} 


/* 

Output: 

dest1 = 22.342 

INTEGER is at: 9, 2 
dest2 = 64,000 

FRACTION is at: 6, 6 
Number = 1.2345678914E8 


ie 





Inheritance Hierarchy 
java.lang.Object 
java.text.Format 
java.text.NumberFormat 
java.text.ChoiceFormat 
java.text.DecimalFormat 


See Also 

Concepts 

NumberFormat Members 
java.text Package 


Visual J# Reference 


NumberFormat Members 


Contains methods and properties used to format a number as a string and to parse a string into a number. 


The following tables list the members exposed by the NumberFormat type. 


Public Fields 





Name 


Description 





FRACTION_FIELD 


A value used to refer to the fractional portion of a number. 





INTEGER_FIELD 





A value used to refer to the integer portion of a number. 





Public Methods 
Name 


Description 





equals 


Overridden. Determines whether two NumberFormat objects are equal. 





format 


Overloaded. Formats a number into a string. 





getAvailableLocales 


Gets an array of all Locale objects that are supported by the NumberFormat class. 





getCurrencylnstance 


hashCode 


Overloaded. Creates an instance of a NumberFormat object that can be used to format and parse c 
urrency values. 


Overridden. Serves as a hash function for a particular type, suitable for use in hashing algorithms a 
nd data structures like a hash table. 





getinstance 


Overloaded. Creates an instance of a NumberFormat object and sets the pattern to the default patt 
ern for numbers. 


getMaximumFractionDigits|Gets a value representing the maximum number of digits displayed in the fractional part of the nu 


mber. 





getMinimumFractionDigits 


getMaximumIntegerDigits |Gets a value representing the maximum number of digits displayed in the integer part of the num 


ber. 


Gets a value representing the minimum number of digits displayed in the fractional part of the nu 
mber. 





getNumberlInstance 


getMinimumIntegerDigits 


Gets a value representing the minimum number of digits displayed in the integer part of the numb 
er. 


Overloaded. Creates an instance of a NumberFormat object and sets the pattern to the default patt 
ern for numbers. 





getPercentInstance 


Overloaded. Creates an instance of a NumberFormat object and sets the pattern to the one used to 
format and parse percentage values. 





getClass 


(inherited from Object ) 





isGroupingUsed 


Determines whether digits are being grouped together. 





isParselntegerOnly 





Determines whether only the integer portion of the number is being parsed or if the fractional part 
is also included. 











clone 


parse 


parseObject 


setGroupingUsed 


setMaximumF ractionDigits 


Creates a shallow copy of the current NumberFormat object. 


Overloaded. Parses a string into a number. 


Overloaded. Parses a string into an Object. 


Sets a value determining whether digits are being grouped together. 


Sets the value representing the maximum number of digits displayed in the fractional part of the n 
umber. 





setMaximumIntegerDigits 


setMinimumFractionDigits 


setMinimumIntegerDigits 


Sets the value representing the maximum number of digits displayed in the integer part of the nu 
mber. 


Sets the value representing the minimum number of digits displayed in the fractional part of the n 
umber. 


Sets the value representing the minimum number of digits displayed in the integer part of the nu 
mber. 





setParselntegerOnly 


toString 


Protected Methods 


Sets a value determining whether only the integer portion of the number is being parsed or if the f 
ractional part is also included. 


Displays a human-readable representation of a Format object. (inherited from Format) 





Name 


Description 





finalize 





(inherited from Object ) 








See Also 

Reference 
NumberFormat Class 
Concepts 

java.text Package 
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NumberFormat Fields 


Public Fields 





Name Description 





FRACTION_FIELD A value used to refer to the fractional portion of a number. 





INTEGER_FIELD A value used to refer to the integer portion of a number. 











See Also 

Reference 
NumberFormat Class 
Concepts 

java.text Package 
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NumberFormat.FRACTION FIELD Field 


A value used to refer to the fractional portion of a number. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final int FRACTION FIELD; 


Example 


The following example shows how to format a number and display the indices of the fractional part of the number. 


// numberformat_fraction_field.jsl 
import java.text.*; 


public class Program 


{ 


public static void main(String[] args) 

{ 
// Get a default NumberFormat instance. 
NumberFormat numForm = NumberFormat.getInstance(); 


// Format some decimals using the pattern supplied above. 
StringBuffer dest1 = new StringBuffer(24) ; 

StringBuffer dest2 = new StringBuffer(24) ; 

FieldPosition pos = new FieldPosition(NumberFormat. FRACTION FIELD) ; 


dest1 = numForm. format(22.3423D, dest1, pos); 
System.out.println("dest1 = " + dest1); 
System.out.println("FRACTION is at: " + pos.getBeginIndex() + 


» " + pos.getEndIndex()); 


dest2 = numForm.format(6400@D, dest2, pos); 
System.out.println("dest2 = " + dest2); 
System.out.println("FRACTION is at: " + pos.getBeginIndex() + 


» " + pos.getEndIndex()); 


} 


/* 

Output: 

dest1 = 22.342 
FRACTION is at: 3, 6 
dest2 = 64,000 
FRACTION is at: 6, 6 
ae A 


See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 
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NumberFormat.INTEGER_FIELD Field 


A value used to refer to the integer portion of a number. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final int INTEGER_FIELD; 


Example 


The following example shows how to format a number and display the indices of the integer part of the number. 


// numberformat_integer_field.jsl 
import java.text.*; 


public class Program 
4 
public static void main(String[] args) 
{ 
// Get a default NumberFormat instance. 
NumberFormat numForm = NumberFormat.getInstance(); 


// Format some decimals using the pattern supplied above. 
StringBuffer dest1 = new StringBuffer(24) ; 

StringBuffer dest2 = new StringBuffer(24) ; 

FieldPosition pos = new FieldPosition(NumberFormat.INTEGER_FIELD) ; 


dest1 = numForm.format(22.3423D, dest1, pos); 
System.out.println("dest1 = " + dest1); 
System.out.println("INTEGER is at: " + pos.getBeginIndex() + 


, " + pos.getEndIndex()); 


dest2 = numForm.format(6400@D, dest2, pos); 
System.out.println("dest2 = " + dest2); 
System.out.println("INTEGER is at: " + pos.getBeginIndex() + 


, " + pos.getEndIndex()); 


} 


/* 

Output: 

dest1 = 22.342 
INTEGER is at: 9, 2 
dest2 = 64,000 
INTEGER is at: 0, 6 
*/ 


See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 
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NumberFormat Methods 


Public Methods 





Name 


Description 





equals 


Overridden. Determines whether two NumberFormat objects are equal. 





format 


Overloaded. Formats a number into a string. 





getAvailableLocales 


Gets an array of all Locale objects that are supported by the NumberFormat class. 





getCurrencylnstance 


hashCode 


getinstance 


Overloaded. Creates an instance of a NumberFormat object that can be used to format and parse c 
urrency values. 


Overridden. Serves as a hash function for a particular type, suitable for use in hashing algorithms a 
nd data structures like a hash table. 


Overloaded. Creates an instance of a NumberFormat object and sets the pattern to the default patt 
ern for numbers. 





getMaximumFractionDigits|Gets a value representing the maximum number of digits displayed in the fractional part of the nu 


mber. 


getMaximumIntegerDigits |Gets a value representing the maximum number of digits displayed in the integer part of the num 


ber. 





getMinimumFractionDigits 


getMinimumIntegerDigits 


Gets a value representing the minimum number of digits displayed in the fractional part of the nu 
mber. 


Gets a value representing the minimum number of digits displayed in the integer part of the numb 
er. 





getNumberlInstance 


getPercentInstance 


Overloaded. Creates an instance of a NumberFormat object and sets the pattern to the default patt 
ern for numbers. 


Overloaded. Creates an instance of a NumberFormat object and sets the pattern to the one used to 
format and parse percentage values. 





getClass 


(inherited from Object ) 





isGroupingUsed 


Determines whether digits are being grouped together. 





isParselntegerOnly 


Determines whether only the integer portion of the number is being parsed or if the fractional part 
is also included. 








clone Creates a shallow copy of the current NumberFormat object. 
parse Overloaded. Parses a string into a number. 
parseObject Overloaded. Parses a string into an Object. 





setGroupingUsed 





Sets a value determining whether digits are being grouped together. 











setMaximumFractionDigits |Sets the value representing the maximum number of digits displayed in the fractional part of the n 


Sets the value representing the maximum number of digits displayed in the integer part of the nu 
mber. 


setMaximumI|ntegerDigits 





Sets the value representing the minimum number of digits displayed in the fractional part of the n 
umber. 


setMinimumFractionDigits 


Sets the value representing the minimum number of digits displayed in the integer part of the nu 
mber. 


setMinimumI|ntegerDigits 





Sets a value determining whether only the integer portion of the number is being parsed or if the f 
ractional part is also included. 


setParselntegerOnly 





toString Displays a human-readable representation of a Format object. (inherited from Format ) 





Protected Methods 


Name Description 


finalize (inherited from Object ) 








See Also 

Reference 
NumberFormat Class 
Concepts 

java.text Package 
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NumberFormat.clone Method 


Creates a shallow copy of the current NumberFormat object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 





public java.lang.Object clone(); 





Return Value 
A shallow copy of the current NumberFormat object. 


See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 
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NumberFormat.equals Method 


Determines whether two NumberFormat objects are equal. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public boolean equals( 
java.lang.Object obj); 


Parameters 


obj 

A NumberFormat object to compare with the current NumberFormat object for equality. 
Return Value 
true if the two NumberFormat objects are equal; false otherwise. 


See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 
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NumberFormat.format Method 


Formats a number into a string. 


Overload List 
Name 


NumberFormat.format (double) 
NumberFormat.format (long) 
NumberFormat.format (Object) 


NumberFormat.format (double, StringBuffer, FieldPosition) 


Description 


Formats a double into a string. 


Formats a long into a string. 


Formats an object into a string. 


Formats a double and appends it to a StringBuffer object. 





NumberFormat.format (long, StringBuffer, FieldPosition) 


Formats a long and appends it to a StringBuffer object. 





NumberFormat.format (Object, StringBuffer, FieldPosition) 








Formats an Object and appends it to a StringBuffer object. 





See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 
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NumberFormat.format Method (Double) 


Formats a double into a string. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public final java.lang.String format( 
double number) ; 


Parameters 
number 

The double to be formatted into a string. 
Return Value 
A string containing the value of the double. 
Example 


The following example formats a decimal value. 


// numberformat_format.jsl 
import java.text.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Get a default NumberFormat instance. 
NumberFormat numForm = NumberFormat.getInstance(); 
// Format some decimals using the pattern supplied above. 
String dest1 = numForm.format(22.3423D) ; 
System.out.println("dest1 = " + dest1); 
String dest2 = numForm. format (64@@@D) ; 
System.out.println("dest2 = " + dest2); 
} 
} 
/* 
Output: 


dest1 = 22.342 
dest2 = 64,000 
me) 


See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 
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NumberFormat.format Method (Int64) 


Formats a long into a string. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public final java.lang.String format( 
long number); 


Parameters 
number 

The long to be formatted into a string. 
Return Value 
A string containing the value of the long. 
Example 


The following example formats a long as a decimal. 


// numberformat_format_2.jsl 
import java.text.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Get a default NumberFormat instance. 
NumberFormat numForm = NumberFormat.getInstance(); 
// Format some longs using the pattern supplied above. 
String dest1 = numForm. format (223423L) ; 
System.out.println("dest1 = " + dest1); 
String dest2 = numForm. format (64@@@L) ; 
System.out.println("dest2 = " + dest2); 
} 
} 
/* 
Output: 


dest1 = 223,423 
dest2 = 64,000 
me) 


See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 
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NumberFormat.format Method (Double, StringBuffer, 
FieldPosition) 


Formats a double and appends it to a StringBuffer object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.StringBuffer format( 
double number, 
java.lang.StringBuffer appendBuffer, 
java.text.FieldPosition pos); 


Parameters 
number 


The double to be formatted into a string. 
appendBuffer 
A StringBuffer object to be appended with the double formatted into a string. 
pos 
Used to find start and end indices of a particular field of the number in the formatted string. 
Return Value 
A StringBuffer object appended with the double formatted into a string. 
Example 
The following example formats a decimal value and prints out the beginning and ending indices of the fraction part of the 


decimal. 


// numberformat_format_3.jsl 
import java.text.*; 


public class Program 


{ 


public static void main(String[] args) 

{ 
// Get a default NumberFormat instance. 
NumberFormat numForm = NumberFormat.getInstance(); 


// Format some decimals using the pattern supplied above. 
StringBuffer dest1 = new StringBuffer(24) ; 

StringBuffer dest2 = new StringBuffer(24) ; 

FieldPosition pos = new FieldPosition(NumberFormat.FRACTION_FIELD) ; 


dest1 = numForm. format(22.3423D, dest1, pos); 
System.out.println("dest1 = " + dest1); 
System.out.println("FRACTION is at: " + pos.getBeginIndex() + 


, " + pos.getEndIndex()); 


dest2 = numForm.format(6400@D, dest2, pos); 

System.out.println("dest2 = " + dest2); 

System.out.println("FRACTION is at: " + pos.getBeginIndex() + 
", " + pos.getEndIndex()); 


/* 


Output: 

dest1 = 22.342 
FRACTION is at: 3, 6 
dest2 = 64,000 
FRACTION is at: 6, 6 
*/ 





See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 
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NumberFormat.format Method (Int64, StringBuffer, 
FieldPosition) 


Formats a long and appends it to a StringBuffer object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.StringBuffer format( 
long number, 
java.lang.StringBuffer appendBuf, 
java.text.FieldPosition pos); 


Parameters 
number 


The long to be formatted into a string. 
appendBuf 
A StringBuffer object to be appended with the long formatted into a string. 
pos 
Used to find start and end indices of a particular field of the number in the formatted string. 
Return Value 
A StringBuffer object appended with the long formatted into a string. 
Example 


The following example formats a long value and prints out the beginning and ending indices of the integer part of the long. 


// numberformat_format_4.jsl 
import java.text.*; 


public class Program 


{ 


public static void main(String[] args) 

{ 
// Get a default NumberFormat instance. 
NumberFormat numForm = NumberFormat.getInstance(); 


// Format some longs using the pattern supplied above. 
StringBuffer dest1 = new StringBuffer(24) ; 

StringBuffer dest2 = new StringBuffer(24) ; 

FieldPosition pos = new FieldPosition(NumberFormat.INTEGER_FIELD) ; 


dest1 = numForm.format(223423L, dest1, pos); 
System.out.println("dest1 = " + dest1); 
System.out.println("INTEGER portion is at: 


, " + pos.getEndIndex()); 


+ pos.getBeginIndex() + 


dest2 = numForm.format(640@@L, dest2, pos); 

System.out.println("dest2 = " + dest2); 

System.out.println("INTEGER portion is at: 
", " + pos.getEndIndex()); 


+ pos.getBeginIndex() + 


Output: 


dest1 = 223,423 

INTEGER portion is at: @, 7 
dest2 = 64,000 

INTEGER portion is at: 0, 6 
ye 





See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 


Visual J# Reference 


NumberFormat.format Method (Object, StringBuffer, 
FieldPosition) 


Formats an Object and appends it to a StringBuffer object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public final java.lang.StringBuffer format( 
java.lang.Object number, 
java.lang.StringBuffer appendBuf, 
java.text.FieldPosition pos); 


Parameters 
number 


The Object to be formatted into a string. 
appendBuf 
A StringBuffer object to be appended with the Object formatted into a string. 
pos 
Used to find start and end indices of a particular field of the number in the formatted string. 
Return Value 
A StringBuffer object appended with the Object formatted into a string. 
Example 


The following example formats a java.lang.BigDecimal object and prints out the beginning and ending indices of the integer 
part of the BigDecimal object. 


// numberformat_format_5.jsl 


import java.math.BigDecimal; 
import java.text.*; 


public class Program 


{ 


public static void main(String[] args) 

{ 
// Get a default NumberFormat instance. 
NumberFormat numForm = NumberFormat.getInstance(); 


// Format some decimals using the pattern supplied above. 
StringBuffer dest1 = new StringBuffer(24) ; 

StringBuffer dest2 = new StringBuffer(24) ; 

FieldPosition pos = new FieldPosition(NumberFormat.INTEGER_FIELD) ; 


BigDecimal bd1 = new BigDecimal(22.3423D); 

dest1 = numForm.format(bd1, dest1, pos); 

System.out.println("dest1 = " + dest1); 

System.out.println("INTEGER portion is at: " + pos.getBeginIndex() + 
", " + pos.getEndIndex()); 


BigDecimal bd2 = new BigDecimal(64@@@D) ; 
dest2 = numForm.format(bd2, dest2, pos); 
System.out.println("dest2 = " + dest2); 
System.out.println("INTEGER portion is at: " + pos.getBeginIndex() + 


» " + pos.getEndIndex()); 


} 


/* 

Output: 

dest1 = 22.342 

INTEGER portion is at: 9, 2 
dest2 = 64,000 

INTEGER portion is at: 0, 6 
*/ 











See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 
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NumberFormat.getAvailableLocales Method 


Gets an array of all Locale objects that are supported by the NumberFormat class. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static java.util.Locale[] getAvailableLocales(); 


Return Value 
An array of all the Locale objects that are available. 


See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 


Visual J# Reference 


NumberFormat.getCurrencylnstance Method 


Creates an instance of a NumberFormat object that can be used to format and parse currency values. 


Overload List 
Name Description 


NumberFormat.getCurrencylnstance () Creates an instance of a NumberFormat object that can be used to format and p 
arse currency values. 





NumberFormat.getCurrencylnstance (Locale)|Creates an instance of a NumberFormat object that can be used to format and p 
arse currency values for the given locale. 








See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 
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NumberFormat.getCurrencylnstance Method () 


Creates an instance of a NumberFormat object that can be used to format and parse currency values. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final java.text.NumberFormat getCurrencyInstance(); 


Return Value 
An instance of a NumberFormat object that has the pattern set to the one used to format and parse currency values. 
Example 
The following example gets a default instance of a NumberFormat object appropriate for storing currency values. 
// numberformat_getcurrencyinstance.jsl 
import java.text.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Get a default NumberFormat instance. 
NumberFormat numForm = NumberFormat.getCurrencyInstance(); 
// Format some decimals using the pattern supplied above. 
String dest1 = numForm. format (22.3423D) ; 
System.out.println("dest1 = " + dest1); 
String dest2 = numForm. format (64@@@D) ; 
System.out.println("dest2 = " + dest2); 
} 
; 
/* 
Output: 


dest1 = $22.34 
dest2 = $64,000.00 
*/ 


See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 
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NumberFormat.getCurrencyInstance Method (Locale) 


Creates an instance of a NumberFormat object that can be used to format and parse currency values for the given locale. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static java.text.NumberFormat getCurrencyInstance( 
java.util.Locale loc); 


Parameters 
loc 


A Locale object containing the locale that will be used to format and parse the currency value. 
Return Value 


An instance of a NumberFormat object that has the pattern set to the one used to format and parse currency values for the 
given locale. 


Example 


The following example gets a default instance of a NumberFormat object appropriate for storing currency values using the 
en_CA (Canada) locale. 


// numberformat_getcurrencyinstance_2.jsl 


import java.text.*; 
import java.util.Locale; 


public class Program 


{ 


public static void main(String[] args) 


{ 


// Get a default NumberFormat instance using the 
// en_CA locale. 
Locale caLoc = new Locale("en", "CA"); 
NumberFormat numForm = 

NumberFormat. getCurrencyInstance(caLoc); 


// Format some decimals using the pattern supplied above. 
String dest1 = numForm. format (22.3423D) ; 
System.out.println("dest1 = " + dest1); 


String dest2 = numForm. format (64@@@D) ; 
System.out.println("dest2 = " + dest2); 


dest1 = $22.34 
dest2 = $64,000.00 
ef 


See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 
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NumberFormat.hashCode Method 


Serves as a hash function for a particular type, suitable for use in hashing algorithms and data structures like a hash table. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public int hashCode(); 


Return Value 
A hash code for the current object. 


See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 
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NumberFormat.getInstance Method 


Creates an instance of a NumberFormat object and sets the pattern to the default pattern for numbers. 


Overload List 


Name Description 


NumberFormat.getinstance () Creates an instance of a NumberFormat object and sets the pattern to the default pattern 


for numbers. 








NumberFormat.getinstance (Locale)|Creates an instance of a NumberFormat object and sets the pattern to the default pattern 
for numbers for the given locale. 








See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 
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NumberFormat.getInstance Method () 


Creates an instance of a NumberFormat object and sets the pattern to the default pattern for numbers. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final java.text.NumberFormat getInstance(); 


Return Value 
An instance of a NumberFormat object that has the pattern set to the default pattern for numbers. 
Example 


The following example gets a default instance of a NumberFormat object appropriate for storing numbers. 


// numberformat_getinstance.jsl 
import java.text.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Get a default NumberFormat instance. 
NumberFormat numForm = NumberFormat.getInstance(); 
// Format some decimals using the pattern supplied above. 
String dest1 = numForm. format (22.3423D) ; 
System.out.println("dest1 = " + dest1); 
String dest2 = numForm. format (64@@@D) ; 
System.out.println("dest2 = " + dest2); 
} 
; 
/* 
Output: 


dest1 = 22.342 
dest2 = 64,000 
*/ 


See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 
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NumberFormat.getInstance Method (Locale) 


Creates an instance of a NumberFormat object and sets the pattern to the default pattern for numbers for the given locale. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static java.text.NumberFormat getInstance( 
java.util.Locale loc); 


Parameters 
loc 


A Locale object containing the locale that will be used to format and parse numbers. 
Return Value 
An instance of a NumberFormat object that has the pattern set to the default pattern for numbers in the given locale. 
Example 


The following example gets a default instance of a NumberFormat object appropriate for storing numbers using the de_DE 
(Germany) locale. 


// numberformat_getinstance_2.jsl 


import java.text.*; 
import java.util.Locale; 


public class Program 


{ 


public static void main(String[] args) 


A 


// Get a default NumberFormat instance using the 

// de_DE locale. 

Locale deLoc = new Locale("de", "DE"); 

NumberFormat numForm = NumberFormat.getInstance(deLoc) ; 


// Format some decimals using the pattern supplied above. 
String dest1 = numForm. format (22.3423D) ; 
System.out.println("dest1 = " + dest1); 


String dest2 = numForm. format (64@@@D) ; 
System.out.println("dest2 = " + dest2); 


dest1 = 22,342 
dest2 = 64.000 
7. 


See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 
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NumberFormat.getMaximumFractionDigits Method 


Gets a value representing the maximum number of digits displayed in the fractional part of the number. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public int getMaximumFractionDigits(); 


Return Value 
A value representing the maximum number of digits displayed in the fractional part of the number. 
Example 


The following example displays the various properties of the NumberFormat object, including the maximum fraction digits. 


// numberformat_getmaximumfractiondigits.jsl 
import java.text.*; 


public class Program 
{ 
public static void main(String[] args) 
if 
// Get a default NumberFormat instance. 
NumberFormat numForm = NumberFormat.getInstance(); 


// Display the various properties of the NumberFormat 
// class. 
System.out.println("Maximum Fraction Digits: " + 
numForm. getMaximumFractionDigits()); 
System.out.println("Maximum Integer Digits: " + 
numForm. getMaximumIntegerDigits()); 
System.out.println("Minimum Fraction Digits: " + 
numForm. getMinimumFractionDigits()); 
System.out.println( "Minimum Integer Digits: " + 
numForm. getMinimumIntegerDigits()); 
System.out.println("Is Grouping Used? " + 
numForm. isGroupingUsed()); 
System.out.printlin("Is Parse Integer Only? " + 
numForm.isParseIntegerOnly()); 


} 


/* 

Output: 

Maximum Fraction Digits: 3 
Maximum Integer Digits: 127 
Minimum Fraction Digits: @ 
Minimum Integer Digits: 1 

Is Grouping Used? true 

Is Parse Integer Only? false 
*/ 


See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 


Visual J# Reference 


NumberFormat.getMaximumIntegerDigits Method 


Gets a value representing the maximum number of digits displayed in the integer part of the number. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public int getMaximumIntegerDigits(); 


Return Value 
A value representing the maximum number of digits displayed in the integer part of the number. 
Example 


The following example displays the various properties of the NumberFormat object, including the maximum integer digits. 


// numberformat_getmaximumintegerdigits.jsl 
import java.text.*; 


public class Program 
{ 
public static void main(String[] args) 
if 
// Get a default NumberFormat instance. 
NumberFormat numForm = NumberFormat.getInstance(); 


// Display the various properties of the NumberFormat 
// class. 
System.out.println("Maximum Fraction Digits: " + 
numForm. getMaximumFractionDigits()); 
System.out.println("Maximum Integer Digits: " + 
numForm. getMaximumIntegerDigits()); 
System.out.println("Minimum Fraction Digits: " + 
numForm. getMinimumFractionDigits()); 
System.out.println( "Minimum Integer Digits: " + 
numForm. getMinimumIntegerDigits()); 
System.out.println("Is Grouping Used? " + 
numForm. isGroupingUsed()); 
System.out.printlin("Is Parse Integer Only? " + 
numForm.isParseIntegerOnly()); 


} 


/* 

Output: 

Maximum Fraction Digits: 3 
Maximum Integer Digits: 127 
Minimum Fraction Digits: @ 
Minimum Integer Digits: 1 

Is Grouping Used? true 

Is Parse Integer Only? false 
*/ 


See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 


Visual J# Reference 


NumberFormat.getMinimumFractionDigits Method 


Gets a value representing the minimum number of digits displayed in the fractional part of the number. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public int getMinimumFractionDigits(); 


Return Value 
A value representing the minimum number of digits displayed in the fractional part of the number. 
Example 


The following example displays the various properties of the NumberFormat object, including the minimum fraction digits. 


// numberformat_getminimumfractiondigits.jsl 
import java.text.*; 


public class Program 
{ 
public static void main(String[] args) 
if 
// Get a default NumberFormat instance. 
NumberFormat numForm = NumberFormat.getInstance(); 


// Display the various properties of the NumberFormat 
// class. 
System.out.println("Maximum Fraction Digits: " + 
numForm. getMaximumFractionDigits()); 
System.out.println("Maximum Integer Digits: " + 
numForm. getMaximumIntegerDigits()); 
System.out.println("Minimum Fraction Digits: " + 
numForm. getMinimumFractionDigits()); 
System.out.println( "Minimum Integer Digits: " + 
numForm. getMinimumIntegerDigits()); 
System.out.println("Is Grouping Used? " + 
numForm. isGroupingUsed()); 
System.out.printlin("Is Parse Integer Only? " + 
numForm.isParseIntegerOnly()); 


} 


/* 

Output: 

Maximum Fraction Digits: 3 
Maximum Integer Digits: 127 
Minimum Fraction Digits: @ 
Minimum Integer Digits: 1 

Is Grouping Used? true 

Is Parse Integer Only? false 
*/ 


See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 


Visual J# Reference 


NumberFormat.getMinimumlIntegerDigits Method 


Gets a value representing the minimum number of digits displayed in the integer part of the number. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public int getMinimumIntegerDigits(); 


Return Value 
A value representing the minimum number of digits displayed in the integer part of the number. 
Example 


The following example displays the various properties of the NumberFormat object, including the minimum integer digits. 


// numberformat_getminimumintegerdigits.jsl 
import java.text.*; 


public class Program 
{ 
public static void main(String[] args) 
if 
// Get a default NumberFormat instance. 
NumberFormat numForm = NumberFormat.getInstance(); 


// Display the various properties of the NumberFormat 
// class. 
System.out.println("Maximum Fraction Digits: " + 
numForm. getMaximumFractionDigits()); 
System.out.println("Maximum Integer Digits: " + 
numForm. getMaximumIntegerDigits()); 
System.out.println("Minimum Fraction Digits: " + 
numForm. getMinimumFractionDigits()); 
System.out.println( "Minimum Integer Digits: " + 
numForm. getMinimumIntegerDigits()); 
System.out.println("Is Grouping Used? " + 
numForm. isGroupingUsed()); 
System.out.printlin("Is Parse Integer Only? " + 
numForm.isParseIntegerOnly()); 


} 


/* 

Output: 

Maximum Fraction Digits: 3 
Maximum Integer Digits: 127 
Minimum Fraction Digits: @ 
Minimum Integer Digits: 1 

Is Grouping Used? true 

Is Parse Integer Only? false 
*/ 


See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 


Visual J# Reference 


NumberFormat.getNumberlInstance Method 


Creates an instance of a NumberFormat object and sets the pattern to the default pattern for numbers. 


Overload List 


Name Description 







NumberFormat.getNumberInstance () Creates an instance of a NumberFormat object and sets the pattern to the default 


pattern for numbers. 





NumberFormat.getNumberInstance (Locale)|Creates an instance of a NumberFormat object and sets the pattern to the default 
pattern for numbers for the given locale. 








See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 





Visual J# Reference 


NumberFormat.getNumberInstance Method () 


Creates an instance of a NumberFormat object and sets the pattern to the default pattern for numbers. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final java.text.NumberFormat getNumberInstance(); 


Return Value 


An instance of a NumberFormat object that has the pattern set to the default pattern for numbers. 


Example 


The following example gets a default instance of a NumberFormat object appropriate for storing numbers. 


// numberformat_getnumberinstance.jsl 


import java.text.*; 


public class Program 


{ 


public static void main(String[] args) 


A 


} 


/* 
Output: 
dest1 = 
dest2 = 
*/ 


See Also 
Reference 


// Get a default NumberFormat instance. 
NumberFormat numForm = 
NumberFormat. getNumberInstance() ; 


// Format some decimals using the pattern supplied above. 
String dest1 = numForm. format(22.3423D) ; 


System.out.println("dest1 = " + dest1); 
String dest2 = numForm. format (640@@D) ; 
System.out.println("dest2 = " + dest2); 
22.342 
64,000 


NumberFormat Class 


Concepts 


NumberFormat Members 
java.text Package 


Visual J# Reference 


NumberFormat.getNumberInstance Method (Locale) 


Creates an instance of a NumberFormat object and sets the pattern to the default pattern for numbers for the given locale. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static java.text.NumberFormat getNumberInstance( 
java.util.Locale loc); 


Parameters 
loc 


A Locale object containing the locale that will be used to format and parse numbers. 
Return Value 
An instance of a NumberFormat object that has the pattern set to the default pattern for numbers in the given locale. 
Example 


The following example gets a default instance of a NumberFormat object appropriate for storing numbers using the th_TH 
(Thailand) locale. 


// numberformat_getnumberinstance_2.jsl 


import java.text.*; 
import java.util.Locale; 


public class Program 


{ 


public static void main(String[] args) 


A 


// Get a default NumberFormat instance using the 
// th_TH locale. 
Locale thLoc = new Locale("th", "TH"); 
NumberFormat numForm = 

NumberFormat. getNumberInstance(thLoc) ; 


// Format some decimals using the pattern supplied above. 
String dest1 = numForm. format (22.3423D) ; 
System.out.println("dest1 = " + dest1); 


String dest2 = numForm. format (64@@@D) ; 
System.out.println("dest2 = " + dest2); 


dest1 = 22.342 
dest2 = 64,000 


See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 


Visual J# Reference 


NumberFormat.getPercentIinstance Method 


Creates an instance of a NumberFormat object and sets the pattern to the one used to format and parse percentage values. 


Overload List 


Name Description 


NumberFormat.getPercentlInstance () Creates an instance of a NumberFormat object and sets the pattern to the one use 


d to format and parse percentage values. 








NumberFormat.getPercentInstance (Locale)|Creates an instance of a NumberFormat object and sets the pattern to the one use 
d to format and parse percentage values in the given locale. 





See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 





Visual J# Reference 


NumberFormat.getPercentInstance Method () 


Creates an instance of a NumberFormat object and sets the pattern to the one used to format and parse percentage values. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static final java.text.NumberFormat getPercentInstance(); 


Return Value 
An instance of a NumberFormat object that has the pattern set to the one used to format and parse percentage values. 
Example 


The following example gets a default instance of a NumberFormat object appropriate for storing percentages. 


// numberformat_getpercentinstance.jsl 
import java.text.*; 


public class Program 


{ 


public static void main(String[] args) 


A 


// Get a default NumberFormat instance. 
NumberFormat numForm = 
NumberFormat.getPercentInstance() ; 


// Format some decimals using the pattern supplied above. 
String dest1 = numForm. format (22.3423D) ; 
System.out.println("dest1 = " + dest1); 


String dest2 = numForm. format (640@@D) ; 
System.out.println("dest2 = " + dest2); 


dest1l = 2,234.23% 
dest2 = 6,400, 000% 
*/ 


See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 


Visual J# Reference 


NumberFormat.getPercentInstance Method (Locale) 


Creates an instance of a NumberFormat object and sets the pattern to the one used to format and parse percentage values in 
the given locale. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public static java.text.NumberFormat getPercentInstance( 
java.util.Locale loc); 


Parameters 
loc 


A Locale object containing the locale that will be used to format and parse the percentage value. 
Return Value 


An instance of a NumberFormat object that has the pattern set to the one used to format and parse percentage values in the 
given locale. 


Example 


The following example gets a default instance of a NumberFormat object appropriate for storing percentages using the es_ES 
(Spain) locale. 


// numberformat_getpercentinstance_2.jsl 


import java.text.*; 
import java.util.Locale; 


public class Program 


{ 


public static void main(String[] args) 


{ 


// Get a default NumberFormat instance using the 

// es_ES locale. 

Locale esLoc = new Locale("es", "ES"); 

NumberFormat numForm = 
NumberFormat.getPercentInstance(esLoc); 


// Format some decimals using the pattern supplied above. 
String dest1 = numForm.format(22.3423D) ; 
System.out.println("dest1 = " + dest1); 


String dest2 = numForm. format (64@@@D) ; 
System.out.println("dest2 = " + dest2); 


dest1 = 2.234,23% 
dest2 = 6.400.000% 
*/ 


See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 


Visual J# Reference 


NumberFormat.isGroupingUsed Method 


Determines whether digits are being grouped together. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public boolean isGroupingUsed(); 


Return Value 
true if digits are being grouped together; false otherwise. 
Example 


The following example displays the various properties of the NumberFormat object, including the flag that determines if 
grouping is used. 


// numberformat_isgroupingused.jsl 
import java.text.*; 


public class Program 


{ 


public static void main(String[] args) 

{ 
// Get a default NumberFormat instance. 
NumberFormat numForm = NumberFormat.getInstance(); 


// Display the various properties of the NumberFormat 
// class. 
System.out.println( "Maximum Fraction Digits: " + 
numForm. getMaximumFractionDigits()); 
System.out.println( "Maximum Integer Digits: " + 
numForm. getMaximumIntegerDigits()); 
System.out.println("Minimum Fraction Digits: " + 
numForm. getMinimumFractionDigits()); 
System.out.println("Minimum Integer Digits: " + 
numForm. getMinimumIntegerDigits()); 
System.out.println("Is Grouping Used? " + 
numForm. isGroupingUsed()); 
System.out.println("Is Parse Integer Only? " + 
numForm.isParseIntegerOnly()); 


i 


/* 

Output: 

Maximum Fraction Digits: 3 
Maximum Integer Digits: 127 
Minimum Fraction Digits: @ 
Minimum Integer Digits: 1 

Is Grouping Used? true 

Is Parse Integer Only? false 
ai 


See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 


Visual J# Reference 


NumberFormat.isParselntegerOnly Method 


Determines whether only the integer portion of the number is being parsed or if the fractional part is also included. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public boolean isParseIntegerOnly(); 


Return Value 
true if only the integer portion of the number is being parsed; false otherwise. 
Example 


The following example displays the various properties of the NumberFormat object, including the flag that determines if only 
the integer portion is to be parsed. 


// numberformat_isparseintegeronly.jsl 
import java.text.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Get a default NumberFormat instance. 
NumberFormat numForm = NumberFormat.getInstance(); 


// Display the various properties of the NumberFormat 
// class. 
System.out.println( "Maximum Fraction Digits: " + 
numForm. getMaximumFractionDigits()); 
System.out.println( "Maximum Integer Digits: " + 
numForm. getMaximumIntegerDigits()); 
System.out.println("Minimum Fraction Digits: " + 
numForm. getMinimumFractionDigits()); 
System.out.println("Minimum Integer Digits: " + 
numForm. getMinimumIntegerDigits()); 
System.out.println("Is Grouping Used? " + 
numForm. isGroupingUsed()); 
System.out.println("Is Parse Integer Only? " + 
numForm.isParseIntegerOnly()); 


i 


/* 

Output: 

Maximum Fraction Digits: 3 
Maximum Integer Digits: 127 
Minimum Fraction Digits: @ 
Minimum Integer Digits: 1 

Is Grouping Used? true 

Is Parse Integer Only? false 
ai 


See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 


Visual J# Reference 


NumberFormat.parse Method 


Parses a string into a number. 


Overload List 


Name Description 


NumberFormat.parse (String) Parses a string into a number represented by a Number object. 





NumberFormat.parse (String, ParsePosition) Parses a string into a number represented by a Number object. 


See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 


Visual J# Reference 


NumberFormat.parse Method (String) 


Parses a string into a number represented by a Number object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Number parse( 
java.lang.String sourceStr) throws java.text.ParseException; 


Parameters 
sourceStr 
The string to be parsed into a number represented by a Number object. 
Return Value 
A Number object containing the number parsed from the string. 
Example 


The following example shows how to create a Number object using a string representation of a decimal. 


// numberformat_parse.jsl 
import java.text.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
try 
{ 
// Get a default NumberFormat instance. 
NumberFormat numForm = NumberFormat.getInstance(); 
// Parse a decimal value. 
Number n = numForm.parse("123456789.14") ; 
System.out.println("Number = " + n); 
} 
catch (ParseException ex) 
{ 
System.out.printin(ex.toString()); 
} 
} 
} 
/* 
Output: 
Number = 1.2345678914E8 
ef 
See Also 
Reference 
NumberFormat Class 
Concepts 


NumberFormat Members 
java.text Package 


Visual J# Reference 


NumberFormat.parse Method (String, ParsePosition) 


Parses a string into a number represented by a Number object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.Number parse( 
java.lang.String sourceStr, 
java.text.ParsePosition pos); 


Parameters 
sourceStr 


The string to be parsed into a number represented by a Number object. 
pos 
Used to indicate the first position in the string to be parsed. 
Return Value 
A Number object containing the number parsed from the string. 
Example 


The following example parses a string starting at position 8 into a number and displays the result to the Console. 


// numberformat_parse_2.jsl 
import java.text.*; 


public class Program 
{ 
public static void main(String[] args) 
i 
// Get a default NumberFormat instance. 
NumberFormat numForm = NumberFormat.getInstance(); 


// Parse the decimal starting at position 8. 

ParsePosition pos = new ParsePosition(8); 

Number n = numForm.parse("123456789.14", pos); 

System.out.println("Number = " + n); 

System.out.println("Position after parse = " + 
pos.getIndex()); 


/* 

Output: 

Number = 9.14 

Position after parse = 12 


Hs 


See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 


Visual J# Reference 


NumberFormat.parseObject Method 


Parses a string into an Object. 


Overload List 


NumberFormat.parseObject (String) Parses a string into an Object. 





NumberFormat.parseObject (String, ParsePosition) Parses a string into an Object. 


See Also 

Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 


Visual J# Reference 


NumberFormat.parseObject Method (String, ParsePosition) 


Parses a string into an Object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public final java.lang.Object parseObject( 
java.lang.String sourceStr, 
java.text.ParsePosition pos); 


Parameters 
sourceStr 

The string to be parsed into an Object. 
pos 

Used to indicate the first position in the string to be parsed. 
Return Value 
An Object containing the number represented by the string. 
Example 


The following example parses a string starting at position 8 into an Object and displays the result to the Console. 


// numberformat_parseobject.jsl 
import java.text.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
// Get a default NumberFormat instance. 
NumberFormat numForm = NumberFormat.getInstance(); 
// Parse the decimal starting at position 8. 
ParsePosition pos = new ParsePosition(8); 
Object o = numForm.parseObject("123456789.14", pos); 
System.out.println("Number = " + o.toString()); 
t 
ti 
/* 
Output: 
Number = 9.14 
*/ 
See Also 
Reference 
NumberFormat Class 
Concepts 


NumberFormat Members 
java.text Package 


Visual J# Reference 


NumberFormat.setGroupingUsed Method 


Sets a value determining whether digits are being grouped together. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setGroupingUsed( 
boolean newValue) ; 


Parameters 
newValue 


true to group the digits together; false otherwise. 


Example 


The following example sets the grouping flag to false. 


// numberformat_setgroupingused.jsl 


import java.text.*; 


public class Program 


{ 


public static void main(String[] args) 


{ 


} 


/* 

Output: 
Maximum 
Maximum 
Minimum 
Minimum 


// Get a default NumberFormat instance. 
NumberFormat numForm = NumberFormat.getInstance(); 


// Set the grouping flag to false. 
numForm. setGroupingUsed(false) ; 


// Display the various properties of the NumberFormat 
// class. 
System.out.println("Maximum Fraction Digits: " + 
numForm. getMaximumFractionDigits()); 
System.out.println( "Maximum Integer Digits: " + 
numForm. getMaximumIntegerDigits()); 
System.out.printin("Minimum Fraction Digits: " + 
numForm. getMinimumFractionDigits()); 
System.out.println("Minimum Integer Digits: " + 
numForm. getMinimumIntegerDigits()); 
System.out.println("Is Grouping Used? " + 
numForm. isGroupingUsed()); 
System.out.printlin("Is Parse Integer Only? " + 
numForm.isParseIntegerOnly()); 


Fraction Digits: 3 
Integer Digits: 127 
Fraction Digits: @ 
Integer Digits: 1 


Is Grouping Used? false 
Is Parse Integer Only? false 


od, 


See Also 
Reference 


NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 


Visual J# Reference 


NumberFormat.setMaximumFractionDigits Method 


Sets the value representing the maximum number of digits displayed in the fractional part of the number. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setMaximumFractionDigits( 
int maxFractionDigits); 


Parameters 
maxFractionDigits 


The maximum number of digits to be displayed in the fractional part of the number. 
Example 


The following example sets the value for the maximum fraction digits to 10. 


// numberformat_setmaximumfractiondigits.jsl 
import java.text.*; 


public class Program 


{ 


public static void main(String[] args) 

{ 
// Get a default NumberFormat instance. 
NumberFormat numForm = NumberFormat.getInstance(); 


// Set the maximum fraction digits to 10. 
numForm. setMaximumFractionDigits (10) ; 


// Display the various properties of the NumberFormat 
// class. 
System.out.println( "Maximum Fraction Digits: " + 
numForm. getMaximumFractionDigits()); 
System.out.println( "Maximum Integer Digits: " + 
numForm. getMaximumIntegerDigits()); 
System.out.printin("Minimum Fraction Digits: " + 
numForm. getMinimumFractionDigits()); 
System.out.println("Minimum Integer Digits: " + 
numForm. getMinimumIntegerDigits()); 
System.out.println("Is Grouping Used? " + 
numForm. isGroupingUsed()); 
System.out.printlin("Is Parse Integer Only? " + 
numForm.isParseIntegerOnly()); 


} 


/* 

Output: 

Maximum Fraction Digits: 10 
Maximum Integer Digits: 127 
Minimum Fraction Digits: @ 
Minimum Integer Digits: 1 

Is Grouping Used? true 

Is Parse Integer Only? false 
uA 


See Also 
Reference 


NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 


Visual J# Reference 


NumberFormat.setMaximumlIntegerDigits Method 


Sets the value representing the maximum number of digits displayed in the integer part of the number. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setMaximumIntegerDigits( 
int maxIntegerDigits); 


Parameters 
maxintegerDigits 


The maximum number of digits to be displayed in the integer part of the number. 
Example 


The following example sets the value for the maximum integer digits to 10. 


// numberformat_setmaximumintegerdigits.jsl 
import java.text.*; 


public class Program 


{ 


public static void main(String[] args) 

{ 
// Get a default NumberFormat instance. 
NumberFormat numForm = NumberFormat.getInstance(); 


// Set the maximum integer digits to 10. 
numForm. setMaximumIntegerDigits (10) ; 


// Display the various properties of the NumberFormat 
// class. 
System.out.println("Maximum Fraction Digits: " + 
numForm. getMaximumFractionDigits()); 
System.out.println( "Maximum Integer Digits: " + 
numForm. getMaximumIntegerDigits()); 
System.out.printin("Minimum Fraction Digits: " + 
numForm. getMinimumFractionDigits()); 
System.out.println("Minimum Integer Digits: " + 
numForm. getMinimumIntegerDigits()); 
System.out.println("Is Grouping Used? " + 
numForm. isGroupingUsed()); 
System.out.printlin("Is Parse Integer Only? " + 
numForm.isParseIntegerOnly()); 


} 


/* 

Output: 

Maximum Fraction Digits: 3 
Maximum Integer Digits: 10 
Minimum Fraction Digits: @ 
Minimum Integer Digits: 1 

Is Grouping Used? true 

Is Parse Integer Only? false 
uA 


See Also 
Reference 


NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 


Visual J# Reference 


NumberFormat.setMinimumFractionDigits Method 


Sets the value representing the minimum number of digits displayed in the fractional part of the number. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setMinimumFractionDigits( 
int minFractionDigits); 


Parameters 
minFractionDigits 


The minimum number of digits to be displayed in the fractional part of the number. 
Example 


The following example sets the value for the minimum fraction digits to 10 


// numberformat_setminimumfractiondigits.jsl 
import java.text.*; 


public class Program 


{ 


public static void main(String[] args) 

{ 
// Get a default NumberFormat instance. 
NumberFormat numForm = NumberFormat.getInstance(); 


// Set the minimum fraction digits to 10. 
numForm. setMinimumFractionDigits (10) ; 


// Display the various properties of the NumberFormat 
// class. 
System.out.println( "Maximum Fraction Digits: " + 
numForm. getMaximumFractionDigits()); 
System.out.println( "Maximum Integer Digits: " + 
numForm. getMaximumIntegerDigits()); 
System.out.printin("Minimum Fraction Digits: " + 
numForm. getMinimumFractionDigits()); 
System.out.println("Minimum Integer Digits: " + 
numForm. getMinimumIntegerDigits()); 
System.out.println("Is Grouping Used? " + 
numForm. isGroupingUsed()); 
System.out.printlin("Is Parse Integer Only? " + 
numForm.isParseIntegerOnly()); 


} 


/* 

Output: 

Maximum Fraction Digits: 10 

Maximum Integer Digits: 127 

Minimum Fraction Digits: 10 

Minimum Integer Digits: 1 

Is Grouping Used? true 

Is Parse Integer Only? false 
uA 


See Also 
Reference 


NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 


Visual J# Reference 


NumberFormat.setMinimumIntegerDigits Method 


Sets the value representing the minimum number of digits displayed in the integer part of the number. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setMinimumIntegerDigits( 
int minIntegerDigits); 


Parameters 
minintegerDigits 


The minimum number of digits to be displayed in the integer part of the number. 
Example 


The following example sets the value for the minimum integer digits to 10. 


// numberformat_setminimumintegerdigits.jsl 
import java.text.*; 


public class Program 


{ 


public static void main(String[] args) 

{ 
// Get a default NumberFormat instance. 
NumberFormat numForm = NumberFormat.getInstance(); 


// Set the minimum integer digits to 10. 
numForm. setMinimumIntegerDigits(10) ; 


// Display the various properties of the NumberFormat 
// class. 
System.out.println("Maximum Fraction Digits: " + 
numForm. getMaximumFractionDigits()); 
System.out.println( "Maximum Integer Digits: " + 
numForm. getMaximumIntegerDigits()); 
System.out.printin("Minimum Fraction Digits: " + 
numForm. getMinimumFractionDigits()); 
System.out.println("Minimum Integer Digits: " + 
numForm. getMinimumIntegerDigits()); 
System.out.println("Is Grouping Used? " + 
numForm. isGroupingUsed()); 
System.out.printlin("Is Parse Integer Only? " + 
numForm.isParseIntegerOnly()); 


} 


/* 

Output: 

Maximum Fraction Digits: 3 
Maximum Integer Digits: 127 
Minimum Fraction Digits: @ 
Minimum Integer Digits: 10 
Is Grouping Used? true 

Is Parse Integer Only? false 
uA 


See Also 
Reference 


NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 
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NumberFormat.setParselntegerOnly Method 


Sets a value determining whether only the integer portion of the number is being parsed or if the fractional part is also 
included. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setParseIntegerOnly( 
boolean value); 


Parameters 
value 


true to parse only the integer portion of the number; false otherwise. 
Example 


The following example sets the parse integer only flag to true. 


// numberformat_setparseintegeronly.jsl 
import java.text.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Get a default NumberFormat instance. 
NumberFormat numForm = NumberFormat.getInstance(); 


// Set the parse integer only flag to true. 
numForm. setParseIntegerOnly(true) ; 


// Display the various properties of the NumberFormat 
// class. 
System.out.println("Maximum Fraction Digits: " + 
numForm. getMaximumFractionDigits()); 
System.out.println( "Maximum Integer Digits: " + 
numForm. getMaximumIntegerDigits()); 
System.out.println("Minimum Fraction Digits: " + 
numForm. getMinimumFractionDigits()); 
System.out.println("Minimum Integer Digits: " + 
numForm. getMinimumIntegerDigits()); 
System.out.println("Is Grouping Used? " + 
numForm. isGroupingUsed()); 
System.out.println("Is Parse Integer Only? " + 
numForm.isParseIntegerOnly()); 


} 


/* 

Output: 

Maximum Fraction Digits: 3 
Maximum Integer Digits: 127 
Minimum Fraction Digits: @ 
Minimum Integer Digits: 1 
Is Grouping Used? true 

Is Parse Integer Only? true 


*f 


See Also 


Reference 
NumberFormat Class 
Concepts 

NumberFormat Members 
java.text Package 


Visual J# Reference 


ParseException Class 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public class java.text.ParseException 
extends java.lang.Exception 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.text.ParseException 


See Also 

Concepts 

ParseException Members 
java.text Package 


Visual J# Reference 


ParseException Members 


The following tables list the members exposed by the ParseException type. 


Public Constructors 
Name 


ParseException 





Public Properties (see also Protected Properties ) 











Name Description 

HelpLink (inherited from Exception ) 
InnerException (inherited from Exception ) 
Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 


Protected Properties 





Name Description 





HResult (inherited from Exception ) 








Public Methods 











Name Description 

equals (inherited from Object ) 
filllnStackTrace (inherited from Throwable ) 
GetBaseException (inherited from Exception ) 
getErrorOffset 

hashCode (inherited from Object ) 
getLocalizedMessage (inherited from Throwable ) 
getMessage (inherited from Throwable ) 
GetObjectData Overridden. 

getClass (inherited from Object ) 
clone (inherited from Throwable ) 








printStackTrace Overloaded. (inherited from Throwable ) 











toString 


(inherited from Throwable ) 





Protected Methods 
Name 


finalize 





See Also 
Reference 
ParseException Class 
Concepts 

java.text Package 





(inherited from Object ) 
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ParseException Constructor 


Overload List 





Name 


Description 





ParseException (SerializationInfo, StreamingContext) 





ParseException (String, Exception) 





ParseException (String, int) 





ParseException (String, int, Exception) 








See Also 

Reference 
ParseException Class 
Concepts 

ParseException Members 
java.text Package 
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ParseException Constructor (SerializationInfo, 
StreamingContext) 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


protected java.text.ParseException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


context 


See Also 

Reference 
ParseException Class 
Concepts 

ParseException Members 
java.text Package 
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ParseException Constructor (String, Exception) 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.text.ParseException( 
java.lang.String msg, 
System.Exception inner); 


Parameters 
msg 


inner 


See Also 

Reference 
ParseException Class 
Concepts 

ParseException Members 
java.text Package 
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ParseException Constructor (String, Int32) 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.text.ParseException( 
java.lang.String msg, 
int errorOffset) ; 


Parameters 
msg 


errorOffset 


See Also 

Reference 
ParseException Class 
Concepts 

ParseException Members 
java.text Package 
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ParseException Constructor (String, Int32, Exception) 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.text.ParseException( 
java.lang.String msg, 
int errorOffset, 
System.Exception inner); 


Parameters 
msg 


errorOffset 
inner 


See Also 

Reference 
ParseException Class 
Concepts 

ParseException Members 
java.text Package 
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ParseException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





getErrorOffset 





hashCode 


getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 


Protected Methods 


(inherited from Object ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


Overridden. 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


ParseException Class 
Concepts 
java.text Package 
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ParseException.getErrorOffset Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public int getErrorOffset(); 


See Also 

Reference 
ParseException Class 
Concepts 

ParseException Members 
java.text Package 
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ParseException.GetObjectData Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void GetObjectData( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


context 


See Also 

Reference 
ParseException Class 
Concepts 

ParseException Members 
java.text Package 
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ParseException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 
ParseException Class 
Concepts 

java.text Package 
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ParsePosition Class 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public class java.text.ParsePosition 
extends java.lang.Object 





Inheritance Hierarchy 
java.lang.Object 
java.text.ParsePosition 


See Also 

Concepts 

ParsePosition Members 
java.text Package 
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ParsePosition Members 


The following tables list the members exposed by the ParsePosition type. 


Public Constructors 
Name 


ParsePosition 


Public Methods 








Name 


Description 








Protected Methods 





equals (inherited from Object ) 
hashCode (inherited from Object ) 
getIndex 

getClass (inherited from Object ) 
setindex 

toString Overridden. 





Name 


Description 





finalize 


(inherited from Object ) 





MemberwiseClone 





Performs a shallow copy of the object. 





See Also 
Reference 
ParsePosition Class 
Concepts 

java.text Package 
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ParsePosition Constructor 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.text.ParsePosition( 


int index); 





Parameters 
index 


See Also 

Reference 
ParsePosition Class 
Concepts 

ParsePosition Members 
java.text Package 
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ParsePosition Methods 


Public Methods 























Protected Methods 





Name Description 

equals (inherited from Object ) 
hashCode (inherited from Object ) 
getindex 

getClass (inherited from Object ) 
setindex 

toString Overridden. 





Name 


Description 





finalize 


(inherited from Object ) 





MemberwiseClone 





Performs a shallow copy of the object. 





See Also 
Reference 
ParsePosition Class 
Concepts 

java.text Package 
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ParsePosition.getIndex Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public int getIndex(); 


See Also 

Reference 
ParsePosition Class 
Concepts 

ParsePosition Members 
java.text Package 
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ParsePosition.setIndex Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setIndex( 
int index); 


Parameters 
index 


See Also 

Reference 
ParsePosition Class 
Concepts 

ParsePosition Members 
java.text Package 
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RuleBasedCollator Class 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public class java.text.RuleBasedCollator 
extends java.text.Collator 





Inheritance Hierarchy 

java.lang.Object 
java.text.Collator 
java.text.RuleBasedCollator 


See Also 

Concepts 

RuleBasedCollator Members 
java.text Package 
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RuleBasedCollator Members 


The following tables list the members exposed by the RuleBasedCollator type. 


Public Methods 


Name 


compare 


equals 


equals 


getCollationKey 


Description 


Overridden. 


Determines whether two strings are equal. (inherited from Collator) 


Overridden. 


Overridden. 





getDecomposition 


Gets the decomposition type being used for collation. (inherited from Collator) 














hashCode Overridden. 

getStrength Gets the strength type being used for collation. (inherited from Collator) 
getClass (inherited from Object) 

clone 





setDecomposition 


Sets the decomposition type being used for collation. (inherited from Collator) 





setStrength 


Sets the strength type being used for collation. (inherited from Collator) 





toString 





Displays a human-readable representation of a Collator object. (inherited from Collator) 





Name 


finalize 





See Also 
Reference 


Protected Methods 


(inherited from Object) 





RuleBasedCollator Class 


Concepts 
java.text Package 
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RuleBasedCollator Methods 


Public Methods 

















Name Description 
compare Overridden. 
equals Determines whether two strings are equal. (inherited from Collator) 
equals Overridden. 
getCollationKey Overridden. 





getDecomposition _|Gets the decomposition type being used for collation. (inherited from Collator) 


hashCode Overridden. 

getStrength Gets the strength type being used for collation. (inherited from Collator) 
getClass (inherited from Object) 

clone 


setDecomposition Sets the decomposition type being used for collation. (inherited from Collator) 
setStrength Sets the strength type being used for collation. (inherited from Collator) 


toString Displays a human-readable representation of a Collator object. (inherited from Collator) 





Protected Methods 





Name Description 





finalize (inherited from Object) 














See Also 

Reference 
RuleBasedCollator Class 
Concepts 

java.text Package 
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RuleBasedCollator.clone Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object clone(); 


See Also 

Reference 
RuleBasedCollator Class 
Concepts 

RuleBasedCollator Members 
java.text Package 
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RuleBasedCollator.compare Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public int compare( 
java.lang.String source, 
java.lang.String target); 


Parameters 
source 


target 


See Also 

Reference 
RuleBasedCollator Class 
Concepts 

RuleBasedCollator Members 
java.text Package 
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RuleBasedCollator.equals Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public boolean equals( 
java.lang.Object obj); 


Parameters 


obj 


See Also 

Reference 
RuleBasedCollator Class 
Concepts 

RuleBasedCollator Members 
java.text Package 
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RuleBasedCollator.getCollationKey Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.text.CollationKey getCollationKey( 
java.lang.String source); 


Parameters 
source 


See Also 

Reference 
RuleBasedCollator Class 
Concepts 

RuleBasedCollator Members 
java.text Package 
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RuleBasedCollator.hashCode Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public int hashCode(); 


See Also 

Reference 
RuleBasedCollator Class 
Concepts 

RuleBasedCollator Members 
java.text Package 
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SimpleDateFormat Class 


Contains methods and properties used to format a Date object as a string and to parse a string into a Date object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public class java.text.SimpleDateFormat 
extends java.text.DateFormat 


Example 


The following example demonstrates some common uses of the SimpleDateFormat class, such as formatting a date, parsing a 
date, and setting a pattern. 


// simpledateformat_overview. jsl 


import java.text.*; 
import java.util.Date; 


public class Program 


{ 


public static void main(String[] args) 


{ 
// Create a SimpleDateFormat object. 


String pattern = "dd-MMM-yyyy HH:mm:ss.SSS"; 
SimpleDateFormat sdf = new SimpleDateFormat() ; 
sdf.applyPattern(pattern) ; 


// Parse a sample date starting at position @. 
String sampleDateStr = "@4-Jul-1776 22:00:00.000"; 
ParsePosition pos = new ParsePosition(@); 

Date sampleDate = sdf.parse(sampleDateStr, pos); 


// Print out the date using the supplied pattern. 

System.out.println("The pattern being used is " + 
sdf.toPattern()); 

System.out.println("A sample date looks like " + 


sdf.format(sampleDate) ); 


} 


/* 

Sample output: 

The pattern being used is dd-MMM-yyyy HH:mm:ss.SSS 
A sample date looks like 04-Jul-1776 22:00:00.000 


*/ 
Inheritance Hierarchy 
java.lang.Object 
java.text.Format 
java.text.DateFormat 
java.text.SimpleDateFormat 


See Also 

Concepts 

SimpleDateFormat Members 
java.text Package 
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SimpleDateFormat Members 


Contains methods and properties used to format a Date object as a string and to parse a string into a Date object. 


The following tables list the members exposed by the SimpleDateFormat type. 


Public Constructors 





Name 


Description 





SimpleDateFormat 


Overloaded. Initializes a new instance of a SimpleDateFormat object. 





Public Fields 


Name Description 


calendar The underlying Calendar object being used for dates and times.(inherited from DateFormat) 








numberFormat /The NumberFormat object used to format and parse a date and a time.(inherited from DateFormat) 





Public Methods 
Name 


applyLocalizedPattern 


Description 


Changes the pattern that an instance of a SimpleDateFormat object is using after it is created. Localiza 
tion of the pattern is currently not supported by the J# Class Libraries. 











applyPattern Changes the pattern that an instance of a SimpleDateFormat object is using after it is created. 
equals Overridden. Determines whether two SimpleDateFormat objects are equal. 
format Overloaded. Formats a Date object into a string. 





getCalendar 


Gets the Calendar object that is being used. The calendar is used to determine the format of a date. (in 
herited from DateFormat) 


getDateFormatSymbols|Gets the DateFormatSymbols object that contains the symbols used when formatting a Date object. 





getTimeZone 


hashCode Overridden. Serves as a hash function for a particular type, suitable for use in hashing algorithms and 
data structures like a hash table. 
getNumberFormat Gets the NumberFormat object used to format and parse a date and a time. (inherited from 


DateFormat) 


Gets the TimeZone object associated with the Calendar object of this instance. (inherited from 
DateFormat) 




















getClass (inherited from Object ) 

isLenient Determines whether parsing is set to lenient for this DateFormat object. Leniency is determined by the 
Calendar object associated with this instance. (inherited from DateFormat) 

clone Creates a shallow copy of the current SimpleDateFormat object. 

parse Overloaded. Parses a string into a Date object. 

parseObject Overloaded. Parses a string into an Object. (inherited from DateFormat) 











setCalendar 


Sets the Calendar object that is being used. The calendar is used to determine the format of a date. (in 
herited from DateFormat) 





setDateFormatSymbols 


Sets a DateFormatSymbols object that contains the symbols used when formatting a Date. 





setLenient 


setNumberFormat 


Sets a value that determines whether parsing is set to lenient for this DateFormat object. Leniency is d 
etermined by the Calendar object associated with this instance. (inherited from DateFormat) 


Sets the NumberFormat object used to format and parse a date and a time. (inherited from 
DateFormat) 





setTimeZone 


toLocalizedPattern 


toPattern 


toString 





Sets a TimeZone object to be associated with the Calendar object of this instance. (inherited from 
DateFormat) 


Applies the previously set pattern to the string for an instance of a SimpleDateFormat object. Localizat 
ion of the pattern is currently not supported by the J# Class Libraries. 


Applies the previously set pattern to the string for an instance of a SimpleDateFormat object. 


Displays a human-readable representation of a Format object. (inherited from Format) 


Protected Methods 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


SimpleDateFormat Class 


Concepts 
java.text Package 
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SimpleDateFormat Fields 


Public Fields 





Name Description 





calendar The underlying Calendar object being used for dates and times. (inherited from DateFormat ) 





numberFormat |The NumberFormat object used to format and parse a date and a time. (inherited from DateFormat ) 











See Also 

Reference 
SimpleDateFormat Class 
Concepts 

java.text Package 
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SimpleDateFormat Constructor 


Initializes a new instance of a SimpleDateFormat object. 


Overload List 
Name 


SimpleDateFormat () 


SimpleDateFormat (String) 


Description 


Initializes a new instance of a SimpleDateFormat object. 


Initializes a new instance of a SimpleDateFormat object. The Date object will 
be formatted into a string using the pattern provided. 





SimpleDateFormat (String, DateFormatSymbols) 


SimpleDateFormat (String, Locale) 





See Also 

Reference 
SimpleDateFormat Class 
Concepts 

SimpleDateFormat Members 
java.text Package 





Initializes a new instance of a SimpleDateFormat object. The Date object will 
be formatted into a string using the pattern and format symbols provided. 


Initializes a new instance of a SimpleDateFormat object. The Date object will 
be formatted into a string using the pattern and locale provided. 





Visual J# Reference 


SimpleDateFormat Constructor () 


Initializes a new instance of a SimpleDateFormat object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.text.SimpleDateFormat() ; 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
SimpleDateFormat Class 
Concepts 

SimpleDateFormat Members 
java.text Package 
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SimpleDateFormat Constructor (String) 


Initializes a new instance of a SimpleDateFormat object. The Date object will be formatted into a string using the pattern 
provided. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.text.SimpleDateFormat( 
java.lang.String pattern); 





Parameters 
pattern 


The pattern describing how to format the Date object as a string. 
Remarks 


This class uses a pattern string to format or parse a date. The pattern string is a symbolic representation of various 
components of a date/time representation. For example, "dd-MM-yyyy" represents the dayOfMonth-Month-Year 
representation of a date. 


The following table lists the valid contents for the pattern: 





char |Description 

















d Day of month 

D Day of year 

F Day of week in month 
E Day of week 

w Week of year 





WwW Week of month 

















M Month 

y Year 

G Era 

k Hour of day (1 - 24) 
H Hour of day (0 - 23) 
m Minute 

s Second 

S Millisecond 


a AM/PM 











h Hour of day (1 - 12) 


K Hour of day (0 - 11) 


Z Timezone 


Single quote - delimiter for inserting strings into the formatted date 





The number of placeholders used for the year indicates how many digits are to be used to format the year part of date. Also, 
the number of placeholders used for the month component indicates the month representation as follows: 


"M" or "MM" - Format month as number (such as 8 or 08) 
"MMM" - Format month as short name of month (such as Aug) 
"MMMM' - Format month as long name of month (such as August) 


See Also 

Reference 
SimpleDateFormat Class 
Concepts 

SimpleDateFormat Members 
java.text Package 
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SimpleDateFormat Constructor (String, DateFormatSymbols) 


Initializes a new instance of a SimpleDateFormat object. The Date object will be formatted into a string using the pattern and 
format symbols provided. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.text.SimpleDateFormat( 


java.lang.String pattern, 
java.text.DateFormatSymbols symbols) ; 








Parameters 
pattern 


The pattern describing how to format the Date object as a string. 
symbols 

A DateFormatSymbols object describing the symbols to use in formatting the Date object as a string. 
Remarks 


This class uses a pattern string to format or parse a date. The pattern string is a symbolic representation of various 
components of a date/time representation. For example, "dd-MM-yyyy" represents the dayOfMonth-Month-Year 
representation of a date. 


The following table lists the valid contents for the pattern: 


char |Description 


d Day of month 

D Day of year 

F Day of week in month 
E Day of week 

w Week of year 


WwW Week of month 











M Month 

y Year 

G Era 

k Hour of day (1 - 24) 
H Hour of day (0 - 23) 
m Minute 





Ss Second 














S Millisecond 














a AM/PM 

h Hour of day (1 - 12) 
K Hour of day (0 - 11) 
Z Timezone 





Single quote - delimiter for inserting strings into the formatted date 











The number of placeholders used for the year indicates how many digits are to be used to format the year part of date. Also, 
the number of placeholders used for the month component indicates the month representation as follows: 


"M" or "MM" - Format month as number (such as 8 or 08) 
"MMM" - Format month as short name of month (such as Aug) 
"MMMM' - Format month as long name of month (such as August) 


See Also 

Reference 
SimpleDateFormat Class 
Concepts 

SimpleDateFormat Members 
java.text Package 
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SimpleDateFormat Constructor (String, Locale) 


Initializes a new instance of a SimpleDateFormat object. The Date object will be formatted into a string using the pattern and 
locale provided. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.text.SimpleDateFormat( 


java.lang.String pattern, 
java.util.Locale loc); 








Parameters 
pattern 


The pattern describing how to format the Date object as a string. 
loc 

A Locale object used to determine the format of the Date object when displayed as a string. 
Remarks 


This class uses a pattern string to format or parse a date. The pattern string is a symbolic representation of various 
components of a date/time representation. For example, "dd-MM-yyyy" represents the dayOfMonth-Month-Year 
representation of a date. 


The following table lists the valid contents for the pattern: 


char |Description 


d Day of month 

D Day of year 

F Day of week in month 
E Day of week 

w Week of year 


WwW Week of month 











M Month 

y Year 

G Era 

k Hour of day (1 - 24) 
H Hour of day (0 - 23) 
m Minute 





Ss Second 














S Millisecond 














a AM/PM 

h Hour of day (1 - 12) 
K Hour of day (0 - 11) 
Z Timezone 





Single quote - delimiter for inserting strings into the formatted date 











The number of placeholders used for the year indicates how many digits are to be used to format the year part of date. Also, 
the number of placeholders used for the month component indicates the month representation as follows: 


"M" or "MM" - Format month as number (such as 8 or 08) 
"MMM" - Format month as short name of month (such as Aug) 
"MMMM' - Format month as long name of month (such as August) 


See Also 

Reference 
SimpleDateFormat Class 
Concepts 

SimpleDateFormat Members 
java.text Package 
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SimpleDateFormat Methods 


Public Methods 





Name 


Description 





applyLocalizedPattern 


applyPattern 


equals 


format 


getCalendar 


Changes the pattern that an instance of a SimpleDateFormat object is using after it is created. Localiza 
tion of the pattern is currently not supported by the J# Class Libraries. 


Changes the pattern that an instance of a SimpleDateFormat object is using after it is created. 
Overridden. Determines whether two SimpleDateFormat objects are equal. 
Overloaded. Formats a Date object into a string. 


Gets the Calendar object that is being used. The calendar is used to determine the format of a date. (in 
herited from DateFormat ) 


getDateFormatSymbols|Gets the DateFormatSymbols object that contains the symbols used when formatting a Date object. 





getTimeZone 


hashCode Overridden. Serves as a hash function for a particular type, suitable for use in hashing algorithms and 
data structures like a hash table. 
getNumberFormat Gets the NumberFormat object used to format and parse a date and a time. (inherited from 


DateFormat ) 


Gets the TimeZone object associated with the Calendar object of this instance. (inherited from 
DateFormat ) 








setCalendar 


getClass (inherited from Object ) 

isLenient Determines whether parsing is set to lenient for this DateFormat object. Leniency is determined by the 
Calendar object associated with this instance. (inherited from DateFormat ) 

clone Creates a shallow copy of the current SimpleDateFormat object. 

parse Overloaded. Parses a string into a Date object. 

parseObject Overloaded. Parses a string into an Object. (inherited from DateFormat ) 


Sets the Calendar object that is being used. The calendar is used to determine the format of a date. (in 
herited from DateFormat ) 





setDateFormatSymbols 


Sets a DateFormatSymbols object that contains the symbols used when formatting a Date. 








setTimeZone 





setLenient Sets a value that determines whether parsing is set to lenient for this DateFormat object. Leniency is d 
etermined by the Calendar object associated with this instance. (inherited from DateFormat ) 
setNumberFormat Sets the NumberFormat object used to format and parse a date and a time. (inherited from 


DateFormat ) 


Sets a TimeZone object to be associated with the Calendar object of this instance. (inherited from 
DateFormat ) 











toLocalizedPattern Applies the previously set pattern to the string for an instance of a SimpleDateFormat object. Localizat 
ion of the pattern is currently not supported by the J# Class Libraries. 


toPattern Applies the previously set pattern to the string for an instance of a SimpleDateFormat object. 


toString Displays a human-readable representation of a Format object. (inherited from Format ) 





Protected Methods 
Name Description 








finalize (inherited from Object ) 














See Also 

Reference 
SimpleDateFormat Class 
Concepts 

java.text Package 
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SimpleDateFormat.applyLocalizedPattern Method 


Changes the pattern that an instance of a SimpleDateFormat object is using after it is created. Localization of the pattern is 
currently not supported by the J# Class Libraries. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void applyLocalizedPattern( 
java.lang.String pattern); 





Parameters 
pattern 


Specifies the style used to format to or parse from date strings. 
Example 


The following example shows how to apply a localized pattern to a SimpleDateFormat object. 





// simpledateformat_applylocalizedpattern.jsl 


import java.text.*; 
import java.util.Date; 


public class Program 


public static void main(String[] args) 


{ 
// Apply a localized pattern to a SimpleDateFormat object. 
SimpleDateFormat sdf = new SimpleDateFormat() ; 
String pattern = 
"'This moment: 'dd MMM yyyy ‘@'hh ‘hours and ‘mm ‘minutes.'"; 
sdf.applyLocalizedPattern(pattern) ; 
// Print out the time now. 
System.out.println(sdf.format(new Date())); 
} 
} 
/* 


Sample Output: 
This moment: 11 Nov 2004 @10 hours and 16 minutes. 
* 








Remarks 


Localization of the pattern is currently not supported by the J# Class Libraries. Calling this method has the same effect as 
calling applyPattern. 


This class uses a pattern string to format or parse a date. The pattern string is a symbolic representation of various 
components of a date/time representation. For example, "dd-MM-yyyy" represents the dayOfMonth-Month-Year 
representation of a date. 


The following table lists the valid contents for the pattern: 
char _ |Description 
d Day of month 


D Day of year 






































F Day of week in month 
E Day of week 

w Week of year 

WwW Week of month 

M Month 

y Year 

G Era 

k Hour of day (1 - 24) 

H Hour of day (0 - 23) 
m Minute 

s Second 

S Millisecond 

a AM/PM 

h Hour of day (1 - 12) 
K Hour of day (0 - 11) 
Z Timezone 

Single quote - delimiter for inserting strings into the formatted date 











The number of placeholders used for the year indicates how many digits are to be used to format the year part of date. Also, 
the number of placeholders used for the month component indicates the month representation as follows: 


"M" or "MM" - Format month as number (such as 8 or 08) 
"MMM'" - Format month as short name of month (such as Aug) 
"MMMM' - Format month as long name of month (such as August) 


See Also 

Reference 
SimpleDateFormat Class 
Concepts 

SimpleDateFormat Members 
java.text Package 
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SimpleDateFormat.applyPattern Method 


Changes the pattern that an instance of a SimpleDateFormat object is using after it is created. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 





public void applyPattern( 
java.lang.String pattern); 





Parameters 
pattern 


Specifies the style used to format to or parse from date strings. 
Example 


The following example shows how to apply a pattern to a SimpleDateFormat object. 


// simpledateformat_applypattern.jsl 


import java.text.*; 
import java.util.Date; 


public class Program 


{ 
public static void main(String[] args) 
{ 
// Apply a pattern to a SimpleDateFormat object. 
SimpleDateFormat sdf = new SimpleDateFormat() ; 
String pattern = 
"'This moment: 'dd MMM yyyy ‘@'hh ‘hours and ‘mm 'minutes.'"; 
sdf.applyPattern(pattern) ; 
// Print out the time now. 
System. out.println(sdf.format(new Date())); 
} 
} 
pe 


Sample Output: 
This moment: 11 Nov 2004 @10 hours and 16 minutes. 


*/ 











Remarks 


This class uses a pattern string to format or parse a date. The pattern string is a symbolic representation of various 
components of a date/time representation. For example, "dd-MM-yyyy" represents the dayOfMonth-Month-Year 
representation of a date. 


The following table lists the valid contents for the pattern: 





char |Description 





d Day of month 





D Day of year 





F Day of week in month 



































E Day of week 

w Week of year 

WwW Week of month 

M Month 

y Year 

G Era 

k Hour of day (1 - 24) 
H Hour of day (0 - 23) 
m Minute 

s Second 

S Millisecond 

a AM/PM 

h Hour of day (1 - 12) 
K Hour of day (0 - 11) 
Z Timezone 

Single quote - delimiter for inserting strings into the formatted date 





The number of placeholders used for the year indicates how many digits are to be used to format the year part of date. Also, 
the number of placeholders used for the month component indicates the month representation as follows: 


"M" or "MM" - Format month as number (such as 8 or 08) 
"MMM'" - Format month as short name of month (such as Aug) 
"MMMM' - Format month as long name of month (such as August) 


See Also 

Reference 
SimpleDateFormat Class 
Concepts 

SimpleDateFormat Members 
java.text Package 
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SimpleDateFormat.clone Method 


Creates a shallow copy of the current SimpleDateFormat object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object clone(); 


Return Value 
A shallow copy of the current SimpleDateFormat object. 


See Also 

Reference 
SimpleDateFormat Class 
Concepts 

SimpleDateFormat Members 
java.text Package 
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SimpleDateFormat.equals Method 


Determines whether two SimpleDateFormat objects are equal. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public boolean equals( 
java.lang.Object obj); 


Parameters 


obj 

A SimpleDateFormat object to compare with the current SimpleDateFormat object for equality. 
Return Value 
true if the two SimpleDateFormat objects are equal; false otherwise. 


See Also 

Reference 
SimpleDateFormat Class 
Concepts 

SimpleDateFormat Members 
java.text Package 
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SimpleDateFormat.format Method 


Formats a Date object into a string. 


Overload List 
Name 


SimpleDateFormat.format (Date) 
SimpleDateFormat.format (Object) 
SimpleDateFormat.ormat (Date, StringBuffer, FieldPosition) 


SimpleDateFormat.ormat (Object, StringBuffer, FieldPosition) 





See Also 

Reference 
SimpleDateFormat Class 
Concepts 

SimpleDateFormat Members 
java.text Package 





Description 


Formats a Date object into a string. 


Formats an object into a string. 


Formats a Date object and appends it to a StringBuffer object. 


Formats an object representing a Date and appends it to a Strin 
gBuffer object. 





Visual J# Reference 


SimpleDateFormat.format Method (Date, StringBuffer, 
FieldPosition) 


Formats a Date object and appends it to a StringBuffer object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.StringBuffer format( 
java.util.Date date, 
java.lang.StringBuffer appendBuf, 
java.text.FieldPosition pos); 


Parameters 
date 


The Date object to be formatted into a string. 
appendBuf 
A StringBuffer object to be appended with the Date object formatted into a string. 
pos 
Used to find start and end indices of a particular field of the date in the formatted string. 
Return Value 
A StringBuffer object appended with the formatted Date object. 
Example 


The following example shows how to format a SimpleDateFormat object and to determine where the year field can be found in 
the formatted date. 


// simpledateformat_format.js1l 


import java.text.*; 
import java.util.Date; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Apply a pattern to a SimpleDateFormat object. 
String pattern = 
""This moment: 'dd MMM yyyy ‘@'hh ‘hours and ‘mm ‘'minutes.'"; 
SimpleDateFormat sdf = new SimpleDateFormat (pattern) ; 


// Print out the time now using the format method. 

StringBuffer buf = new StringBuffer(); 

FieldPosition pos = new FieldPosition(DateFormat.YEAR_FIELD) ; 

sdf.format(new Date(), buf, pos); 

System.out.println(buf) ; 

System.out.printlin("The year field occupies indices: " + 
pos.getBeginIndex() + " - " + pos.getEndIndex()); 


} 


/* 

Sample Output: 

This moment: 11 Nov 2004 @10 hours and 29 minutes. 
The year field occupies indices: 20 - 24 


td 





See Also 
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SimpleDateFormat Class 
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SimpleDateFormat Members 
java.text Package 


Visual J# Reference 


SimpleDateFormat.getDateFormatSymbols Method 


Gets the DateFormatSymbols object that contains the symbols used when formatting a Date object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.text.DateFormatSymbols getDateFormatSymbols(); 


Return Value 
The DateFormatSymbols object that contains the symbols used when formatting a Date object. 
Example 


The following example shows how to get the date format symbols. 


// simpledateformat_getdateformatsymbols.jsl 


import java.text.*; 
import java.util.Date; 


public class Program 


{ 
public static void main(String[] args) 
{ 
// Apply a pattern to a SimpleDateFormat object. 
String pattern = 
""This moment: 'dd MMM yyyy ‘@'hh ‘hours and ‘mm 'minutes.'"; 
SimpleDateFormat sdf = new SimpleDateFormat (pattern) ; 
// Get the date format symbols for this SimpleDateFormat 
// object. 
DateFormatSymbols dfs = sdf.getDateFormatSymbols(); 
// Print out the valid months in short name format. 
String[] shortMonths = dfs.getShortMonths(); 
System.out.print("Months: "); 
for (int i = @; i < shortMonths.length; i++) 
{ 
System.out.print(shortMonths[i] + " "); 
} 
System.out.print1n(); 
// Print out the valid eras. 
String[] eras = dfs.getEras(); 
System.out.print("Eras: "); 
for (int i = @; i < eras.length; i++) 
{ 
System.out.print(eras[i] + " "); 
} 
System.out.print1n(); 
// Print out the valid weekdays. 
String[] weekdays = dfs.getWeekdays(); 
System.out.print("Weekdays: "); 
for (int i = @; i < weekdays.length; i++) 
{ 
System.out.print(weekdays[i] + " "); 
} 
System.out.printl1n(); 
} 


fe 

Sample Output: 

Months: Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec 
Eras: ?? A.D. 


Weekdays: Sunday Monday Tuesday Wednesday Thursday Friday Saturday 
*/ 





See Also 
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SimpleDateFormat.hashCode Method 


Serves as a hash function for a particular type, suitable for use in hashing algorithms and data structures like a hash table. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public int hashCode(); 


Return Value 
A hash code for the current object. 


See Also 

Reference 
SimpleDateFormat Class 
Concepts 

SimpleDateFormat Members 
java.text Package 


Visual J# Reference 


SimpleDateFormat.parse Method 


Parses a string into a Date object. 


Overload List 


SimpleDateFormat.parse (String) Parses a String into a Date object. 





SimpleDateFormat.parse (String, ParsePosition) Parses a String into a Date object. 


See Also 

Reference 
SimpleDateFormat Class 
Concepts 

SimpleDateFormat Members 
java.text Package 
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SimpleDateFormat.parse Method (String, ParsePosition) 


Parses a string into a Date object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.util.Date parse( 
java.lang.String sourceStr, 
java.text.ParsePosition pos); 


Parameters 
sourceStr 


The string to be parsed into a Date object. 
pos 

Used to indicate the first position in the string to be parsed. 
Return Value 
A Date object containing the date represented by the string. 
Example 


The following example shows how to parse a date that adheres to a previously defined pattern. 


// simpledateformat_parse.jsl 


import java.text.*; 
import java.util.Date; 


public class Program 


{ 


public static void main(String[] args) 


if 
// Create a SimpleDateFormat object. 


String pattern = "dd-MMM-yyyy HH:mm:ss.SSS"; 
SimpleDateFormat sdf = new SimpleDateFormat (pattern) ; 


// Parse a sample date starting at position @. 
String sampleDateStr = "@4-Jul-1776 22:00:00.000"; 
ParsePosition pos = new ParsePosition(@); 

Date sampleDate = sdf.parse(sampleDateStr, pos); 


// Print out the date using the supplied pattern. 
System.out.println(sdf.format(sampleDate) ) ; 


} 


/* 

Sample Output: 
04-Jul-1776 22:00:00.e00 
A 


See Also 

Reference 
SimpleDateFormat Class 
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SimpleDateFormat Members 
java.text Package 
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SimpleDateFormat.setDateFormatSymbols Method 


Sets a DateFormatSymbols object that contains the symbols used when formatting a Date. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public void setDateFormatSymbols( 
java.text.DateFormatSymbols symbols); 


Parameters 
symbols 


A DateFormatSymbols object that contains the symbols used when formatting a Date. 
Example 


The following example shows how to set a modified DateFormatSymbols object. 


// simpledateformat_setdateformatsymbols.jsl 


import java.text.*; 
import java.util.Date; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Apply a pattern to a SimpleDateFormat object. 
String pattern = 
""This moment: 'dd MMM yyyy ‘@'hh ‘hours and ‘mm ‘'minutes.'"; 
SimpleDateFormat sdf = new SimpleDateFormat (pattern) ; 


// Create a new DateFormatSymbols with a few modifications 

// from the norm. 

DateFormatSymbols dfs = new DateFormatSymbols(); 

String[] months = { "jan", "feb", "mar", "apr", "may", 
"jun", "jul", "aug", "sep", "oct", 
"nov", "dec" }; 

dfs.setShortMonths(months) ; 


String[] eras = { "bc", "ad" }; 
dfs.setEras(eras) ; 


String[] weekdays = { "montag", "dienstag", "mittwoch", 
"donnerstag", "freitag", "samstag", 
"sonntag” }; 

dfs.setwWeekdays (weekdays) ; 


sdf.setDateFormatSymbols(dfs); 


// Print out the valid months in short name format. 
String[] newMonths = dfs.getShortMonths(); 
System.out.print("Months: "); 

for (int i = @; i < newMonths.length; i++) 


{ 


} 
System.out.print1n(); 


System.out.print(newMonths[i] + " "); 


// Print out the valid eras. 

String[] newEras = dfs.getEras(); 
System.out.print("Eras: "); 

for (int i = @; i < newEras.length; i++) 


{ 


} 
System.out.print1n(); 


System.out.print(newEras[i] + " "); 


// Print out the valid weekdays. 

String[] newWeekdays = dfs.getWeekdays(); 
System.out.print("Weekdays: "); 

for (int i = @; i < newWeekdays.length; i++) 


! 
System.out.print(newWeekdays[i] + " "); 
System.out.printl1n(); 
} 
} 
/* 


Sample Output: 

Months: jan feb mar apr may jun jul aug sep oct nov dec 

Eras: bc ad 

Weekdays: montag dienstag mittwoch donnerstag freitag samstag 


ey 





sonntag 





See Also 

Reference 
SimpleDateFormat Class 
Concepts 
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SimpleDateFormat.toLocalizedPattern Method 


Applies the previously set pattern to the string for an instance of a SimpleDateFormat object. Localization of the pattern is 
currently not supported by the J# Class Libraries. 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toLocalizedPattern(); 


Return Value 
The string representation of the date formatted using the previously set pattern. 
Example 


The following example prints out the default localized pattern. 


// simpledateformat_tolocalizedpattern.jsl 


import java.text.*; 
import java.util.Date; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a SimpleDateFormat object with the 
// default pattern. 
SimpleDateFormat sdf = new SimpleDateFormat() ; 
// Get the localized pattern. 
String locPattern = sdf.toLocalizedPattern() ; 
// Print out the localized pattern. 
System.out.println("Localized pattern = " + locPattern); 
} 
} 
/* 


Sample Output: 
Localized pattern = dd-MMM-yy hh:mm:ss a 
si 


Remarks 


Localization of the pattern is currently not supported by the J# Class Libraries. Calling this method has the same effect as 
calling toPattern. 


See Also 

Reference 
SimpleDateFormat Class 
Concepts 

SimpleDateFormat Members 
java.text Package 
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SimpleDateFormat.toPattern Method 


Applies the previously set pattern to the string for an instance of a SimpleDateFormat object. 
Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toPattern(); 


Return Value 
The string representation of the date formatted using the previously set pattern. 
Example 


The following example prints out the default pattern. 


// simpledateformat_topattern.jsl 


import java.text.*; 
import java.util.Date; 


public class Program 


{ 


public static void main(String[] args) 


{ 
// Create a SimpleDateFormat object with the 


// default pattern. 
SimpleDateFormat sdf = new SimpleDateFormat(); 


// Get the pattern. 
String pattern = sdf.toPattern(); 


// Print out the pattern. 
System.out.println("Default pattern = " + pattern); 


/* 
Sample Output: 
Default pattern = dd-MMM-yy hh:mm:ss a 


my, 


See Also 
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StringCharacterlterator Class 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public final class java.text.StringCharacterIterator 
extends java.lang.Object 
implements java.text.CharacterIterator 


Inheritance Hierarchy 
java.lang.Object 
java.text.StringCharacterlterator 


See Also 

Concepts 

StringCharacterlterator Members 
java.text Package 
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StringCharacterlterator Members 


The following tables list the members exposed by the StringCharacterlterator type. 


Public Constructors 


Name Description 





StringCharacterlterator 


Public Methods 











Name Description 
current 

equals Overridden. 
first 


getBeginIndex 

getEndIndex 

hashCode Overridden. 

getIndex 

getClass (inherited from Object ) 

last 

MemberwiseClone Performs a shallow copy of the object. 
next 

previous 

setindex 


toString Overridden. 





See Also 

Reference 
StringCharacterlterator Class 
Concepts 

java.text Package 
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StringCharacterlterator Constructor 


Overload List 





Name Description 





StringCharacterlterator (String) 





StringCharacterlterator (String, int) 





StringCharacterlterator (String, int, int, int) 











See Also 

Reference 
StringCharacterlterator Class 
Concepts 

StringCharacterlterator Members 
java.text Package 
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StringCharacterlterator Constructor (String) 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.text.StringCharacterIterator( 
java.lang.String text); 


Parameters 
text 


See Also 

Reference 
StringCharacterlterator Class 
Concepts 

StringCharacterlterator Members 
java.text Package 
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StringCharacterlterator Constructor (String, Int32) 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.text.StringCharacterIterator( 
java.lang.String text, 
int pos); 


Parameters 
text 


pos 


See Also 

Reference 
StringCharacterlterator Class 
Concepts 

StringCharacterlterator Members 
java.text Package 
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StringCharacterlterator Constructor (String, Int32, Int32, Int32) 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public java.text.StringCharacterIterator( 
java.lang.String text, 
int begin, 
int end, 
int pos); 


Parameters 
text 


begin 
end 
pos 


See Also 

Reference 
StringCharacterlterator Class 
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StringCharacterlterator Members 
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StringCharacterlterator Methods 


Public Methods 














Name Description 
current 

equals Overridden. 
first 





getBeginIndex 





getEndIndex 

hashCode Overridden. 

getIndex 

getClass (inherited from Object ) 

last 

MemberwiseClone Performs a shallow copy of the object. 
next 

previous 

setindex 


toString Overridden. 





See Also 

Reference 
StringCharacterlterator Class 
Concepts 

java.text Package 
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StringCharacterlterator.clone Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


See Also 

Reference 
StringCharacterlterator Class 
Concepts 

StringCharacterlterator Members 
java.text Package 
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StringCharacterlterator.current Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public char current(); 


See Also 

Reference 
StringCharacterlterator Class 
Concepts 

StringCharacterlterator Members 
java.text Package 
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StringCharacterlterator.equals Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public boolean equals( 
java.lang.Object obj); 


Parameters 


obj 


See Also 

Reference 
StringCharacterlterator Class 
Concepts 

StringCharacterlterator Members 
java.text Package 
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StringCharacterlterator.first Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public char first(); 


See Also 

Reference 
StringCharacterlterator Class 
Concepts 

StringCharacterlterator Members 
java.text Package 
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StringCharacterlterator.getBeginIndex Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public int getBeginIndex(); 


See Also 

Reference 
StringCharacterlterator Class 
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StringCharacterlterator Members 
java.text Package 
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StringCharacterlterator.getEndIndex Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public int getEndIndex(); 


See Also 

Reference 
StringCharacterlterator Class 
Concepts 

StringCharacterlterator Members 
java.text Package 
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StringCharacterlterator.hashCode Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public int hashCode(); 


See Also 

Reference 
StringCharacterlterator Class 
Concepts 

StringCharacterlterator Members 
java.text Package 
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StringCharacterlterator.getIndex Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public int getIndex(); 


See Also 

Reference 
StringCharacterlterator Class 
Concepts 

StringCharacterlterator Members 
java.text Package 
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StringCharacterlterator.last Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public char last(); 


See Also 

Reference 
StringCharacterlterator Class 
Concepts 

StringCharacterlterator Members 
java.text Package 
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StringCharacterlterator.next Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public char next(); 


See Also 

Reference 
StringCharacterlterator Class 
Concepts 

StringCharacterlterator Members 
java.text Package 
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StringCharacterlterator.previous Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public char previous(); 


See Also 

Reference 
StringCharacterlterator Class 
Concepts 

StringCharacterlterator Members 
java.text Package 
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StringCharacterlterator.setIndex Method 


Package: java.text 


Assembly: vjslib (in vjslib.dll) 


public char setIndex( 
int idx); 


Parameters 
idx 


See Also 

Reference 
StringCharacterlterator Class 
Concepts 

StringCharacterlterator Members 
java.text Package 
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java.util 


Contains the classes and interfaces used to handle collections such as hash tables, linked lists, stacks, and dictionaries. This 
package also provides classes to handle time zones and globalization, in addition to other utility classes such as a random- 
number generator and a string tokenizer. 


Classes 
Class 


ArrayList 


Arrays 


Calendar 


ConcurrentModificationException 


Description 


Represents a dynamically sized, index-based collection of objects. 


A class that contains several methods for sorting, searching, filling and comparing arrays. 


Contains methods and members to perform basic operations involving days, weeks, months 
,and years. 


The exception that is thrown when two threads attempt to modify a collection concurrently. 





Date Contains methods to perform basic operations on dates and times. 

Dictionary An abstract class that contains a map of elements associated with keys. Both elements and k 
eys are non-null objects. 

EmptyStackException The exception that is thrown when attempting to pop an element off of an empty stack. 





GregorianCalendar 


Extends the abstract class Calendar and provides the common standard calendar. 








HashMap Represents a unique collection of key-value pairs. The elements are sorted according to the 
hash value of the key, and each key can exist only once in the collection. 

HashSet Represents a unique collection of elements that are sorted according to their hash value, and 
can each exist only once in the collection. 

Hashtable Provides an object for key entries mapped to their corresponding values. Both keys and valu 
es must be non-null objects. 

LinkedList A class that represents a dynamic collection of elements. Each element consists of a data fiel 


d anda link field. The link field points to the data field of the next element. 





MissingResourceException 


An exception thrown to indicate that a resource is missing. 





NoSuchElementException 


The exception that is thrown when attempting to access an element in a collection that does 
not exist. This exception is frequently thrown when attempting to perform an operation on a 
n empty collection or when attempting to access past the end of the collection. 











Observable Represents the observable object, which usually contains data. It can have one or more obse 
rvers. An Observer object is an instance of a class that implements the Observer interface. 
When the data on the observable object changes, the observers can be notified through the 
update method, which passes the necessary information to the notifyObservers method. 

Random Contains methods to obtain various sorts of random data, such as integers, floats, and other 


primitives. 











SimpleTimeZone 


Represents a specialization of the TimeZone class containing methods useful for calculations 
involving time zones, such as offsets from UTC and determining whether daylight savings ti 
me is in effect. 





Stack 


Represents a collection of objects that are accessed in a last-in, first out fashion. Elements ar 
e pushed onto the top of the stack, and the last element pushed on is the first element to be 
popped off. 





StringTokenizer 


Provides methods to parse a string and split it into tokens based on a delimiter. 




















TimeZone Represents an abstract class containing methods useful for calculations involving time zones 
_ such as offsets from UTC and determining whether daylight savings time is in effect. 

TreeMap Provides a sorted map object that implements the SortedMap interface. 

TreeSet A class that represents a sorted set of elements. The elements are sorted using the comparat 
or provided through constructor or using the Comparable interface methods implemented b 
y the elements. 

Vector Represents a dynamic array of elements. Unlike a static array, a vector will grow in size once 
it has reached capacity. 

Interfaces 

Interface |Description 

Collection |An interface that represents a group of objects or elements. It is implemented by many collection classes such as 

LinkedList, ArrayList, HashSet and TreeSet. 
Comparator |Contains methods to compare objects. It is implemented by the abstract class Collator. 


Enumeration 


Iterator 


List 


Listlterator 


Provides an efficient mechanism to traverse the elements of various collections. 


Provides an efficient mechanism to traverse the elements of various collections. 


An interface that represents an ordered collection of elements. 


An interface that implements the Iterator interface. It allows traversing the list and modifying it during iteration. It 
also obtains the current position of the iterator's cursor. The cursor position is between the elements of a collecti 
on. 





Map An interface that provides a Map object for key entries and their corresponding values. 

Observer _ |An interface that enables the implementing class to be notified of any changes in the observable objects. 
Set Provides a set of objects that implements the Collection interface. 

SortedMap |Represents a specialization of a Map object containing elements sorted by their key. 

SortedSet |Represents a specialization of a Set object containing sorted elements. 
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AbstractCollection Class 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public abstract class java.util.AbstractCollection 
extends java.lang.Object 
implements java.util.Collection 





Inheritance Hierarchy 
java.lang.Object 
java.util AbstractCollection 
java.util AbstractList 
java.util AbstractSet 


See Also 

Concepts 

AbstractCollection Members 
java.util Package 


Visual J# Reference 


AbstractCollection Members 


The following tables list the members exposed by the AbstractCollection type. 


Public Constructors 
Name 


AbstractCollection 





Public Methods 





Name Description 





add 





addAll 


clear 


contains 


containsAll 


equals (inherited from Object ) 


hashCode (inherited from Object ) 


getClass (inherited from Object ) 


isEmpty 


iterator 


clone 


remove 


removeAll 


retainAll 


size 


toArray Overloaded. 


toString Overridden. 








Protected Methods 


Name Description 


finalize (inherited from Object ) 








See Also 
Reference 


AbstractCollection Class 





Concepts 
java.util Package 


Visual J# Reference 


AbstractCollection Constructor 


Initializes a new instance of the AbstractCollection Class . 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.util.AbstractCollection(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
AbstractCollection Class 
Concepts 

AbstractCollection Members 
java.util Package 
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AbstractCollection Methods 


Public Methods 





Name 


Description 





add 





addAll 





clear 





contains 





containsAll 


equals 


hashCode 


getClass 


isEmpty 


iterator 


clone 


remove 


removeAll 


retainAll 


size 


toArray 


toString 


Protected Methods 


(inherited from Object ) 


(inherited from Object ) 


(inherited from Object ) 


Overloaded. 


Overridden. 








Name 


Description 





finalize 








(inherited from Object ) 





See Also 

Reference 
AbstractCollection Class 
Concepts 

java.util Package 
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AbstractCollection.add Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean add( 
java.lang.Object e); 





Parameters 
e 


See Also 

Reference 
AbstractCollection Class 
Concepts 

AbstractCollection Members 
java.util Package 


Visual J# Reference 


AbstractCollection.addAll Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean addA1l1l( 
java.util.Collection c); 


Parameters 
Cc 


See Also 

Reference 
AbstractCollection Class 
Concepts 

AbstractCollection Members 
java.util Package 


Visual J# Reference 


AbstractCollection.clear Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void clear(); 


See Also 

Reference 
AbstractCollection Class 
Concepts 

AbstractCollection Members 
java.util Package 
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AbstractCollection.contains Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean contains ( 
java.lang.Object e); 


Parameters 
e 


See Also 

Reference 
AbstractCollection Class 
Concepts 

AbstractCollection Members 
java.util Package 


Visual J# Reference 


AbstractCollection.containsAll Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean containsA11( 
java.util.Collection c); 


Parameters 
Cc 


See Also 

Reference 
AbstractCollection Class 
Concepts 

AbstractCollection Members 
java.util Package 


Visual J# Reference 


AbstractCollection.isEmpty Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean isEmpty(); 


See Also 

Reference 
AbstractCollection Class 
Concepts 

AbstractCollection Members 
java.util Package 


Visual J# Reference 


AbstractCollection.iterator Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.util.Iterator iterator(); 


See Also 

Reference 
AbstractCollection Class 
Concepts 

AbstractCollection Members 
java.util Package 
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AbstractCollection.remove Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean remove( 
java.lang.Object e); 


Parameters 
e 


See Also 

Reference 
AbstractCollection Class 
Concepts 

AbstractCollection Members 
java.util Package 


Visual J# Reference 


AbstractCollection.removeAll Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean removeA11( 
java.util.Collection c); 


Parameters 
Cc 


See Also 

Reference 
AbstractCollection Class 
Concepts 

AbstractCollection Members 
java.util Package 


Visual J# Reference 


AbstractCollection.retainAll Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean retainAl1l( 
java.util.Collection c); 


Parameters 
Cc 


See Also 

Reference 
AbstractCollection Class 
Concepts 

AbstractCollection Members 
java.util Package 


Visual J# Reference 


AbstractCollection.size Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract int size(); 


See Also 

Reference 
AbstractCollection Class 
Concepts 

AbstractCollection Members 
java.util Package 


Visual J# Reference 


AbstractCollection.toArray Method 


Overload List 





Name 


Description 





AbstractCollection.toArray () 





AbstractCollection.toArray (Object[]) 











See Also 

Reference 
AbstractCollection Class 
Concepts 

AbstractCollection Members 
java.util Package 





Visual J# Reference 


AbstractCollection.toArray Method () 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object[] toArray(); 


See Also 

Reference 
AbstractCollection Class 
Concepts 

AbstractCollection Members 
java.util Package 


Visual J# Reference 


AbstractCollection.toArray Method (Object[ ]) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object[] toArray( 
java.lang.Object[] arr); 


Parameters 
arr 


See Also 

Reference 
AbstractCollection Class 
Concepts 

AbstractCollection Members 
java.util Package 


Visual J# Reference 


AbstractCollection.toString Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toString(); 


See Also 

Reference 
AbstractCollection Class 
Concepts 

AbstractCollection Members 
java.util Package 


Visual J# Reference 


AbstractList Class 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public abstract class java.util.AbstractList 
extends java.util.AbstractCollection 


implements java.util.List 





Inheritance Hierarchy 
java.lang.Object 
java.util. AbstractCollection 
java.util. AbstractList 
java.util AbstractSequentialList 
java.util ArrayList 


java.util. Vector 


See Also 
Concepts 
AbstractList Members 


java.util Package 


Visual J# Reference 


AbstractList Members 


The following tables list the members exposed by the AbstractList type. 


Public Constructors 

































































Name 

AbstractList 

Public Fields 

Name Description 
modCount 

Public Methods 

Name Description 

add Overloaded. Overridden. 

addaAll Overloaded. Overridden. 

clear Overridden. 

contains (inherited from AbstractCollection ) 
containsAll (inherited from AbstractCollection ) 
equals Overridden. 

get 

hashCode Overridden. 

getClass (inherited from Object ) 

indexOf 

isEmpty (inherited from AbstractCollection ) 
iterator Overridden. 

lastIndexOf 

listlterator Overloaded. 

clone (inherited from AbstractCollection ) 
remove Overloaded. 

removeAll (inherited from AbstractCollection ) 
removeRange 











retainAll (inherited from AbstractCollection ) 





set 

size Overridden. 

subList 

toArray Overloaded. (inherited from AbstractCollection ) 
toString (inherited from AbstractCollection ) 


Protected Methods 





Name Description 





finalize (inherited from Object ) 








See Also 
Reference 
AbstractList Class 
Concepts 
java.util Package 





Visual J# Reference 


AbstractList Fields 


Public Fields 





Name 


Description 





modCount 











See Also 
Reference 
AbstractList Class 
Concepts 
java.util Package 





Visual J# Reference 


AbstractList.modCount Field 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


protected transient int modCount; 


See Also 

Reference 
AbstractList Class 
Concepts 

AbstractList Members 
java.util Package 


Visual J# Reference 


AbstractList Constructor 


Initializes a new instance of the AbstractList Class . 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.util.AbstractList(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
AbstractList Class 
Concepts 

AbstractList Members 
java.util Package 


Visual J# Reference 


AbstractList Methods 


Public Methods 
































Name Description 

add Overloaded. Overridden. 

addaAll Overloaded. Overridden. 

clear Overridden. 

contains (inherited from AbstractCollection ) 
containsAll (inherited from AbstractCollection ) 
equals Overridden. 

get 

hashCode Overridden. 

getClass (inherited from Object ) 

indexOf 

isEmpty (inherited from AbstractCollection ) 
iterator Overridden. 

lastIndexOf 

listlterator Overloaded. 

clone (inherited from AbstractCollection ) 
remove Overloaded. 

removeAll (inherited from AbstractCollection ) 
removeRange 

retainAll (inherited from AbstractCollection ) 
set 

size Overridden. 

subList 

toArray Overloaded. (inherited from AbstractCollection ) 
toString (inherited from AbstractCollection ) 











Protected Methods 





See Also 
Reference 
AbstractList Class 
Concepts 

java.util Package 
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AbstractList.add Method 


Overload List 





Name Description 





AbstractList.add (Object) 





AbstractList.add (int, Object) 











See Also 

Reference 
AbstractList Class 
Concepts 

AbstractList Members 
java.util Package 


Visual J# Reference 


AbstractList.add Method (Object) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean add( 
java.lang.Object e); 


Parameters 
e 


See Also 

Reference 
AbstractList Class 
Concepts 

AbstractList Members 
java.util Package 


Visual J# Reference 


AbstractList.add Method (Int32, Object) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void add( 
int ix, 
java.lang.Object e); 


Parameters 
ix 


See Also 

Reference 
AbstractList Class 
Concepts 

AbstractList Members 
java.util Package 


Visual J# Reference 


AbstractList.addAll Method 


Overload List 





Name 


Description 





AbstractList.addAll (Collection) 





AbstractList.addAll (int, Collection) 











See Also 

Reference 
AbstractList Class 
Concepts 

AbstractList Members 
java.util Package 





Visual J# Reference 


AbstractList.addAll Method (Collection) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean addA1l1l( 
java.util.Collection c); 


Parameters 
Cc 


See Also 

Reference 
AbstractList Class 
Concepts 

AbstractList Members 
java.util Package 


Visual J# Reference 


AbstractList.addAll Method (Int32, Collection) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean addA1l( 
int ix, 
java.util.Collection c); 


Parameters 
ix 


See Also 

Reference 
AbstractList Class 
Concepts 

AbstractList Members 
java.util Package 


Visual J# Reference 


AbstractList.clear Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public void clear(); 





See Also 

Reference 
AbstractList Class 
Concepts 

AbstractList Members 
java.util Package 


Visual J# Reference 


AbstractList.equals Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean equals( 
java.lang.Object e); 





Parameters 
e 


See Also 

Reference 
AbstractList Class 
Concepts 

AbstractList Members 
java.util Package 


Visual J# Reference 


AbstractList.get Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.Object get( 
int ix); 





Parameters 
x 


See Also 

Reference 
AbstractList Class 
Concepts 

AbstractList Members 
java.util Package 


Visual J# Reference 


AbstractList.hashCode Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public int hashCode(); 


See Also 

Reference 
AbstractList Class 
Concepts 

AbstractList Members 
java.util Package 


Visual J# Reference 


AbstractList.indexOf Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public int indexOf( 
java.lang.Object e); 


Parameters 
e 


See Also 

Reference 
AbstractList Class 
Concepts 

AbstractList Members 
java.util Package 


Visual J# Reference 


AbstractList.iterator Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Iterator iterator(); 


See Also 

Reference 
AbstractList Class 
Concepts 

AbstractList Members 
java.util Package 


Visual J# Reference 


AbstractList.lastindexOf Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public int lastIndexOf( 
java.lang.Object e); 


Parameters 
e 


See Also 

Reference 
AbstractList Class 
Concepts 

AbstractList Members 
java.util Package 


Visual J# Reference 


AbstractList.listlterator Method 


Overload List 





Name 


Description 





AbstractList.listlterator () 





AbstractList.listlterator (int) 











See Also 

Reference 
AbstractList Class 
Concepts 

AbstractList Members 
java.util Package 





Visual J# Reference 


AbstractList.listlterator Method () 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.ListIterator listIterator(); 


See Also 

Reference 
AbstractList Class 
Concepts 

AbstractList Members 
java.util Package 


Visual J# Reference 


AbstractList.listlterator Method (Int32) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.ListIterator listIterator( 
int ix); 


Parameters 
x 


See Also 

Reference 
AbstractList Class 
Concepts 

AbstractList Members 
java.util Package 


Visual J# Reference 


AbstractList.remove Method 


Overload List 





Name Description 





AbstractList.remove (int) 





AbstractList.remove (Object) 











See Also 

Reference 
AbstractList Class 
Concepts 

AbstractList Members 
java.util Package 


Visual J# Reference 


AbstractList.remove Method (Int32) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object remove( 
int ix); 


Parameters 
x 


See Also 

Reference 
AbstractList Class 
Concepts 

AbstractList Members 
java.util Package 


Visual J# Reference 


AbstractList.removeRange Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


protected void removeRange( 
int fromIx, 
int toIx); 


Parameters 
fromlx 


tolx 


See Also 

Reference 
AbstractList Class 
Concepts 

AbstractList Members 
java.util Package 


Visual J# Reference 


AbstractList.set Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.lang.Object set( 
int is, 
java.lang.Object e); 





Parameters 
is 


See Also 

Reference 
AbstractList Class 
Concepts 

AbstractList Members 
java.util Package 


Visual J# Reference 


AbstractList.size Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public abstract int size(); 





See Also 

Reference 
AbstractList Class 
Concepts 

AbstractList Members 
java.util Package 


Visual J# Reference 


AbstractList.subList Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.List subList( 
int fromIx, 
int toIx); 


Parameters 
fromlx 


tolx 


See Also 

Reference 
AbstractList Class 
Concepts 

AbstractList Members 
java.util Package 


Visual J# Reference 


AbstractMap Class 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public abstract class java.util.AbstractMap 
extends java.lang.Object 
implements java.util.Map 





Inheritance Hierarchy 
java.lang.Object 
java.util AbstractMap 
java.util.HashMap 
java.util. TreeMap 


java.util. WeakHashMap 


See Also 
Concepts 
AbstractMap Members 


java.util Package 


Visual J# Reference 


AbstractMap Members 


The following tables list the members exposed by the AbstractMap type. 


Public Constructors 
Name 


AbstractMap 


Public Methods 


Description 








Name 


Description 





clear 





containsKey 


containsValue 


entrySet 


equals 


get 


hashCode 


getClass 


isEmpty 


keySet 


clone 


put 


putAll 


remove 


size 


toString 


values 





Overridden. 


Overridden. 


(inherited from Object ) 


Overridden. 





Protected Methods 


Name Description 


finalize 








See Also 
Reference 


AbstractMap Class 


(inherited from Object ) 





Concepts 
java.util Package 


Visual J# Reference 


AbstractMap Constructor 


Initializes a new instance of the AbstractMap Class . 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.util.AbstractMap(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
AbstractMap Class 
Concepts 

AbstractMap Members 
java.util Package 


Visual J# Reference 


AbstractMap Methods 


Public Methods 





Name 


Description 





clear 





containsKey 





containsValue 





entrySet 





equals 


get 


hashCode 


getClass 


isEmpty 


keySet 


clone 


put 


putAll 


remove 


size 


toString 


values 


Protected Methods 


Overridden. 


Overridden. 


(inherited from Object ) 


Overridden. 








Name 


Description 





finalize 








(inherited from Object ) 





See Also 
Reference 
AbstractMap Class 
Concepts 

java.util Package 





Visual J# Reference 


AbstractMap.clear Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public void clear(); 





See Also 

Reference 
AbstractMap Class 
Concepts 

AbstractMap Members 
java.util Package 


Visual J# Reference 


AbstractMap.containsKey Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean containsKey( 
java.lang.Object k); 


Parameters 


k 


See Also 

Reference 
AbstractMap Class 
Concepts 

AbstractMap Members 
java.util Package 


Visual J# Reference 


AbstractMap.containsValue Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean containsValue( 
java.lang.Object v); 


Parameters 
V 


See Also 

Reference 
AbstractMap Class 
Concepts 

AbstractMap Members 
java.util Package 


Visual J# Reference 


AbstractMap.entrySet Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.util.Set entrySet(); 


See Also 

Reference 
AbstractMap Class 
Concepts 

AbstractMap Members 
java.util Package 


Visual J# Reference 


AbstractMap.equals Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean equals( 
java.lang.Object c); 


Parameters 
Cc 


See Also 

Reference 
AbstractMap Class 
Concepts 

AbstractMap Members 
java.util Package 


Visual J# Reference 


AbstractMap.get Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object get( 
java.lang.Object k); 





Parameters 


k 


See Also 

Reference 
AbstractMap Class 
Concepts 

AbstractMap Members 
java.util Package 


Visual J# Reference 


AbstractMap.hashCode Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public int hashCode(); 


See Also 

Reference 
AbstractMap Class 
Concepts 

AbstractMap Members 
java.util Package 


Visual J# Reference 


AbstractMap.isEmpty Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean isEmpty(); 


See Also 

Reference 
AbstractMap Class 
Concepts 

AbstractMap Members 
java.util Package 


Visual J# Reference 


AbstractMap.keySet Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Set keySet(); 


See Also 

Reference 
AbstractMap Class 
Concepts 

AbstractMap Members 
java.util Package 


Visual J# Reference 


AbstractMap.put Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object put( 
java.lang.Object k, 
java.lang.Object v); 


Parameters 


k 


See Also 

Reference 
AbstractMap Class 
Concepts 

AbstractMap Members 
java.util Package 


Visual J# Reference 


AbstractMap.putAll Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void putAl11( 
java.util.Map m); 


Parameters 
m 


See Also 

Reference 
AbstractMap Class 
Concepts 

AbstractMap Members 
java.util Package 


Visual J# Reference 


AbstractMap.remove Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object remove( 
java.lang.Object k); 


Parameters 


k 


See Also 

Reference 
AbstractMap Class 
Concepts 

AbstractMap Members 
java.util Package 


Visual J# Reference 


AbstractMap.size Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public int size(); 





See Also 

Reference 
AbstractMap Class 
Concepts 

AbstractMap Members 
java.util Package 


Visual J# Reference 


AbstractMap.toString Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toString(); 


See Also 

Reference 
AbstractMap Class 
Concepts 

AbstractMap Members 
java.util Package 


Visual J# Reference 


AbstractMap.values Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Collection values(); 


See Also 

Reference 
AbstractMap Class 
Concepts 

AbstractMap Members 
java.util Package 


Visual J# Reference 


AbstractSequentialList Class 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract class java.util.AbstractSequentialList 
extends java.util.AbstractList 





Inheritance Hierarchy 
java.lang.Object 
java.util AbstractCollection 
java.util AbstractList 
java.util AbstractSequentialList 
java.util.LinkedList 


See Also 

Concepts 

AbstractSequentialList Members 
java.util Package 


Visual J# Reference 


AbstractSequentialList Members 


The following tables list the members exposed by the AbstractSequentialList type. 


Public Constructors 

































































Name 

AbstractSequentialList 

Public Fields 

Name Description 

modCount (inherited from AbstractList ) 
Public Methods 

Name Description 

add Overloaded. 

addaAll Overloaded. 

clear (inherited from AbstractList ) 
contains (inherited from AbstractCollection ) 
containsAll (inherited from AbstractCollection ) 
equals (inherited from AbstractList ) 

get Overridden. 

hashCode (inherited from AbstractList ) 
getClass (inherited from Object ) 

indexOf (inherited from AbstractList ) 
isEmpty (inherited from AbstractCollection ) 
iterator Overridden. 

lastIndexOf (inherited from AbstractList ) 
listlterator Overloaded. 

clone (inherited from AbstractCollection ) 
remove Overloaded. Overridden. 
removeAll (inherited from AbstractCollection ) 
removeRange (inherited from AbstractList ) 











retainAll (inherited from AbstractCollection ) 





set Overridden. 

size (inherited from AbstractList ) 

subList (inherited from AbstractList ) 

toArray Overloaded. (inherited from AbstractCollection ) 
toString (inherited from AbstractCollection ) 


Protected Methods 





Name Description 





finalize (inherited from Object ) 








See Also 

Reference 
AbstractSequentialList Class 
Concepts 

java.util Package 





Visual J# Reference 


AbstractSequentialList Fields 


Public Fields 





Name Description 





modCount (inherited from AbstractList ) 














See Also 

Reference 
AbstractSequentialList Class 
Concepts 

java.util Package 


Visual J# Reference 


AbstractSequentialList Constructor 


Initializes a new instance of the AbstractSequentialList Class . 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.util.AbstractSequentialList(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
AbstractSequentialList Class 
Concepts 

AbstractSequentialList Members 
java.util Package 


Visual J# Reference 


AbstractSequentialList Methods 


Public Methods 
































Name Description 

add Overloaded. 

addaAll Overloaded. 

clear (inherited from AbstractList ) 
contains (inherited from AbstractCollection ) 
containsAll (inherited from AbstractCollection ) 
equals (inherited from AbstractList ) 

get Overridden. 

hashCode (inherited from AbstractList ) 
getClass (inherited from Object ) 

indexOf (inherited from AbstractList ) 
isEmpty (inherited from AbstractCollection ) 
iterator Overridden. 

lastIndexOf (inherited from AbstractList ) 
listlterator Overloaded. 

clone (inherited from AbstractCollection ) 
remove Overloaded. Overridden. 
removeAll (inherited from AbstractCollection ) 
removeRange (inherited from AbstractList ) 
retainAll (inherited from AbstractCollection ) 
set Overridden. 

size (inherited from AbstractList ) 
subList (inherited from AbstractList ) 
toArray Overloaded. (inherited from AbstractCollection ) 
toString (inherited from AbstractCollection ) 











Protected Methods 





See Also 

Reference 

AbstractS equentialList Class 
Concepts 

java.util Package 


Visual J# Reference 


AbstractSequentialList.add Method 


Overload List 





Name Description 





AbstractSequentialList.add (Object) 





AbstractSequentialList.add (int, Object) 











See Also 

Reference 
AbstractSequentialList Class 
Concepts 

AbstractSequentialList Members 
java.util Package 


Visual J# Reference 


AbstractSequentialList.add Method (Int32, Object) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void add( 
int ix, 
java.lang.Object e); 


Parameters 
ix 


See Also 

Reference 
AbstractSequentialList Class 
Concepts 

AbstractSequentialList Members 
java.util Package 


Visual J# Reference 


AbstractSequentialList.addAll Method 


Overload List 





Name 


Description 





AbstractSequentialList.addAll (Collection) 





AbstractSequentialList.addAll (int, Collection) 











See Also 

Reference 
AbstractSequentialList Class 
Concepts 

AbstractSequentialList Members 
java.util Package 





Visual J# Reference 


AbstractSequentialList.addAll Method (Int32, Collection) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean addA1l( 
int ix, 
java.util.Collection c); 


Parameters 
ix 


See Also 

Reference 
AbstractSequentialList Class 
Concepts 

AbstractSequentialList Members 
java.util Package 


Visual J# Reference 


AbstractSequentialList.get Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object get( 
int ix); 





Parameters 
x 


See Also 

Reference 
AbstractSequentialList Class 
Concepts 

AbstractSequentialList Members 
java.util Package 


Visual J# Reference 


AbstractSequentialList.iterator Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Iterator iterator(); 


See Also 

Reference 
AbstractSequentialList Class 
Concepts 

AbstractSequentialList Members 
java.util Package 


Visual J# Reference 


AbstractSequentialList.listlterator Method 


Overload List 





Name Description 





AbstractSequentialList.listlterator () 





AbstractSequentialList.listlterator (int) 











See Also 

Reference 
AbstractSequentialList Class 
Concepts 

AbstractSequentialList Members 
java.util Package 


Visual J# Reference 


AbstractSequentialList.listlterator Method (Int32) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.util.ListIterator listIterator( 
int ix); 


Parameters 
x 


See Also 

Reference 
AbstractSequentialList Class 
Concepts 

AbstractSequentialList Members 
java.util Package 
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AbstractSequentialList.remove Method 


Overload List 





Name 


Description 





AbstractS equentialList.remove (int) 





AbstractSequentialList.remove (Object) 











See Also 

Reference 
AbstractSequentialList Class 
Concepts 

AbstractSequentialList Members 
java.util Package 
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AbstractSequentialList.remove Method (Int32) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object remove( 
int ix); 


Parameters 
x 


See Also 

Reference 
AbstractSequentialList Class 
Concepts 

AbstractSequentialList Members 
java.util Package 
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AbstractSequentialList.set Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object set( 
int ix, 
java.lang.Object e); 


Parameters 
ix 


See Also 

Reference 
AbstractSequentialList Class 
Concepts 

AbstractSequentialList Members 
java.util Package 


Visual J# Reference 


AbstractSet Class 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public abstract class java.util.AbstractSet 
extends java.util.AbstractCollection 


implements java.util.Set 





Inheritance Hierarchy 
java.lang.Object 
java.util. AbstractCollection 
java.util AbstractSet 
java.util.HashSet 


java.util. TreeSet 


See Also 
Concepts 
AbstractSet Members 


java.util Package 
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AbstractSet Members 


The following tables list the members exposed by the AbstractSet type. 


Public Constructors 























Name 

AbstractSet 

Public Methods 

Name Description 

add (inherited from AbstractCollection ) 
addAll (inherited from AbstractCollection ) 
clear (inherited from AbstractCollection ) 
contains (inherited from AbstractCollection ) 
containsAll (inherited from AbstractCollection ) 
equals Overridden. 

hashCode Overridden. 

getClass (inherited from Object ) 

isEmpty (inherited from AbstractCollection ) 
iterator Overridden. 

clone (inherited from AbstractCollection ) 
remove (inherited from AbstractCollection ) 
removeAll (inherited from AbstractCollection ) 
retainAll (inherited from AbstractCollection ) 
size Overridden. 

toArray Overloaded. (inherited from AbstractCollection ) 
toString (inherited from AbstractCollection ) 
Protected Methods 

Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


AbstractSet Class 





Concepts 
java.util Package 
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AbstractSet Constructor 


Initializes a new instance of the AbstractSet Class . 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.util.AbstractSet(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
AbstractSet Class 
Concepts 

AbstractSet Members 
java.util Package 
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AbstractSet Methods 


Public Methods 



































Name Description 

add (inherited from AbstractCollection ) 
addAll (inherited from AbstractCollection ) 
clear (inherited from AbstractCollection ) 
contains (inherited from AbstractCollection ) 
containsAll (inherited from AbstractCollection ) 
equals Overridden. 

hashCode Overridden. 

getClass (inherited from Object ) 

isEmpty (inherited from AbstractCollection ) 
iterator Overridden. 

clone (inherited from AbstractCollection ) 
remove (inherited from AbstractCollection ) 
removeAll (inherited from AbstractCollection ) 
retainAll (inherited from AbstractCollection ) 
size Overridden. 

toArray Overloaded. (inherited from AbstractCollection ) 
toString (inherited from AbstractCollection ) 
Protected Methods 

Name Description 

finalize (inherited from Object ) 
See Also 

Reference 

AbstractSet Class 

Concepts 


java.util Package 
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AbstractSet.equals Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean equals( 
java.lang.Object c); 





Parameters 
C 


See Also 

Reference 
AbstractSet Class 
Concepts 

AbstractSet Members 
java.util Package 


Visual J# Reference 


AbstractSet.hashCode Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public int hashCode(); 


See Also 

Reference 
AbstractSet Class 
Concepts 

AbstractSet Members 
java.util Package 


Visual J# Reference 


AbstractSet.iterator Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.util.Iterator iterator(); 


See Also 

Reference 
AbstractSet Class 
Concepts 

AbstractSet Members 
java.util Package 


Visual J# Reference 


AbstractSet.size Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public abstract int size(); 





See Also 

Reference 
AbstractSet Class 
Concepts 

AbstractSet Members 
java.util Package 
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ArrayList Class 


Represents a dynamically sized, index-based collection of objects. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public class java.util.ArrayList 
extends java.util.AbstractList 
implements java.util.List, java.lang.Cloneable, java.io.Serializable 


Example 


The following example illustrates the add, remove, size, clear, contains, get, set, and isEmpty methods of the ArrayList class. 


// arraylist_overview.jsl 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
, 
// Create an ArrayList with a capacity for 10 elements. 
ArrayList arrList = new ArrayList(10); 


// Add three elements to the ArrayList. 
arrList.add(new Integer(1)); 
arrList.add(new Integer(2)); 
arrList.add(new Integer(3)); 


// Print the size of the ArrayList. 

int size = arrList.size(); 

System.out.println("arrList contains 
" elements."); 


+ size + 


// Determine if the ArrayList contains an element. 
if (arrList.contains(new Integer(4))) 


{ 
System.out.println("There is already an Integer with " + 
"the value 4 in the ArrayList."); 
} 
else 
{ 
System.out.println("There is no Integer with " + 
"the value 4 in the ArrayList."); 
} 


// Change the value of the second element in the ArrayList. 
arrList.set(1, new Integer(4)); 


// Print out the elements without using an iterator. 
for (int i = @3; i < arrList.size(); i++) 


d 
7 


System.out.println(arrList.get(i)); 


// Remove the second element in the ArrayList. 
Object o = arrList.remove(1); 
System.out.println("Removed " + o.toString()); 


// If the ArrayList is not empty, clear it out now. 
if (l!arrList.isEmpty()) 


arrList.clear(); 


} 
} 
} 
/* 
Output: 


arrList contains 3 elements. 

There is no Integer with the value 4 in the ArrayList. 
1 

4 

3 

Removed 4 


*/ 











Inheritance Hierarchy 
java.lang.Object 
java.util AbstractCollection 
java.util. AbstractList 
java.util ArrayList 


See Also 

Concepts 

ArrayList Members 
java.util Package 
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ArrayList Members 


Represents a dynamically sized, index-based collection of objects. 


The following tables list the members exposed by the ArrayList type. 


Public Constructors 



































Name Description 

ArrayList Overloaded. Creates and initializes a new instance of a ArrayList object. 

Public Fields 

Name Description 

modCount (inherited from AbstractList ) 

Public Methods 

Name Description 

add Overloaded. Overridden. Adds an element to the end of a ArrayList. 

addaAll Overloaded. Overridden. Adds all the items in an existing collection into a ArrayList object. 
clear Overridden. Removes all items from a ArrayList object. 

contains Overridden. Determines whether an element exists in a ArrayList object. 

containsAll (inherited from AbstractCollection ) 

ensureCapacity /Ensures that the length of a ArrayList object will be no smaller than the specified size. 
equals (inherited from AbstractList ) 

get Overridden. Returns the element at the specified index. 

hashCode (inherited from AbstractList ) 

getClass (inherited from Object ) 

indexOf Overridden. Provides the index of an element in a ArrayList object. 

isEmpty Overridden. Determines whether a ArrayList object is empty. 

iterator (inherited from AbstractList ) 

lastindexOf Overridden. Provides the index of the last occurrence of an element in a ArrayList object. 
listlterator Overloaded. (inherited from AbstractList ) 

clone Creates a new instance of a ArrayList object that is a shallow copy of an existing ArrayList object. 
remove Overloaded. Overridden. Removes an element from a ArrayList object. 

removeAll (inherited from AbstractCollection ) 





















































removeRange _|Overridden. Removes all elements within the specified range from a ArrayList object. 
retainAll (inherited from AbstractCollection ) 

set Overridden. Sets an element in a ArrayList object at the specified index. 

size Overridden. Provides the number of elements in a ArrayList object. 

subList (inherited from AbstractList ) 

toArray Overloaded. Overridden. Creates a static array containing the elements of a ArrayList object. 
toString (inherited from AbstractCollection ) 

trimToSize Trims a ArrayList object to the number of elements it contains. 

Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 

ArrayList Class 

Concepts 


java.util Package 
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ArrayList Fields 


Public Fields 





Name Description 





modCount (inherited from AbstractList ) 














See Also 
Reference 
ArrayList Class 
Concepts 
java.util Package 


Visual J# Reference 


ArrayList Constructor 


Creates and initializes a new instance of a ArrayList object. 


Overload List 
Name 


ArrayList () 


ArrayList (Collection) 


Description 


Constructs a ArrayList object. 


Constructs a ArrayList object, and copies all elements from the collection, passed as a parameter, to this 
ArrayList. 





ArrayList (int) 








Constructs a ArrayList object with the specified size. 





See Also 
Reference 
ArrayList Class 
Concepts 

ArrayList Members 
java.util Package 
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ArrayList Constructor () 


Constructs a ArrayList object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.util.ArrayList(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
ArrayList Class 
Concepts 

ArrayList Members 
java.util Package 
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ArrayList Constructor (Collection) 


Constructs a ArrayList object, and copies all elements from the collection, passed as a parameter, to this ArrayList. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.ArrayList( 
java.util.Collection c); 


Parameters 
Cc 


The name of a collection. 


See Also 

Reference 
ArrayList Class 
Concepts 

ArrayList Members 
java.util Package 
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ArrayList Constructor (Int32) 


Constructs a ArrayList object with the specified size. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.ArrayList( 
int initialCapacity); 


Parameters 
initialCapacity 


The initial size of the list. 


See Also 

Reference 
ArrayList Class 
Concepts 

ArrayList Members 
java.util Package 


Visual J# Reference 


ArrayList Methods 


Public Methods 




















ensureCapacity 


equals 


get 


hashCode 


getClass 


indexOf 


isEmpty 


iterator 


lastIndexOf 


listlterator 


MemberwiseClone 


Name Description 

add Overloaded. Overridden. Adds an element to the end of a ArrayList. 

addaAll Overloaded. Overridden. Adds all the items in an existing collection into a ArrayList object. 
clear Overridden. Removes all items from a ArrayList object. 

contains Overridden. Determines whether an element exists in a ArrayList object. 

containsAll (inherited from AbstractCollection ) 


Ensures that the length of a ArrayList object will be no smaller than the specified size. 


(inherited from AbstractList ) 


Overridden. Returns the element at the specified index. 


(inherited from AbstractList ) 


(inherited from Object ) 


Overridden. Provides the index of an element in a ArrayList object. 


Overridden. Determines whether a ArrayList object is empty. 


(inherited from AbstractList ) 


Overridden. Provides the index of the last occurrence of an element in a ArrayList object. 


Overloaded. (inherited from AbstractList ) 


Creates a new instance of a ArrayList object that is a shallow copy of an existing ArrayList object. 











remove Overloaded. Overridden. Removes an element from a ArrayList object. 

removeAll (inherited from AbstractCollection ) 

removeRange Overridden. Removes all elements within the specified range from a ArrayList object. 
retainAll (inherited from AbstractCollection ) 

set Overridden. Sets an element in a ArrayList object at the specified index. 

size Overridden. Provides the number of elements in a ArrayList object. 

subList (inherited from AbstractList ) 





toArray 





Overloaded. Overridden. Creates a static array containing the elements of a ArrayList object. 











toString (inherited from AbstractCollection ) 





trimToSize Trims a ArrayList object to the number of elements it contains. 





Protected Methods 
Name 


finalize (inherited from Object ) 








See Also 
Reference 
ArrayList Class 
Concepts 
java.util Package 
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ArrayList.add Method 


Adds an element to the end of a ArrayList. 


Overload List 


ArrayList.add (Object) Adds an element to a ArrayList. 





ArrayList.add (int, Object) Adds an element to the ArrayList object at a specified index. 


See Also 
Reference 
ArrayList Class 
Concepts 

ArrayList Members 
java.util Package 
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ArrayList.add Method (Object) 


Adds an element to a ArrayList. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean add( 
java.lang.Object e); 


Parameters 
e 


Return Value 
Returns true if the element was successfully added; false otherwise. 
Example 


This example creates a ArrayList object, and adds the even number objects from 0 to 10 to the list. 


// Add1.jsl 
// ArrayList example 


import java.util.*; 


public class MyClass 


. 
public static void main() 
{ 
ArrayList al = new ArrayList(); 
for (int i=@; i<=10; i=i+2) 
{ 
Integer x = new Integer(i); 
al.add(x); 
System.out.println("The list members are: " + al); 
} 
} 
/* 
Output: 
The list members are: [0,2,4,6,8,10] 
mf 
See Also 
Reference 
ArrayList Class 
Concepts 


ArrayList Members 
java.util Package 
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ArrayList.add Method (Int32, Object) 


Adds an element to the ArrayList object at a specified index. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void add( 
int ix, 
java.lang.Object e); 


Parameters 
x 


The index of the element. 


The element to be added. 
Example 


// Add2.js1 
// ArrayList example 


import java.util.*; 


public class MyClass 


{ 
public static void main() 
{ 
ArrayList al = new ArrayList(); 
for (int i=@; i<10; i=i+2) 
{ 
Integer x = new Integer(i); 
al.add(i/2, x); 
System.out.println("Element " + x 
+ " at index " + i/2); 
} 
} 
} 
/* 
Output: 
Element @ at index @ 
Element 2 at index 1 
Element 4 at index 2 
Element 6 at index 3 
Element 8 at index 4 
rf 
See Also 
Reference 
ArrayList Class 
Concepts 


ArrayList Members 
java.util Package 
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ArrayList.addAll Method 


Adds all the items in an existing collection into a ArrayList object. 


Overload List 


ArrayList.addAll (Collection) Adds all the items in an existing collection into a ArrayList object. 





ArrayList.addAll (int, Collection) —|Adds all the items in an existing collection to a ArrayList object at the specified index. 


See Also 
Reference 
ArrayList Class 
Concepts 

ArrayList Members 
java.util Package 
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ArrayList.addAll Method (Collection) 


Adds all the items in an existing collection into a ArrayList object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean addA1l1l( 
java.util.Collection c); 


Parameters 
Cc 


The collection whose items will be added to the ArrayList object. 
Return Value 
Returns true if the elements were successfully added; false otherwise. 
Example 


The following example fills an ArrayList object with the contents of another ArrayList object and a HashSet object. 


// arraylist_addall.jsl 
import java.util.*; 


public class Program 


{ 


public static void main(String[] args) 

if 
// Create an ArrayList containing elements 1, 2, 3. 
ArrayList initialArray = new ArrayList(); 
initialArray.add(new Integer(1)); 
initialArray.add(new Integer(2)); 
initialArray.add(new Integer(3)); 


// Create a HashSet containing elements 4, 5, 6. 
HashSet initialSet = new HashSet(); 
initialSet.add(new Integer(4)); 
initialSet.add(new Integer(5)); 
initialSet.add(new Integer(6)); 


ArrayList newArray = new ArrayList(); 


// Add initialArray to the end of newArray. 
boolean addedArray = newArray.addAll(initialArray) ; 
// Add initialSet to the end of newArray. 

boolean addedSet = newArray.addAll(initialSet) ; 


// newArray now has elements 1, 2, 3, 4, 5, 6. 
for (int i = @; i < newArray.size(); i++) 


{ 


System.out.println("newArray[" + i+ "]: "+ 
newArray.get(i)); 


} 


/* 

Output: 
newArray[@]: 1 
newArray[1]: 2 
newArray[2]: 3 


newArray[3]: 4 
newArray[4]: 5 
newArray[5]: 6 
6 





See Also 
Reference 
ArrayList Class 
Concepts 

ArrayList Members 
java.util Package 
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ArrayList.addAll Method (Int32, Collection) 


Adds all the items in an existing collection to a ArrayList object at the specified index. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean addA1l1l( 
int ix, 
java.util.Collection c); 


Parameters 
x 


The index where the items will be inserted. 


The collection whose items will be added to the ArrayList object. 
Return Value 
Returns true if the items were successfully added; false otherwise. 
Example 


The following example fills an ArrayList object with the contents of another ArrayList object and a HashSet object. 


// arraylist_addall_ 2.jsl 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
i 
// Create an ArrayList containing elements 1, 2, 3. 
ArrayList initialArray = new ArrayList(); 
initialArray.add(new Integer(1)); 
initialArray.add(new Integer(2)); 
initialArray.add(new Integer(3)); 


// Create a HashSet containing elements 4, 5, 6. 
HashSet initialSet = new HashSet(); 
initialSet.add(new Integer(4)); 
initialSet.add(new Integer(5)); 
initialSet.add(new Integer(6)); 


// Create an ArrayList containing elements @, 7. 
ArrayList newArray = new ArrayList(); 
newArray.add(new Integer(@)); 

newArray.add(new Integer(7)); 


// Add initialArray to newArray starting at position 1. 
// (After element @) 

boolean addedArray = newArray.addAl1l(1, initialArray); 
// Add initialSet to newArray starting at position 4. 
// (After element 3) 

boolean addedSet = newArray.addAl1(4, initialSet); 


// newArray now has elements @, 1, 2, 3, 4, 5, 6, 7. 
for (int i = @; i < newArray.size(); i++) 


{ 


System.out.println("newArray[" + i+ "]: "+ 
newArray.get(i)); 


} 


/* 

Output: 
newArray[@]: 
newArray[1]: 
newArray[2]: 
newArray[3]: 
newArray[4]: 
newArray[5]: 
newArray[6]: 
newArray[7]: 
e/ 
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See Also 
Reference 
ArrayList Class 
Concepts 
ArrayList Members 
java.util Package 
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ArrayList.clear Method 


Removes all items from a ArrayList object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void clear(); 


Example 


The following example populates an ArrayList with a few prime numbers and then clears them all from the ArrayList. 


// arraylist_clear.jsl 
import java.util.*; 
public class Program 


public static void main(String[] args) 

{ 
// Fill an array with the prime numbers between 
// 1 and 11. 
ArrayList primeNumbers = new ArrayList(); 
primeNumbers.add(new Integer(1)); 
primeNumbers.add(new Integer(3)); 
primeNumbers.add(new Integer(5)); 
primeNumbers.add(new Integer(7)); 
primeNumbers.add(new Integer(11)); 


// Prints out the prime numbers between 1 and 11. 
System.out.println("Before clear..."); 
for (int i = @; i < primeNumbers.size(); i++) 


{ 


System.out.println("primeNumbers[" + i + "]: + 
primeNumbers.get(i)); 


} 


// Removes all entries from the ArrayList. 
primeNumbers.clear(); 


// Prints no elements. 
System.out.printin("After clear..."); 
for (int i = @; i < primeNumbers.size(); i++) 


{ 


System.out.println("primeNumbers[" + i + "]: + 
primeNumbers.get(i)); 


} 


/* 

Output: 

Before clear... 
primeNumbers[@]: 
primeNumbers[1]: 
primeNumbers[2]: 
primeNumbers[3]: 
primeNumbers[4]: 
After clear... 


*/ 


PN UWP 


See Also 

Reference 
ArrayList Class 
Concepts 

ArrayList Members 
java.util Package 
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ArrayList.contains Method 


Determines whether an element exists in a ArrayList object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean contains ( 
java.lang.Object e); 


Parameters 
e 


The element for which the ArrayList object is to be scanned to determine whether it exists in the collection. 
Return Value 
Returns true if the element exists in the ArrayList object; false otherwise. 
Example 


The following example searches an ArrayList to determine whether it contains various prime numbers. 


// arraylist_contains.jsl 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
if 
// Fill an array with the prime numbers between 
// 1 and 11. 
ArrayList primeNumbers = new ArrayList(); 
primeNumbers.add(new Integer(1)); 
primeNumbers.add(new Integer(3)); 
primeNumbers.add(new Integer(5)); 
primeNumbers.add(new Integer(7)); 
primeNumbers.add(new Integer(11)); 


// Determines whether all the numbers between 1 and 11 
// are prime or not prime. 

for (int i = 13; i <= 11; i++) 

{ 


if (primeNumbers.contains(new Integer(i))) 


{ 
i 
else 


} 


System.out.println(i + " is a prime number."); 


System.out.println(i + " is NOT a prime number."); 


} 


/* 

Output: 

1 is a prime number. 

is NOT a prime number. 
is a prime number. 

is NOT a prime number. 
is a prime number. 

is NOT a prime number. 
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7 is a prime number. 
8 is NOT a prime number. 
9 is NOT a prime number. 
1@ is NOT a prime number. 
11 is a prime number. 


*/ 





See Also 

Reference 
ArrayList Class 
Concepts 

ArrayList Members 
java.util Package 
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ArrayList.ensureCapacity Method 


Ensures that the length of a ArrayList object will be no smaller than the specified size. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void ensureCapacity( 
int minCap); 


Parameters 
minCap 


The minimum length for a ArrayList object. 
Example 
The following example increases the capacity of an ArrayList from 5 to 20 elements. 
// arraylist_ensurecapacity.jsl 
import java.util.*; 
public class Program 


public static void main(String[] args) 


{ 
// Creates an ArrayList with room for only 5 elements. 
ArrayList smallArray = new ArrayList(5)3; 
// Increases the capacity of the ArrayList to 20 elements. 
smallArray.ensureCapacity(2@); 
} 
} 
See Also 
Reference 
ArrayList Class 
Concepts 


ArrayList Members 
java.util Package 
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ArrayList.get Method 


Returns the element at the specified index. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object get( 
int ix); 


Parameters 
ix 

The index of the element to be returned. 
Return Value 
The element at the specified index. 
Example 


The following example creates an ArrayList containing various breeds of dogs. It then calls get passing both valid and invalid 
indices. 


// arraylist_get.jsl 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
i 
// Fill an ArrayList with various breeds of dogs. 
ArrayList dogs = new ArrayList(); 


Dog fido = new Dog("Golden Retriever") ; 
Dog fluffy = new Dog("Poodle"); 
Dog shadow = new Dog("Basenji"); 
Dog miki = new Dog("Yorkshire Terrier"); 


dogs.add(fido) ; 
dogs.add(fluffy) ; 
dogs.add(shadow) ; 
dogs.add(miki) ; 


try 


{ 
// Print out the dogs in the ArrayList. 


// oops, goes beyond the end of the ArrayList. 
for (int i = @; i < 5; i++) 


{ 
} 


System.out.println(dogs.get(i).toString()); 


catch (IndexOutOfBoundsException ex) 
{ 


} 


System.out.println("get was called with an illegal index"); 


} 


public class Dog 


{ 
public Dog(String breed) 


this.breed = breed; 


} 
public String toString() 
i 
return breed; 
} 
private String breed; 
} 
/* 
Output: 
Golden Retriever 
Poodle 
Baseni 


Yorkshire Terrier 
get was called with an illegal index 


a 











See Also 
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ArrayList Class 
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ArrayList.indexOf Method 


Provides the index of an element in a ArrayList object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public int indexOf( 
java.lang.Object e); 


Parameters 
e 


The element whose index is to be returned. 
Return Value 
The index of an element in ArrayList, or -1 if the element does not exist. 
Example 


The following example creates an ArrayList containing various breeds of dogs. It then tries to determine where a certain dog is 
located within the ArrayList. 


// arraylist_indexof.jsl 
import java.util.*; 


public class Program 


{ 


public static void main(String[] args) 

. 
// Fill an ArrayList with various breeds of dogs on exhibit 
// at a dog show. 
ArrayList dogs = new ArrayList(); 


Dog fido = new Dog("Golden Retriever") ; 
Dog fluffy = new Dog("Poodle") ; 
Dog shadow = new Dog("Basenji"); 
Dog miki = new Dog("Yorkshire Terrier") ; 


dogs.add(fido) ; 
dogs.add(fluffy) ; 
dogs.add(shadow) ; 
dogs.add(miki) ; 


// Where are the barkless dogs?. 
int stageNumber = dogs.indexOf(shadow) ; 
if (stageNumber > @) 
System.out.println("Shadow the basenji is on stage " + 
stageNumber) ; 


} 


else 


{ 


System.out.printlin("There are currently no basenjis + 
"being shown."); 


} 


public class Dog 


{ 
public Dog(String breed) 


this.breed = breed; 


} 
public String toString() 
i 
return breed; 
} 
private String breed; 
} 
/* 
Output: 


Shadow the basenji is on stage 2 
th 
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ArrayList.isEmpty Method 


Determines whether a ArrayList object is empty. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public boolean isEmpty(); 





Return Value 
Returns true if a ArrayList object contains no elements; false otherwise. 
Example 


The following example shows how to determine if an ArrayList is empty. 








// arraylist_isempty.jsl 
import java.util.*; 
public class Program 
{ 
public static void main(String[] args) 
if 
// Create an empty ArrayList. 
ArrayList arrList = new ArrayList(); 
if (arrList.isEmpty()) 
{ 
System.out.println("The ArrayList is empty"); 
} 
else 
i 
// Do something useful with the ArrayList. 
; 
} 
} 
See Also 
Reference 
ArrayList Class 
Concepts 


ArrayList Members 
java.util Package 
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ArrayList.lastindexOf Method 


Provides the index of the last occurrence of an element in a ArrayList object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public int lastIndexOf( 
java.lang.Object e); 


Parameters 
e 


The element whose index is to be returned. 
Return Value 
The index of the last occurrence of an element in a ArrayList object, or -1 if the element does not exist. 
Example 


The following example creates an ArrayList containing various breeds of dogs. It then tries to determine where a certain dog is 
located within the ArrayList. 


// arraylist_lastindexof.jsl 
import java.util.*; 


public class Program 


{ 


public static void main(String[] args) 

. 
// Fill an ArrayList with various breeds of dogs on exhibit 
// at a dog show. 
ArrayList dogs = new ArrayList(); 


Dog fido = new Dog("Golden Retriever") ; 
Dog fluffy = new Dog("Poodle") ; 
Dog shadow = new Dog("Basenji"); 
Dog miki = new Dog("Yorkshire Terrier") ; 


dogs.add(fido) ; 
dogs.add(fluffy) ; 
dogs.add(shadow) ; 
dogs.add(miki) ; 


// Where are the barkless dogs?. 
int stageNumber = dogs. lastIndexOf (shadow) ; 
if (stageNumber > @) 
System.out.println("Shadow the basenji is on stage " + 
stageNumber) ; 


} 


else 


{ 


System.out.printlin("There are currently no basenjis + 
"being shown."); 


} 


public class Dog 


{ 
public Dog(String breed) 


this.breed = breed; 


} 
public String toString() 
i 
return breed; 
} 
private String breed; 
} 
/* 
Output: 


Shadow the basenji is on stage 2 
th 
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ArrayList. MemberwiseClone Method 


Creates a new instance of a ArrayList object that is a shallow copy of an existing ArrayList object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


Return Value 


A new instance of ArrayList that is a shallow copy of an existing ArrayList object. The returned object can be safely hard cast to 
a ArrayList object. 


See Also 

Reference 
ArrayList Class 
Concepts 

ArrayList Members 
java.util Package 
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ArrayList.remove Method 


Removes an element from a ArrayList object. 


Overload List 


ArrayList.remove (int) Removes an element at a specified index from ArrayList. 





See Also 
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ArrayList.remove Method (Int32) 


Removes an element at a specified index from ArrayList. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object remove( 
int ix); 


Parameters 
ix 
The index of the element to be removed. 
Return Value 
The element at the position next to the removed element. 
Example 


// Add3.jsl 
// ArrayList example 


import java.util.*; 
public class MyClass 


public static void main() 


{ 
ArrayList al = new ArrayList(); 
for (int i=@; i<10; i=i+2) 
{ 
Integer x = new Integer(i); 
al.add(i/2, x); 
} 
System.out.println("The ArrayList members are: " + al); 
al.remove(2); 
System.out.println("The ArrayList members are now: " + al); 
} 
} 
/* 
Output: 


The ArrayList members are: [0,2,4,6,8] 
The ArrayList members are now: [0,2,6,8] 
ad 


See Also 
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ArrayList.removeRange Method 


Removes all elements within the specified range from a ArrayList object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


protected void removeRange( 
int fromIx, 
int toIx); 


Parameters 
fromlx 


The starting index for the range of elements to be removed. 
tolx 

The ending index for the range of elements to be removed. 
Remarks 
The element at tolx is not included in the elements to be removed. 


See Also 

Reference 
ArrayList Class 
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java.util Package 
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ArrayList.set Method 


Sets an element in a ArrayList object at the specified index. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object set( 
int ix, 
java.lang.Object e); 


Parameters 
x 


The index of the element to be set. 


The element to be set at the specified index. 
Return Value 
The element that previously existed at the specified index. 
Example 


The following example changes an existing element in an ArrayList. 
// arraylist_set.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
i 
// Create an ArrayList containing a simple sentence. 
ArrayList arrList = new ArrayList(); 
arrList.add(new String("Today")); 
arrList.add(new String("is")); 
arrList.add(new String("Thursday") ); 
// Change the day to Friday. 
arrList.set(2, new String("Friday")); 
Iterator iter = arrList.iterator(); 
while (iter.hasNext()) 
{ 
System.out.print(iter.next() + " "); 
} 
} 
} 
/* 
Output: 
Today is Friday 
=] 
See Also 
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ArrayList.size Method 


Provides the number of elements in a ArrayList object. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public int size(); 





Return Value 


The number of elements in a ArrayList object. 


Example 


The following example prints the size of an ArrayList object. 





{ 
{ 
is 
i 
/* 
Output: 
a | 
See Also 
Reference 


// arraylist_size.jsl 
import java.util.*; 
public class Program 


public static void main(String[] args) 


// Create an ArrayList containing elements 1, 2, 3. 
ArrayList initialArray = new ArrayList(); 
initialArray.add(new Integer(1)); 
initialArray.add(new Integer(2)); 
initialArray.add(new Integer(3)); 


// Determine the size of the ArrayList. 

int size = initialArray.size(); 

System.out.println("ArrayList contains 
" elements."); 


+ size + 


ArrayList contains 3 elements. 


ArrayList Class 
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ArrayList.toArray Method 


Creates a static array containing the elements of a ArrayList object. 


Overload List 


ArrayList.toArray () Creates a static array containing the elements of a ArrayList object. 





ArrayList.toArray (Object[]) Adds the elements of a ArrayList object into a static array. 


See Also 
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ArrayList.toArray Method () 


Creates a static array containing the elements of a ArrayList object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object[] toArray(); 


Return Value 
An array containing the elements of a ArrayList object. 
Example 


The following example converts an ArrayList into an array and displays the contents of the array. 
// arraylist_toarray.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create an ArrayList containing elements 1, 2, 3. 
ArrayList initialArray = new ArrayList(); 
initialArray.add(new Integer(1)); 
initialArray.add(new Integer(2)); 
initialArray.add(new Integer(3)); 
// Create an array from the ArrayList. 
Object[] arr = initialArray.toArray(); 
// Display the contents of the array. 
for (int i = @; i < arr.length; i++) 
if (arr[i] instanceof Integer) 
System.out.println(arr[i].toString()); 
} 
} 
} 
} 
/* 
Output: 
1 
2 
3 
say A 
See Also 
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ArrayList.toArray Method (Object[ ]) 


Adds the elements of a ArrayList object into a static array. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object[] toArray( 
java.lang.Object[] arr); 


Parameters 
arr 


The static array where the elements of a ArrayList object are to be added. 
Return Value 
A static array containing the elements of a ArrayList object. 
Example 


The following example replaces the contents of an existing array with the contents of an ArrayList. 


// arraylist_toarray_2.jsl 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
if 
// Create an ArrayList containing elements 1, 2, 3. 
ArrayList initialArray = new ArrayList(); 
initialArray.add(new Integer(1)); 
initialArray.add(new Integer(2)); 
initialArray.add(new Integer(3)); 


// Create an array containing elements 4, 5, 6. 
Object[] arr = { new Integer(4), 

new Integer(5), 

new Integer(6) };3 


// The existing elements in arr are replaced with the 
// contents of the ArrayList. 
arr = initialArray.toArray(arr); 


// Display the contents of the array. 
for (int i = @; i < arr.length; i++) 


if (arr[i] instanceof Integer) 


System.out.printlin(arr[i].toString()); 


} 


/* 
Output: 
1 

2 

3 

7 


See Also 
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ArrayList.trimToSize Method 


Trims a ArrayList object to the number of elements it contains. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void trimToSize(); 


Example 


The following example creates an ArrayList with a capacity of 100 elements. Three elements are then added to the ArrayList 
and the ArrayList is trimmed accordingly. 


// arraylist_trimtosize.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
// Create an ArrayList with capacity 100. 
ArrayList initialArray = new ArrayList(100); 
// Only add three elements to the ArrayList. 
initialArray.add(new Integer(1)); 
initialArray.add(new Integer(2)); 
initialArray.add(new Integer(3)); 
// Trim the ArrayList down to size. 
initialArray.trimToSize(); 
} 
} 
See Also 
Reference 
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Arrays Class 


A class that contains several methods for sorting, searching, filling and comparing arrays. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public class java.util.Arrays 
extends java.lang.Object 





Inheritance Hierarchy 
java.lang.Object 
java.util Arrays 


See Also 
Concepts 
Arrays Members 
java.util Package 
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Arrays Members 


A class that contains several methods for sorting, searching, filling and comparing arrays. 


The following tables list the members exposed by the Arrays type. 


Public Constructors 


















































Name Description 

Arrays Constructs an Arrays object. 
Public Methods 

Name Description 

asList Returns a list view of a specified array object. 
binarySearch Overloaded. 

equals Overloaded. 

equals (inherited from Object ) 
fill Overloaded. 

hashCode (inherited from Object ) 
getClass (inherited from Object ) 
clone 

sort Overloaded. 

toString Overridden. Converts an array to a string. 
Protected Methods 

Name Description 

finalize (inherited from Object ) 
See Also 

Reference 

Arrays Class 
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java.util Package 
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Arrays Constructor 


Constructs an Arrays object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.util.Arrays(); 


Example ——________________céct___§_~" 


// Construct an arrays object: 
Arrays myArray = new Arrays(); 











Remarks 
The default constructor initializes any fields to their default values. 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 
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Arrays Methods 


Public Methods 























Protected Methods 


Name Description 

asList Returns a list view of a specified array object. 
binarySearch Overloaded. 

equals Overloaded. 

equals (inherited from Object) 

fill Overloaded. 

hashCode (inherited from Object ) 

getClass (inherited from Object) 

clone 

sort Overloaded. 

toString Overridden. Converts an array to a string. 








Name 


Description 





finalize 





(inherited from Object) 








See Also 
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Arrays.asList Method 


Returns a list view of a specified array object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static java.util.List asList( 
java.lang.Object[] arr); 


Parameters 
arr 
An array object. 
Return Value 
The list view of the specified array. 
Example 


// Arr-asList1.jsl 
// Arrays.asList example 


import java.util.*; 
public class MyClass 


public static void main() 


{ 
// Declare an object array: 
Object[] myArr = { "Item1", "Item2", "Item3", "Four", "5" }; 
// Niew the array as a list: 
List lst = Arrays.asList(myArr); 
// Display the list: 
System.out.print(1st) ; 
} 
} 
/* 
Output 
[Item1, Item2, Item3, Four, 5] 
=f 
See Also 
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Arrays.binarySearch Method 


Overload List 





Name 


Description 





Arrays.binarySearch (char[], char) 


Searches a char array for a specified character. 





Arrays.binarySearch (double[], double) 


Searches a double array for a specified value using binary search. 





Arrays.binarySearch (short[], short) 


Arrays.binarySearch (int[], int) 


Arrays.binarySearch (long[], long) 


Searches an array of short numbers for a specified value using binary sear 
ch. 


Searches an int array for a specified value. 





Searches a long array for a specified value. 





Arrays.binarySearch (Object[], Object) 


Searches an array of objects for a specified value. 





Arrays.binarySearch (byte[], byte) 


Searches a byte array for a specified value. 





Arrays.binarySearch (float[], float) 


Searches a float array for a specified value. 








Arrays.binarySearch (Object[], Object, Comparator) 


Searches an array of objects for a specified value by using a comparator. 





See Also 
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Arrays.binarySearch Method (CharT J, Char) 


Searches a char array for a specified character. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static int binarySearch( 
char[] arr, 
char e); 


Parameters 
arr 


The array to search within. 


The value to search for. 
Return Value 
The index of the value, or a negative number if the value was not found. 
Example 


// Arr-BinSrch-ch.jsl 
// Arrays.binarySearch example 


import java.util.*; 


public class MyClass 


{ 
public static void main() 
{ 
// Declare and initialize an array: 
char[] myArr = {'1','2','3','4','5'};5 
// Search the array: 
int idx = Arrays.binarySearch(myArr, '2'); 
// Display the result: 
System.out.print("The element " + myArr[idx] + 
"is found at index: " + idx); 
} 
Hy 
/* 
Output: 
The element 2 is found at index: 1 
af 
See Also 
Reference 
Arrays Class 
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Arrays.binarySearch Method (Double[ ], Double) 


Searches a double array for a specified value using binary search. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static int binarySearch( 
double[] arr, 
double e); 


Parameters 
arr 


The array to search within. 


The value to search for. 
Return Value 
The index of the value, or a negative number if the value was not found. 
Example 


// Arr-BinSrch-dbl.jsl 
// Arrays.binarySearch example 


import java.util.*; 


public class MyClass 


{ 
public static void main() 
{ 
// Declare and initialize an array: 
double[] myArr = {1.5,2.5,3.3,4.3,5.2}; 
// Search the array: 
int idx = Arrays.binarySearch(myArr, 3.3); 
// Display the result: 
System.out.print("The element " + myArr[idx] + 
"is found at index: " + idx); 
} 
Hy 
/* 
Output: 
The element 3.3 is found at index: 2 
af 
See Also 
Reference 
Arrays Class 
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Arrays.binarySearch Method (Int16[ J, Int16) 


Searches an array of short numbers for a specified value using binary search. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static int binarySearch( 
short[] arr, 
short e); 


Parameters 
arr 


The array to search within. 


The value to search for. 
Return Value 
The index of the value, or a negative number if the value was not found. 
Example 


// Arr-BinSrch-sh.jsl 
// Arrays.binarySearch example 


import java.util.*; 


public class MyClass 


{ 
public static void main() 
{ 
// Declare an array: 
short[] myArr = new short[5]; 
// Fill with data: 
for (int i=@; i<myArr.length; i++) 
myArr[i] = (short) (i+1); 
// Search the array: 
int idx = Arrays.binarySearch(myArr, (short)3); 
// Display the result: 
System.out.print("The element " + myArr[idx] + 
"is found at index: " + idx); 
} 
} 
/* 
Output: 
The element 3 is found at index: 2 
a7 f 
See Also 
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Arrays.binarySearch Method (Int32[ ], Int32) 


Searches an int array for a specified value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static int binarySearch( 
int[] arr, 
int e); 


Parameters 
arr 


The array to search within. 


The value to search for. 
Return Value 
The index of the value, or a negative number if the value was not found. 
Example 


// Arr-BinSrch-int.jsl 
// Arrays.binarySearch example 


import java.util.*; 


public class MyClass 


{ 
public static void main() 
{ 
// Declare an array: 
intl] myArr = new int[5]; 
// Fill with data: 
for (int i=@; i<myArr.length; i++) 
myArr[i] = i+1; 
// Search the array: 
int idx = Arrays.binarySearch(myArr, 3); 
// Display the result: 
System.out.print("The element " + myArr[idx] + 
"is found at index: " + idx); 
} 
} 
/* 
Output: 
The element 3 is found at index: 2 
a7 f 
See Also 
Reference 
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Arrays.binarySearch Method (Int64[ J, Int64) 


Searches a long array for a specified value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static int binarySearch( 
long[] arr, 
long e); 


Parameters 
arr 


The array to search within. 


The value to search for. 
Return Value 
The index of the value, or a negative number if the value was not found. 
Example 


// Arr-BinSrch-1ng.jsl 
// Arrays.binarySearch example 


import java.util.*; 


public class MyClass 


{ 
public static void main() 
{ 
// Declare an array: 
long[] myArr = new long[5]; 
// Fill with data: 
for (int i=@; i<myArr.length; i++) 
myArr[i] = i+1; 
// Search the array: 
int idx = Arrays.binarySearch(myArr, 3); 
// Display the result: 
System.out.print("The element " + myArr[idx] + 
"is found at index: " + idx); 
} 
} 
/* 
Output: 
The element 3 is found at index: 2 
a7 f 
See Also 
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java.util Package 


Visual J# Reference 


Arrays.binarySearch Method (Object[ ], Object) 


Searches an array of objects for a specified value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static int binarySearch( 
java.lang.Object[] arr, 
java.lang.Object e); 


Parameters 
arr 


The array to search within. 


The value to search for. 
Return Value 
The index of the value, or a negative number if the value was not found. 
Example 


// Arr-BinSrch-ob.jsl 
// Arrays.binarySearch example 


import java.util.*; 


public class MyClass 


{ 
public static void main() 
{ 
// Declare and initialize an object array: 
Object[] myArr = eg oe Arg 5 ps 
// Search the array: 
int idx = Arrays.binarySearch(myArr, "3"); 
// Display the result: 
System.out.print("The element " + myArr[idx] + 
"is found at index: " + idx); 
} 
Hy 
/* 
Output: 
The element 3 is found at index: 2 
af 
See Also 
Reference 
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Arrays.binarySearch Method (SByte[ ], SByte) 


Searches a byte array for a specified value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static int binarySearch( 
byte[] arr, 
byte e); 


Parameters 
arr 


The array to search within. 


The value to search for. 
Return Value 
The index of the value, or a negative number if the value was not found. 
Example 


// Arr-BinSrch-by.jsl 
// Arrays.binarySearch example 


import java.util.*; 


public class MyClass 


{ 
public static void main() 
{ 
// Declare an array: 
byte[] myArr = new byte[5]; 
// Fill with data: 
for (int i=@; i<myArr.length; i++) 
myArr[i] = (byte) (i+1); 
// Search the array: 
int idx = Arrays.binarySearch(myArr, (byte)2); 
// Display the result: 
System.out.print("The element " + myArr[idx] + 
"is found at index: " + idx); 
} 
} 
/* 
Output: 
The element 2 is found at index: 1 
a7 f 
See Also 
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Arrays.binarySearch Method (Single[ ], Single) 


Searches a float array for a specified value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static int binarySearch( 
float[] arr, 
float e); 


Parameters 
arr 


The array to search within. 


The value to search for. 
Return Value 
The index of the value, or a negative number if the value was not found. 
Example 


// Arr-BinSrch-fl.jsl 
// Arrays.binarySearch example 


import java.util.*; 


public class MyClass 


{ 
public static void main() 
{ 
// Declare an array: 
float[] myArr = new float[5]; 
// Fill with data: 
for (int i=@; i<myArr.length; i++) 
myArr[i] = (float) (i+1); 
// Search the array: 
int idx = Arrays.binarySearch(myArr, 3F); 
// Display the result: 
System.out.print("The element " + myArr[idx] + 
"is found at index: " + idx); 
} 
} 
/* 
Output: 
The element 3.0 is found at index: 2 
a7 f 
See Also 
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Arrays.binarySearch Method (Object[ ], Object, Comparator) 


Searches an array of objects for a specified value by using a comparator. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static int binarySearch( 
java.lang.Object[] arr, 
java.lang.Object e, 
java.util.Comparator comp); 


Parameters 
arr 


The array to search within. 


The value to search for. 
comp 
The comparator used in ordering the array. The value null is used for natural order. 
Return Value 
The index of the value, or a negative number if the value was not found. 
Example 


// Arr-BinSrch-obc.jsl 
// Arrays.binarySearch example 


import java.util.*; 


public class MyClass 


{ 
public static void main() 
{ 
// Declare and initialize an object array: 
Object[] myArr a yaa! rma Lede Ware ae ae a 
// Search the array: 
int idx = Arrays.binarySearch(myArr,"3",nul11); 
// Display the result: 
System.out.print("The element " + myArr[idx] + 
"is found at index: " + idx); 
} 
} 
/* 
Output: 
The element 3 is found at index: 2 
#7 
See Also 
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Arrays.equals Method 


Overload List 


























Name Description 

Arrays.equals (boolean{], boolean[]) Checks if two boolean arrays are equal. 
Arrays.equals (char[], char[]) Checks if two char arrays are equal. 
Arrays.equals (doublef[], double[]) Checks if two double arrays are equal. 
Arrays.equals (short[], short[]) Checks if two short arrays are equal. 
Arrays.equals (int[], int[]) Checks if two int arrays are equal. 
Arrays.equals (long[], long[]) Checks if two long arrays are equal. 
Arrays.equals (Object[], Object[]) Checks if two Object arrays are equal. 
Arrays.equals (byte[], byte[]) Checks if two byte arrays are equal. 
Arrays.equals (float[], float[]) Checks if two float arrays are equal. 
See Also 
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Arrays.equals Method (Boolean ], Boolean, ]) 


Checks if two boolean arrays are equal. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static boolean equals( 
boolean[] a1, 
boolean[] a2); 


Parameters 
al 


The first array. 
a2 
The second array. 
Return Value 
true if the two arrays are identical; false otherwise. 
Example 


// Arr-equals-bo.jsl 

// Arrays.equals example 

import java.util.*; 

public class MyClass 

{ 

public static void main() 

{ 

// Declare and initialize two arrays: 
boolean[] myArr1 = {true, false}; 

boolean[] myArr2 = {true, false}; 

// Compare the arrays: 

boolean result = Arrays.equals(myArr1,myArr2) ; 
// Display the result: 
System.out.print("The result is: 
} 

} 

/* 

Output: 

The result is: true 


*/ 


+ result); 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.equals Method (CharT J, CharT ]) 


Checks if two char arrays are equal. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static boolean equals( 
char[] a1, 
char[] a2); 


Parameters 
al 


The first array. 
a2 
The second array. 
Return Value 
true if the two arrays are identical; false otherwise. 
Example 


// Arr-equals-ch.jsl 

// Arrays.equals example 

import java.util.*; 

public class MyClass 

{ 

public static void main() 

{ 

// Declare and initialize two arrays: 

char[] myArri1 = {'A','B'}; 

char[] myArr2 = {'a','b'}; 

// Compare the arrays: 

boolean result = Arrays.equals(myArr1,myArr2) ; 
// Display the result: 
System.out.print("The result is: 
} 

} 

/* 

Output: 

The result is: false 


*/ 


+ result); 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.equals Method (Double[ ], Double[ ]) 


Checks if two double arrays are equal. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static boolean equals( 
double[] a1, 
double[] a2); 


Parameters 
al 


The first array. 
a2 
The second array. 
Return Value 
true if the two arrays are identical; false otherwise. 
Example 


// Arr-equals-db.jsl 

// Arrays.binarySearch example 
import java.util.*; 

public class MyClass 

{ 


public static void main() 


{ 

// Declare and initialize two arrays: 
double[] myArri1 = {3.14,3.14}; 
double[] myArr2 = {3.14,3.14}; 
// Compare the two arrays: 
boolean result = Arrays.equals(myArr1,myArr2) ; 
// Display the result: 
System.out.print("The result is: 
} 
} 
/* 
Output: 
The result is: true 


*/ 


+ result); 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.equals Method (Int16[ ], Int16[ ]) 


Checks if two short arrays are equal. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static boolean equals( 
short[] a1, 
short[] a2); 


Parameters 
al 


The first array. 
a2 
The second array. 
Return Value 
true if the two arrays are identical; false otherwise. 
Example 


// Arr-equals-sh.jsl 

// Arrays.equals example 

import java.util.*; 

public class MyClass 

{ 

public static void main() 

{ 

// Declare and initialize two arrays: 

short[] myArri1 = {123,456}; 

short[] myArr2 = {123,456}; 

// Compare the arrays: 

boolean result = Arrays.equals(myArr1,myArr2) ; 
// Display the result: 
System.out.print("The result is: 
} 

} 

/* 

Output: 

The result is: true 


*/ 


+ result); 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.equals Method (Int32[ ], Int32[ ]) 


Checks if two int arrays are equal. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static boolean equals( 
int[] a1, 
int[] a2); 


Parameters 
al 


The first array. 
a2 
The second array. 
Return Value 
true if the two arrays are identical; false otherwise. 
Example 


// Arr-equals-in.jsl 

// Arrays.equals example 

import java.util.*; 

public class MyClass 

{ 

public static void main() 

{ 

// Declare and initialize two arrays: 

intl] myArri = {123,456}; 

intl] myArr2 = {123,456}; 

// Compare the arrays: 

boolean result = Arrays.equals(myArr1,myArr2) ; 
// Display the result: 
System.out.print("The result is: 
} 

} 

/* 

Output: 

The result is: true 


*/ 


+ result); 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.equals Method (Int64[ ], Int64[ ]) 


Checks if two long arrays are equal. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static boolean equals( 
long[] a1, 
long[] a2); 


Parameters 
al 


The first array. 
a2 
The second array. 
Return Value 
true if the two arrays are identical; false otherwise. 
Example 


// Arr-equals-1ng.jsl 

// Arrays.equals example 

import java.util.*; 

public class MyClass 

{ 

public static void main() 

{ 

// Declare and initialize two arrays: 

long[] myArri1 = {123,456}; 

long[] myArr2 = {123,456}; 

// Compare the arrays: 

boolean result = Arrays.equals(myArr1,myArr2) ; 
// Display the result: 
System.out.print("The result is: 
} 

} 

/* 

Output: 

The result is: true 


*/ 


+ result); 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.equals Method (Object[ J, Object[ ]) 


Checks if two Object arrays are equal. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static boolean equals( 
java.lang.Object[] a1, 
java.lang.Object[] a2); 


Parameters 
al 


The first array. 
a2 
The second array. 
Return Value 
true if the two arrays are identical; false otherwise. 
Example 


// Arr-equals-ob.jsl 

// Arrays.equals example 
import java.util.*; 
public class MyClass 

{ 


public static void main() 

{ 

// Declare and initialize two arrays: 

Object[] myArri = {"123","456"}; 

Object[] myArr2 = {"123","456"}; 

// Compare the arrays: 

boolean result = Arrays.equals(myArr1,myArr2) ; 
// Display the result: 
System.out.print("The result is: 
} 

} 

/* 

Output: 

The result is: true 


*/ 


+ result); 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.equals Method (SByte[ ], SByte[ ]) 


Checks if two byte arrays are equal. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static boolean equals( 
byte[] a1, 
byte[] a2); 


Parameters 
al 


The first array. 
a2 
The second array. 
Return Value 
true if the two arrays are identical; false otherwise. 
Example 


// Arr-equals-by.jsl 

// Arrays.equals example 

import java.util.*; 

public class MyClass 

{ 

public static void main() 

{ 

// Declare and initialize two arrays: 

byte[] myArr1 = {2,1}; 

byte[] myArr2 = {1,2}; 

// Compare the arrays: 

boolean result = Arrays.equals(myArr1,myArr2) ; 
// Display the result: 
System.out.print("The result is: 
} 

} 

/* 

Output: 

The result is: false 


*/ 


+ result); 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.equals Method (Single[ J, Single[ ]) 


Checks if two float arrays are equal. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static boolean equals( 
float[] a1, 
float[] a2); 


Parameters 
al 


The first array. 
a2 
The second array. 
Return Value 
true if the two arrays are identical; false otherwise. 
Example 


// Arr-equals-fl.jsl 

// Arrays.equals example 
import java.util.*; 
public class MyClass 

{ 


public static void main() 

{ 

// Declare and initialize two arrays: 

float[] myArri1 = {123f,456F}; 

float[] myArr2 = {123,456}; 

// Compare the arrays: 

boolean result = Arrays.equals(myArr1,myArr2) ; 
// Display the result: 
System.out.print("The result is: 
} 

} 

/* 

Output: 

The result is: true 


*/ 


+ result); 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.fill Method 


Overload List 





Name 


Description 





Arrays.fill (boolean{], boolean) 


Fills a boolean array with a specific value. 





Arrays.fill (char[], char) 


Fills a char array with a specific value. 





Arrays.fill (double[], double) 


Fills a double array with a specific value. 





Arrays.fill (short[], short) 


Fills a short array with a specific value. 





Arrays.fill (int{], int) 

Arrays.fill (long[], long) 

Arrays.fill (Object[], Object) 
Arrays.fill (byte[], byte) 

Arraysfill (float[], float) 

Arrays.fill (boolean{], int, int, boolean) 
Arrays.fill (char[], int, int, char) 
Arrays.fill (doublef], int, int, double) 
Arrays.fill (short[], int, int, short) 
Arraysill (int[], int, int, int) 
Arrays.fill (long[], int, int, long) 
Arrays.fill (Object[], int, int, Object) 
Arrays.fill (byte[], int, int, byte) 


Arraysill (float[], int, int, float) 





See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Fills an int array with a specific value. 

Fills a long array with a specific value. 

Fills an array of objects with a specific value. 

Fills a byte array with a specific value. 

Fills a float array with a specific value. 

Fills a specified range of an array with a boolean value. 
Fills a specified range of an array with a char value. 
Fills a specified range of an array with a double value. 
Fills a specified range of an array with a short value. 
Fills a specified range of an array with an int value. 
Fills a specified range of an array with a long value. 
Fills a specified range of an array with an Object value. 
Fills a specified range of an array with a byte value. 


Fills a specified range of an array with a float value. 





Visual J# Reference 


Arrays.fill Method (Boolean[ ], Boolean) 


Fills a boolean array with a specific value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void fil11l( 
boolean[] arr, 
boolean val); 


Parameters 
arr 


The array to fill. 
val 

The value of each element. 
Example 


// Arr-fill-bo.jsl 

// Arrays.ill example 

import java.util.*; 

public class MyClass 

x 

public static void main() 

{ 

// Declare an array: 

boolean[] myArr = new boolean[4]; 
// Fill with data: 

Arrays. fill(myArr, true) ; 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 
} 

} 

/* 

Output: 

true true true true 


*/ 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.fill Method (Char[ ], Char) 


Fills a char array with a specific value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void fil11l( 
char[] arr, 
char val); 


Parameters 
arr 


The array to fill. 
val 

The value of each element. 
Example 


// Arr-fill-ch.jsl 

// Arrays.ill example 

import java.util.*; 

public class MyClass 

x 

public static void main() 

{ 

// Declare an array: 

char[] myArr = new char[4]; 

// Fill with data: 

Arrays. fill(myArr, 'J'); 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 
} 

} 

/* 

Output: 

JJjJ 

mf 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.fill Method (Double[ ], Double) 


Fills a double array with a specific value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void fil1l( 
double[] arr, 
double val); 


Parameters 
arr 


The array to fill. 
val 

The value of each element. 
Example 


// Arr-fill-db.jsl 

// Arrays.fill example 

import java.util.*; 

public class MyClass 

x 

public static void main() 

{ 

// Declare an array: 

double[] myArr = new double[4]; 
// Fill with data: 

Arrays. fill(myArr, 3.14); 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 
} 

} 

/* 

Output: 

3.14 3.14 3.14 3.14 

a A 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.fill Method (Int16[ ], Int16) 


Fills a short array with a specific value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void fil11l( 
short[] arr, 
short val); 


Parameters 
arr 


The array to fill. 
val 

The value of each element. 
Example 


// Arr-fill-sh.jsl 

// Arrays.fill example 

import java.util.*; 

public class MyClass 

x 

public static void main() 

{ 

// Declare an array: 

short[] myArr = new short[4]; 

// Fill with data: 

Arrays. fill(myArr, (short)123) ; 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 
} 

} 

/* 

Output: 

123 123 123 123 

ar A 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.fill Method (Int32[ ], Int32) 


Fills an int array with a specific value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void fil11l( 
int[] arr, 
int val); 


Parameters 
arr 


The array to fill. 
val 

The value of each element. 
Example 


// Arr-fill-int.jsl 

// Arrays.ill example 

import java.util.*; 

public class MyClass 

x 

public static void main() 

{ 

// Declare an array: 

int[] myArr = new int[4]; 

// Fill with data: 

Arrays. fill(myArr, 123); 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 
} 

} 

/* 

Output: 

123 123 123 123 

ar A 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.fill Method (Int64[ ], Int64) 


Fills a long array with a specific value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void fil1l( 
long[] arr, 
long val); 


Parameters 
arr 


The array to fill. 
val 

The value of each element. 
Example 


// Arr-fill-1ng.jsl 

// Arrays.fill example 

import java.util.*; 

public class MyClass 

x 

public static void main() 

{ 

// Declare an array: 

long[] myArr = new long[4]; 

// Fill with data: 

Arrays. fill(myArr, 123); 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 
} 

} 

/* 

Output: 

123 123 123 123 

ar A 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.fill Method (Object[ ], Object) 


Fills an array of objects with a specific value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void fil11l( 
java.lang.Object[] arr, 
java.lang.Object val); 


Parameters 
arr 


The array to fill. 
val 

The value of each element. 
Example 


// Arr-fill-ob.jsl 

// Arrays.ill example 

import java.util.*; 

public class MyClass 

x 

public static void main() 

{ 

// Declare an array: 

Object[] myArr = new Object[4]; 
// Fill with data: 

Arrays. fill(myArr, "J#"); 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 
} 

} 

/* 

Output: 

J# J# J# J# 

* ff 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.fill Method (SByte[ ], SByte) 


Fills a byte array with a specific value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void fil11l( 
byte[] arr, 
byte val); 


Parameters 
arr 


The array to fill. 
val 

The value of each element. 
Example 


// Arr-fill-by.jsl 

// Arrays.ill example 

import java.util.*; 

public class MyClass 

x 

public static void main() 

{ 

// Declare an array: 

byte[] myArr = new byte[4]; 

// Fill with data: 

Arrays. fill(myArr, (byte)123); 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 
} 

} 

/* 

Output: 

123 123 123 123 

ar A 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.fill Method (Single[ ], Single) 


Fills a float array with a specific value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void fil1l( 
float[] arr, 
float val); 


Parameters 
arr 


The array to fill. 
val 

The value of each element. 
Example 


// Arr-fill-f1.jsl 

// Arrays.fill example 

import java.util.*; 

public class MyClass 

x 

public static void main() 

{ 

// Declare an array: 

float[] myArr = new float[4]; 

// Fill with data: 

Arrays. fill(myArr, 123); 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 
} 

} 

/* 

Output: 

123.0 123.0 123.0 123.0 

ar A 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.fill Method (Boolean ], Int32, Int32, Boolean) 


Fills a specified range of an array with a boolean value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void fil11( 
boolean[] arr, 
int fromIx, 
int toIx, 
boolean val); 


Parameters 
arr 


The array to fill. 
fromlx 

The starting index (inclusive) of the range. 
tolx 

The ending index (exclusive) of the range. 
val 

The boolean value. 
Example 


// Arr-f1ill-boArr.jsl 

// Arrays.fill example 

import java.util.*; 

public class MyClass 

{ 

public static void main() 

if 

// Declare an array: 

boolean[] myArr = new boolean[5]; 
// Fill with data: 

Arrays. fill(myArr,2,4,true) ; 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 
} 

} 

/* 

Output: 

false false true true false 


*/ 


Remarks 
Throws ArraylndexOutOfBoundsException if the range is invalid. 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.fill Method (Char J, Int32, Int32, Char) 


Fills a specified range of an array with a char value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void fil11l( 
char[] arr, 
int fromIx, 
int toIx, 
char val); 


Parameters 
arr 


The array to fill. 
fromlx 

The starting index (inclusive) of the range. 
tolx 

The ending index (exclusive) of the range. 
val 

The char value. 
Example 


// Arr-fill-chArr.jsl 

// Arrays.fill example 

import java.util.*; 

public class MyClass 

{ 

public static void main() 

i 

// Declare an array: 

char[] myArr = new char[5]; 

// Fill with data: 

Arrays. fill(myArr,2,4,'J'); 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 
} 

} 

/* 

Output: 

JJ 

of 


Remarks 
Throws ArraylndexOutOfBoundsException if the range is invalid. 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.fill Method (Double[ ], Int32, Int32, Double) 


Fills a specified range of an array with a double value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void fil11l( 
double[] arr, 
int fromIx, 
int toIx, 
double val); 


Parameters 
arr 


The array to fill. 
fromlx 

The starting index (inclusive) of the range. 
tolx 

The ending index (exclusive) of the range. 
val 

The double value. 
Example 


// Arr-fill-dbArr.jsl 

// Arrays.fill example 

import java.util.*; 

public class MyClass 

{ 

public static void main() 

i 

// Declare an array: 

double[] myArr = new double[5]; 
// Fill with data: 

Arrays. fill(myArr,2,4,3.14); 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 
} 

} 

/* 

Output: 

0.0 0.0 3.14 3.14 0.0 

=] 


Remarks 
Throws ArraylndexOutOfBoundsException if the range is invalid. 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.fill Method (Int16[ ], Int32, Int32, Int16) 


Fills a specified range of an array with a short value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void fil1l( 
short[] arr, 
int fromIx, 
int toIx, 
short val); 


Parameters 
arr 


The array to fill. 
fromlx 

The starting index (inclusive) of the range. 
tolx 

The ending index (exclusive) of the range. 
val 

The short value. 
Example 


// Arr-fill-shArr.jsl 

// Arrays.fill example 

import java.util.*; 

public class MyClass 

{ 

public static void main() 

if 

// Declare an array: 

short[] myArr = new short[5]; 

// Fill with data: 

Arrays. fill(myArr, 2,4, (short)123) ; 
// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 
} 

} 

/* 

Output: 

@ @ 123 123 @ 

=f 


Remarks 
Throws ArraylndexOutOfBoundsException if the range is invalid. 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.fill Method (Int32[ ], Int32, Int32, Int32) 


Fills a specified range of an array with an int value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void fil11( 
int[] arr, 
int fromIx, 
int toIx, 
int val); 


Parameters 
arr 


The array to fill. 
fromlx 

The starting index (inclusive) of the range. 
tolx 

The ending index (exclusive) of the range. 
val 

The int value. 
Example 


// Arr-fill-intArr.jsl 

// Arrays.fill example 

import java.util.*; 

public class MyClass 

{ 

public static void main() 

x 

// Declare an array: 

intl] myArr = new int[5]; 

// Fill with data: 

Arrays. fill(myArr, 2,4,123); 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 
} 

} 

/* 

Output: 

@ @ 123 123 @ 

=f 


Remarks 
Throws ArraylndexOutOfBoundsException if the range is invalid. 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.fill Method (Int64[ ], Int32, Int32, Int64) 


Fills a specified range of an array with a long value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void fill( 
long[] arr, 
int fromIx, 
int toIx, 
long val); 


Parameters 
arr 


The array to fill. 
fromlx 

The starting index (inclusive) of the range. 
tolx 

The ending index (exclusive) of the range. 
val 

The long value. 
Example 


// Arr-fill-1ngArr.jsl 

// Arrays.fill example 

import java.util.*; 

public class MyClass 

{ 

public static void main() 

i 

// Declare an array: 

long[] myArr = new long[5]; 

// Fill with data: 

Arrays. fill(myArr, 2,4,123); 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 
} 

} 

/* 

Output: 

@ @ 123 123 @ 

=f 


Remarks 
Throws ArraylndexOutOfBoundsException if the range is invalid. 


See Also 
Reference 

Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.fill Method (Object[ J, Int32, Int32, Object) 


Fills a specified range of an array with an Object value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void fill( 
java.lang.Object[] arr, 
int fromIx, 
int toIx, 
java.lang.Object val); 


Parameters 
arr 


The array to fill. 
fromlx 

The starting index (inclusive) of the range. 
tolx 

The ending index (exclusive) of the range. 
val 

The Object value. 
Example 


// Arr-fill-obArr.jsl 

// Arrays.fill example 

import java.util.*; 

public class MyClass 

{ 

public static void main() 

if 

// Declare an array: 

Object[] myArr = new Object[5]; 
// Fill with data: 

Arrays. fill(myArr, 2,4, "J#"); 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 
} 

} 

/* 

Output: 

null null J# J# null 

of 


Remarks 
Throws ArraylndexOutOfBoundsException if the range is invalid. 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.fill Method (SByte[ ], Int32, Int32, SByte) 


Fills a specified range of an array with a byte value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void fill( 
byte[] arr, 
int fromIx, 
int toIx, 
byte val); 


Parameters 
arr 


The array to fill. 
fromlx 

The starting index (inclusive) of the range. 
tolx 

The ending index (exclusive) of the range. 
val 

The byte value. 
Example 


// Arr-fill-byArr.jsl 

// Arrays.fill example 

import java.util.*; 

public class MyClass 

{ 

public static void main() 

if 

// Declare an array: 

byte[] myArr = new byte[5]; 

// Fill with data: 

Arrays. fill(myArr, 2,4, (byte)123); 
// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 
} 

} 

/* 

Output: 

@ @ 123 123 @ 

=f 


Remarks 
Throws ArraylndexOutOfBoundsException if the range is invalid. 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.fill Method (Single[ ], Int32, Int32, Single) 


Fills a specified range of an array with a float value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void fil11l( 
float[] arr, 
int fromIx, 
int toIx, 
float val); 


Parameters 
arr 


The array to fill. 
fromlx 

The starting index (inclusive) of the range. 
tolx 

The ending index (exclusive) of the range. 
val 

The float value. 
Example 


// Arr-fill1-flArr.jsl 

// Arrays.fill example 

import java.util.*; 

public class MyClass 

{ 

public static void main() 

x 

// Declare an array: 

float[] myArr = new float[5]; 

// Fill with data: 

Arrays. fill(myArr, 2,4,123); 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 
} 

} 

/* 

Output: 

0.0 0.0 123.0 123.0 0.0 

=] 


Remarks 
Throws ArraylndexOutOfBoundsException if the range is invalid. 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.sort Method 


Overload List 











Name Description 
Arrays.sort (char[]) Sorts the specified char array in an ascending order. 
Arrays.sort (double[]) Sorts the specified double array in an ascending order. 





Arrays.sort (short[]) 


Sorts the specified short array in an ascending order. 





Arrays.sort (int[]) 


Sorts the specified int array in an ascending order. 





Arrays.sort (long[]) 
Arrays.sort (Object[]) 
Arrays.sort (byte[]) 
Arrays.sort (float[]) 
Arrays.sort (Object[], Comparator) 
Arrays.sort (char[], int, int) 
Arrays.sort (double[], int, int) 
Arrays.sort (short[], int, int) 
Arrays.sort (int[], int, int) 
Arrays.sort (long[], int, int) 
Arrays.sort (Object[], int, int) 
Arrays.sort (byte[], int, int) 
Arrays.sort (float[], int, int) 


Arrays.sort (Object[], int, int, Comparator) 





See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Sorts the specified long array in an ascending order. 


Sorts the specified Object array in an ascending order. 


Sorts the specified byte array in an ascending order. 


Sorts the specified float array in an ascending order. 


Sorts the specified Object array by using a comparator. 


Sorts a specified range of a char array in an ascending order. 


Sorts a specified range of a double array in an ascending order. 


Sorts a specified range of a short array in an ascending order. 


Sorts a specified range of an int array in an ascending order. 


Sorts a specified range of a long array in an ascending order. 


Sorts a specified range of an Object array in an ascending order. 


Sorts a specified range of a byte array in an ascending order. 


Sorts a specified range of a float array in an ascending order. 


Sorts the specified range of an Object array by using a comparator. 








Visual J# Reference 


Arrays.sort Method (CharT J) 


Sorts the specified char array in an ascending order. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void sort( 
char[] arr); 


Parameters 
arr 


The array to be sorted. 
Example 


// Arr-chSrt.jsl 

// Arrays.sort example 
import java.util.*; 
public class MyClass 


public static void main() 

{ 

// Declare an array: 

char[] myArr = {'A','C','B','E','D'}; 
// Sort data: 

Arrays.sort(myArr) ; 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.sort Method (Double[ ]) 


Sorts the specified double array in an ascending order. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void sort( 
double[] arr); 


Parameters 
arr 


The array to be sorted. 
Example 


// Arr-dbSrt.jsl 

// Arrays.sort example 
import java.util.*; 
public class MyClass 


public static void main() 

{ 

// Declare an array: 

double[] myArr = {1,9,7,5,6}; 

// Sort data: 

Arrays.sort(myArr) ; 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 
} 

u 

/* 

Output: 

1.0 5.0 6.0 7.0 9.0 

*/ 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.sort Method (Int16[ ]) 


Sorts the specified short array in an ascending order. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void sort( 
short[] arr); 


Parameters 
arr 


The array to be sorted. 
Example 


// Arr-shSrt.jsl 

// Arrays.sort example 
import java.util.*; 
public class MyClass 


public static void main() 

{ 

// Declare an array: 

short[] myArr = {1,9,7,5,6}; 

// Sort data: 

Arrays.sort(myArr) ; 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.sort Method (Int32) 


Sorts the specified int array in an ascending order. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static void sort( 
int[] arr); 





Parameters 
arr 


The array to be sorted. 


Example 





// Arr-intSrt.jsl 

// Arrays.sort example 
import java.util.*; 
public class MyClass 


public static void main() 

{ 

// Declare an array: 

int[] myArr = {1,9,7,5,6}; 

// Sort data: 

Arrays.sort(myArr) ; 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 





See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 





Visual J# Reference 


Arrays.sort Method (Int64) 


Sorts the specified long array in an ascending order. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void sort( 
long[] arr); 


Parameters 
arr 


The array to be sorted. 
Example 


// Arr-AngSrt.jsl 

// Arrays.sort example 
import java.util.*; 
public class MyClass 


public static void main() 

{ 

// Declare an array: 

long[] myArr = {1,9,7,5,6}; 

// Sort data: 

Arrays.sort(myArr) ; 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.sort Method (Object[ ]) 


Sorts the specified Object array in an ascending order. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void sort( 
java.lang.Object[] arr); 


Parameters 
arr 


The array to be sorted. 
Example 


// Arr-ObSrt.jsl 

// Arrays.sort example 
import java.util.*; 
public class MyClass 


public static void main() 

{ 

// Declare an array: 

Object[] myArr = {"A","1.0","Zoo","Z"}; 
// Sort data: 

Arrays.sort(myArr) ; 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.sort Method (SByte[ ]) 


Sorts the specified byte array in an ascending order. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void sort( 
byte[] arr); 


Parameters 
arr 


The array to be sorted. 
Example 


// Arr-bySrt.jsl 

// Arrays.sort example 
import java.util.*; 
public class MyClass 


public static void main() 

{ 

// Declare an array: 

byte[] myArr = {1,9,7,5,6}; 

// Sort data: 

Arrays.sort(myArr) ; 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.sort Method (Single[ ]) 


Sorts the specified float array in an ascending order. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void sort( 
float[] arr); 


Parameters 
arr 


The array to be sorted. 
Example 


// Arr-f1Srt.jsl 

// Arrays.sort example 
import java.util.*; 
public class MyClass 


public static void main() 

{ 

// Declare an array: 

float[] myArr = {1,9,7,5,6}; 

// Sort data: 

Arrays.sort(myArr) ; 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 
} 

u 

/* 

Output: 

1.0 5.0 6.0 7.0 9.0 

*/ 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.sort Method (Object[ ], Comparator) 


Sorts the specified Object array by using a comparator. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void sort( 
java.lang.Object[] arr, 
java.util.Comparator comp); 


Parameters 
arr 


The array to be sorted. 
comp 

An instance of Comparator. 
Example 


// Arr-ObSrt2.jsl 

// Arrays.sort example 

import java.util.*; 

public class MyClass 

x 

public static void main() 

{ 

// Declare an array: 

Object[] myArr = {"A","1.0","Zoo","Z"}; 
// Sort data: 
Arrays.sort(myArr, null); 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 
} 

} 

/* 

Output: 

1.0 A Z Zoo 

* ff 


Remarks 
If comp is null, the natural order is used in sorting. 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.sort Method (Char[ ], Int32, Int32) 


Sorts a specified range of a char array in an ascending order. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void sort( 
char[] arr, 
int fromIx, 
int toIx); 


Parameters 
arr 


The array to be sorted. 
fromlx 

The starting index (inclusive) of the range. 
tolx 

The ending index (exclusive) of the range. 
Example 


// Arr-chSrtRange.jsl 
// Arrays.sort example 
import java.util.*; 
public class MyClass 

{ 


public static void main() 


// Declare an array: 

char[] myArr = {'A','C','B','E','D'};5 
// Sort data: 
Arrays.sort(myArr, 1,3); 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 
li 

} 

/* 

Output: 

ABCED 

*/ 


Remarks 
Throws ArraylndexOutOfBoundsException if the range is invalid. 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.sort Method (Double[ ], Int32, Int32) 


Sorts a specified range of a double array in an ascending order. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void sort( 
double[] arr, 
int fromIx, 
int toIx); 


Parameters 
arr 


The array to be sorted. 
fromlx 

The starting index (inclusive) of the range. 
tolx 

The ending index (exclusive) of the range. 
Example 


// Arr-dbSrtRange.jsl 
// Arrays.sort example 
import java.util.*; 
public class MyClass 

{ 


public static void main() 


// Declare an array: 

double[] myArr = {1,9,7,5,6}; 

// Sort data: 
Arrays.sort(myArr,1,4); 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 
li 

} 

/* 

Output: 

1.05.0 7.0 9.0 6.0 

* 


Remarks 
Throws ArraylndexOutOfBoundsException if the range is invalid. 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.sort Method (Int16[ ], Int32, Int32) 


Sorts a specified range of a short array in an ascending order. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void sort( 
short[] arr, 
int fromIx, 
int toIx); 


Parameters 
arr 


The array to be sorted. 
fromlx 

The starting index (inclusive) of the range. 
tolx 

The ending index (exclusive) of the range. 
Example 


// Arr-shSrtRange.jsl 
// Arrays.sort example 
import java.util.*; 
public class MyClass 

{ 


public static void main() 


// Declare an array: 

short[] myArr = {1,9,7,5,6}; 

// Sort data: 
Arrays.sort(myArr,1,4); 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 
li 

} 

/* 

Output: 

15796 

*/ 


Remarks 
Throws ArraylndexOutOfBoundsException if the range is invalid. 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.sort Method (Int32[ ], Int32, Int32) 


Sorts a specified range of an int array in an ascending order. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void sort( 
int[] arr, 
int fromIx, 
int toIx); 


Parameters 
arr 


The array to be sorted. 
fromlx 

The starting index (inclusive) of the range. 
tolx 

The ending index (exclusive) of the range. 
Example 


// Arr-intSrtRange.jsl 
// Arrays.sort example 
import java.util.*; 
public class MyClass 

{ 


public static void main() 


// Declare an array: 

int[] myArr = {1,9,7,5,6}; 

// Sort data: 
Arrays.sort(myArr,1,4); 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 
li 

} 

/* 

Output: 

15796 

*/ 


Remarks 
Throws ArraylndexOutOfBoundsException if the range is invalid. 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.sort Method (Int64[ ], Int32, Int32) 


Sorts a specified range of a long array in an ascending order. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void sort( 
long[] arr, 
int fromIx, 
int toIx); 


Parameters 
arr 


The array to be sorted. 
fromlx 

The starting index (inclusive) of the range. 
tolx 

The ending index (exclusive) of the range. 
Example 


// Arr-1ngSrtRange.jsl 
// Arrays.sort example 
import java.util.*; 
public class MyClass 

{ 


public static void main() 


// Declare an array: 

long[] myArr = {1,9,7,5,6}; 

// Sort data: 
Arrays.sort(myArr,1,4); 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 
li 

} 

/* 

Output: 

15796 

*/ 


Remarks 
Throws ArraylndexOutOfBoundsException if the range is invalid. 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.sort Method (Object[ ], Int32, Int32) 


Sorts a specified range of an Object array in an ascending order. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void sort( 
java.lang.Object[] arr, 
int fromIx, 
int toIx); 


Parameters 
arr 


The array to be sorted. 
fromlx 

The starting index (inclusive) of the range. 
tolx 

The ending index (exclusive) of the range. 
Example 


// Arr-ObjSrtRange.jsl 
// Arrays.sort example 
import java.util.*; 
public class MyClass 

{ 


public static void main() 


// Declare an array: 

Object[] myArr = {"A","1.0", "ABC", "Zoo", "Z"}; 
// Sort data: 
Arrays.sort(myArr,1,4); 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 
li 

} 

/* 

Output: 

A 1.@ ABC Zoo Z 

*/ 


Remarks 
Throws ArraylndexOutOfBoundsException if the range is invalid. 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.sort Method (SByte[ J, Int32, Int32) 


Sorts a specified range of a byte array in an ascending order. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void sort( 
byte[] arr, 
int fromIx, 
int toIx); 


Parameters 
arr 


The array to be sorted. 
fromlx 

The starting index (inclusive) of the range. 
tolx 

The ending index (exclusive) of the range. 
Example 


// Arr-bySrtRange.jsl 
// Arrays.sort example 
import java.util.*; 
public class MyClass 

{ 


public static void main() 


// Declare an array: 

byte[] myArr = {1,9,7,5,6}; 

// Sort data: 
Arrays.sort(myArr,1,4); 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 
li 

} 

/* 

Output: 

15796 

*/ 


Remarks 
Throws ArraylndexOutOfBoundsException if the range is invalid. 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.sort Method (Single[ ], Int32, Int32) 


Sorts a specified range of a float array in an ascending order. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void sort( 
float[] arr, 
int fromIx, 
int toIx); 


Parameters 
arr 


The array to be sorted. 
fromlx 

The starting index (inclusive) of the range. 
tolx 

The ending index (exclusive) of the range. 
Example 


// Arr-f1SrtRange.jsl 
// Arrays.sort example 
import java.util.*; 
public class MyClass 

{ 


public static void main() 


// Declare an array: 

float[] myArr = {1,9,7,5,6}; 

// Sort data: 
Arrays.sort(myArr,1,4); 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 
li 

} 

/* 

Output: 

1.05.0 7.0 9.0 6.0 

* 


Remarks 
Throws ArraylndexOutOfBoundsException if the range is invalid. 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


Arrays.sort Method (Object[ ], Int32, Int32, Comparator) 


Sorts the specified range of an Object array by using a comparator. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void sort( 
java.lang.Object[] arr, 
int fromIx, 
int toIx, 
java.util.Comparator comp); 


Parameters 
arr 


The array to be sorted. 
fromlx 

The starting index (inclusive) of the range. 
tolx 

The ending index (exclusive) of the range. 
comp 

An instance of Comparator. 
Example 


// Arr-ObjSrtRangecom. jsl 

// Arrays.sort example 

import java.util.*; 

public class MyClass 

{ 

public static void main() 

if 

// Declare an array: 

Object[] myArr = {"A","1.0", "ABC", "Zoo", "Z"}; 
// Sort data: 
Arrays.sort(myArr,1,4,null1); 

// Display the array: 

for(int i=@; i<myArr.length; i++) 
System.out.print(myArr[i] + " "); 
} 

} 

/* 

Output: 

A 1.0 ABC Zoo Z 

af 


Remarks 
Throws ArraylndexOutOfBoundsException if the range is invalid. 
If comp is null, the natural order is used in sorting. 


See Also 
Reference 
Arrays Class 
Concepts 

Arrays Members 
java.util Package 


Visual J# Reference 


BitSet Class (J#) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public class java.util.BitSet 
extends java.lang.Object 
implements java.lang.Cloneable, java.io.Serializable 





Inheritance Hierarchy 
java.lang.Object 
java.util BitSet 


See Also 
Concepts 
BitSet Members 
java.util Package 


Visual J# Reference 


BitSet Members (J#) 


The following tables list the members exposed by the BitSet type. 


Public Constructors 


Name 


BitSet 


Public Methods 








Name 


Description 





and 





andNot 


clear 


equals 


get 


hashCode 


getClass 


length 


MemberwiseClone 


or 


set 


size 


toString 


xor 


Protected Methods 


Overridden. 


Overridden. 


(inherited from Object ) 


Overridden. 








Name 


Description 





finalize 








(inherited from Object ) 





See Also 
Reference 

BitSet Class 
Concepts 
java.util Package 





Visual J# Reference 


BitSet Constructor 


Overload List 





Name 


Description 





BitSet () 





BitSet (int) 











See Also 
Reference 

BitSet Class 
Concepts 

BitSet Members 
java.util Package 





Visual J# Reference 


BitSet Constructor () 


Initializes a new instance of the BitSet Class . 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.util.BitSet(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 
Reference 

BitSet Class 
Concepts 

BitSet Members 
java.util Package 


Visual J# Reference 


BitSet Constructor (Int32) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.BitSet( 


int nbits); 





Parameters 
nbits 


See Also 
Reference 

BitSet Class 
Concepts 

BitSet Members 
java.util Package 


Visual J# Reference 


BitSet Methods 


Public Methods 





Name 


Description 





and 





andNot 





clear 





equals 


Overridden. 





get 


hashCode 


getClass 


length 


clone 


or 


set 


size 


toString 


xor 


Protected Methods 


Overridden. 


(inherited from Object ) 


Overridden. 








Name 


Description 





finalize 








(inherited from Object ) 





See Also 
Reference 

BitSet Class 
Concepts 
java.util Package 





Visual J# Reference 


BitSet.and Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void and( 


java.util.BitSet bs); 





Parameters 


bs 


See Also 
Reference 

BitSet Class 
Concepts 

BitSet Members 
java.util Package 


Visual J# Reference 


BitSet.andNot Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void andNot( 


java.util.BitSet bs); 





Parameters 


bs 


See Also 
Reference 

BitSet Class 
Concepts 

BitSet Members 
java.util Package 
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BitSet.clear Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void clear( 


int pos); 





Parameters 
pos 


See Also 
Reference 

BitSet Class 
Concepts 

BitSet Members 
java.util Package 


Visual J# Reference 


BitSet. MemberwiseClone Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


See Also 
Reference 

BitSet Class 
Concepts 

BitSet Members 
java.util Package 


Visual J# Reference 


BitSet.equals Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean equals( 


java.lang.Object obj); 





Parameters 


obj 


See Also 
Reference 

BitSet Class 
Concepts 

BitSet Members 
java.util Package 


Visual J# Reference 


BitSet.get Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean get( 


int pos); 





Parameters 
pos 


See Also 
Reference 

BitSet Class 
Concepts 

BitSet Members 
java.util Package 


Visual J# Reference 


BitSet.hashCode Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public int hashCode(); 


See Also 
Reference 

BitSet Class 
Concepts 

BitSet Members 
java.util Package 


Visual J# Reference 


BitSet.length Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public int length(); 





See Also 
Reference 

BitSet Class 
Concepts 

BitSet Members 
java.util Package 


Visual J# Reference 


BitSet.or Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void or( 


java.util.BitSet bs); 





Parameters 


bs 


See Also 
Reference 

BitSet Class 
Concepts 

BitSet Members 
java.util Package 


Visual J# Reference 


BitSet.set Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void set( 


int pos); 





Parameters 
pos 


See Also 
Reference 

BitSet Class 
Concepts 

BitSet Members 
java.util Package 


Visual J# Reference 


BitSet.size Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public int size(); 





See Also 
Reference 

BitSet Class 
Concepts 

BitSet Members 
java.util Package 


Visual J# Reference 


BitSet.toString Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toString(); 


See Also 
Reference 

BitSet Class 
Concepts 

BitSet Members 
java.util Package 


Visual J# Reference 


BitSet.xor Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void xor( 


java.util.BitSet bs); 





Parameters 


bs 


See Also 
Reference 

BitSet Class 
Concepts 

BitSet Members 
java.util Package 
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Calendar Class 


Contains methods and members to perform basic operations involving days, weeks, months, and years. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public abstract class java.util.Calendar 
extends java.lang.Object 
implements java.io.Serializable, java.lang.Cloneable 





Inheritance Hierarchy 
java.lang.Object 
java.util.Calendar 
java.util.GregorianCalendar 


See Also 

Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar Members 


Contains methods and members to perform basic operations involving days, weeks, months, and years. 


The following tables list the members exposed by the Calendar type. 


Public Constructors 





Name Description 





Calendar Overloaded. 








Public Fields 























Name Description 

AM A constant indicating that the time is ante meridiem (before noon). 
AM_PM A constant representing the appropriate AM or PM value. 

APRIL A constant representing the month of April. 

areFieldsSet Determines whether all the fields of a Calendar object are set. 
AUGUST A constant representing the month of August. 

DATE A constant representing the date. 

DAY_OF_MONTH A constant representing the day of the month. 

DAY_OF_WEEK A constant representing the day of the week. 





DAY_OF_WEEK_IN_MONTH |A constant representing a value for how many times a given day has occurred in the month. 























DAY_OF_YEAR A constant representing the day of the year. 

DECEMBER A constant representing the month of December. 

DST_OFFSET A constant representing the offset for daylight savings time in milliseconds. 
ERA A constant representing the appropriate era (either AD or BC). 

FEBRUARY A constant representing the month of February. 

FIELD_COUNT A constant representing the number of fields that can be set. 

fields An array of all the fields that can be set. 

FRIDAY A constant representing the day Friday. 

HOUR A constant representing the hour. 

HOUR_OF_DAY A constant representing the hour of the day. 


isSet An array of boolean values indicating which fields are set and which fields are not set. 



































isTimeSet A value indicating whether the time is set. 
JANUARY A constant representing the month of January. 
JULY A constant representing the month of July. 

JUNE A constant representing the month of June. 
MARCH A constant representing the month of March. 
MAY A constant representing the month of May. 
MILLISECOND A constant representing the milliseconds. 
MINUTE A constant representing the minutes. 

MONDAY A constant representing the day Monday. 
MONTH A constant representing the month. 

NOVEMBER A constant representing the month of November. 
OCTOBER A constant representing the month of October. 
PM A constant indicating that the time is post meridiem (after noon). 
SATURDAY A constant representing the day Saturday. 
SECOND A constant representing the seconds. 

SEPTEMBER A constant representing the month of September. 
SUNDAY A constant representing the day Sunday. 
THURSDAY A constant representing the day Thursday. 

time A field containing the time in milliseconds. 
TUESDAY A constant representing the day Tuesday. 
UNDECIMBER A constant representing the thirteenth month of the year for calendars that have 13 months. 
WEDNESDAY A constant representing the day Wednesday. 


WEEK_OF_MONTH 


A constant representing the week of the month. 





WEEK_OF_YEAR 


A constant representing the week of the year. 





YEAR 


A constant representing the year. 





ZONE_OFFSET 





A constant representing the offset for the time zone in milliseconds. 








Public Methods 








Name 


Description 














add Adds the specified amount of time to a calendar field. 

after Determines whether the date-time in an instance of a Calendar object is after the date-time in the 
calendar specified. 

before Determines whether the date-time in an instance of a Calendar object is before the date-time in t 
he calendar specified. 

clear Overloaded. Clears the fields of an instance of a Calendar object. 

complete Sets all the fields of an instance of a Calendar object. 





computeFields 


Computes values for all the fields of an instance of a Calendar object. 





computeTime 


equals 


get 


getAvailableLocales 


getFirstDayOfWeek 


getGreatestMinimum 


hashCode 


getlnstance 


getLeastMaximum 


getMaximum 


getMinimalDaysInFirstWeek 


getMinimum 


getTime 


getTimelnMillis 


getTimeZone 


Computes the time for a current instance of a Calendar object. 


Overridden. Determines whether two Calendar objects are equal. 


Gets the value of the specified field. 


Gets an array of all the Locale values that are available. 


Gets a value representing the first day of the week. 


Gets a value representing the greatest possible minimum value for a given field. 


(inherited from Object ) 


Overloaded. 


Gets a value representing the smallest possible maximum value for a given field. 


Gets a value representing the maximum value for a given field. 


Gets a value representing the minimal number of days for the first week of the calendar year. 


Gets a value representing the minimum value for a given field. 


Gets a Date representing the time of a Calendar object. 


Gets the time of a Calendar object represented in milliseconds. 


Gets the TimeZone of a Calendar object. 














getClass (inherited from Object ) 

internalGet Gets the value of a given field. 

isLenient Determines whether a given Calendar is lenient. 
isSet Determines whether a given field is set. 














MemberwiseClone 





roll Modifies the value of a given field by one. 

set Overloaded. Sets various fields of a Calendar object. 
setFirstDayOfWeek Sets a value representing the first day of the week. 

setLenient Sets a value that determines whether a given Calendar is lenient. 


setMinimalDaysInFirstWeek|Sets a value representing the minimal number of days for the first week of the calendar year. 








setTime Sets the time of a Calendar object to the given Date. 

setTimelnMillis Sets the time of a Calendar object to a value represented in milliseconds. 
setTimeZone Sets the TimeZone of a Calendar object. 

toString Overridden. Generates a human readable representation of a Calendar object. 








Protected Methods 


Name Description 


finalize (inherited from Object ) 








See Also 
Reference 
Calendar Class 
Concepts 
java.util Package 
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Calendar Fields 


Public Fields 














Name Description 

AM A constant indicating that the time is ante meridiem (before noon). 
AM_PM A constant representing the appropriate AM or PM value. 

APRIL A constant representing the month of April. 





areFieldsSet 


Determines whether all the fields of a Calendar object are set. 





AUGUST 


DATE 


DAY_OF_MONTH 


DAY_OF_WEEK 


DAY_OF_WEEK_IN_MONTH 


A constant representing the month of August. 


A constant representing the date. 


A constant representing the day of the month. 


A constant representing the day of the week. 


A constant representing a value for how many times a given day has occurred in the month. 














DAY_OF_YEAR A constant representing the day of the year. 

DECEMBER A constant representing the month of December. 

DST_OFFSET A constant representing the offset for daylight savings time in milliseconds. 
ERA A constant representing the appropriate era (either AD or BC). 

FEBRUARY A constant representing the month of February. 

FIELD_COUNT A constant representing the number of fields that can be set. 

fields An array of all the fields that can be set. 

FRIDAY A constant representing the day Friday. 

HOUR A constant representing the hour. 

HOUR_OF_DAY A constant representing the hour of the day. 

isSet An array of boolean values indicating which fields are set and which fields are not set. 
isTimeSet A value indicating whether the time is set. 

JANUARY A constant representing the month of January. 

JULY A constant representing the month of July. 

JUNE A constant representing the month of June. 









































See Also 
Reference 
Calendar Class 
Concepts 
java.util Package 


MARCH A constant representing the month of March. 

MAY A constant representing the month of May. 

MILLISECOND A constant representing the milliseconds. 

MINUTE A constant representing the minutes. 

MONDAY A constant representing the day Monday. 

MONTH A constant representing the month. 

NOVEMBER A constant representing the month of November. 

OCTOBER A constant representing the month of October. 

PM A constant indicating that the time is post meridiem (after noon). 
SATURDAY A constant representing the day Saturday. 

SECOND A constant representing the seconds. 

SEPTEMBER A constant representing the month of September. 

SUNDAY A constant representing the day Sunday. 

THURSDAY A constant representing the day Thursday. 

time A field containing the time in milliseconds. 

TUESDAY A constant representing the day Tuesday. 

UNDECIMBER A constant representing the thirteenth month of the year for calendars that have 13 months. 
WEDNESDAY A constant representing the day Wednesday. 

WEEK_OF_MONTH A constant representing the week of the month. 

WEEK_OF_YEAR A constant representing the week of the year. 

YEAR A constant representing the year. 

ZONE_OFFSET A constant representing the offset for the time zone in milliseconds. 








Visual J# Reference 


Calendar.AM Field 


A constant indicating that the time is ante meridiem (before noon). 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final int AM; 





See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar.AM PM Field 


A constant representing the appropriate AM or PM value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final int AM_PM; 





See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar.APRIL Field 


A constant representing the month of April. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final int APRIL; 


Example 


// cal-month1.jsl 
// Calendar months example 


import java.util.*; 


public class MyClass 


Calendar cal = Calendar.getInstance(); 


the months as constants: 


JANUARY) ; 
FEBRUARY) ; 
MARCH) ; 


APRIL); 


MAY); 
JUNE) ; 
JULY); 


. AUGUST) ; 


SEPTEMBER) ; 
OCTOBER) ; 
NOVEMBER) ; 
DECEMBER) ; 


{ 
public static void main(String[] args) 
i 
// Create a calendar object: 
// Display 
System.out.println(cal. 
System.out.println(cal. 
System.out.printin(cal. 
System.out.println(cal 
System.out.println(cal. 
System.out.println(cal. 
System.out.printin(cal. 
System.out.println(cal 
System.out.println(cal. 
System.out.println(cal. 
System.out.printin(cal. 
System.out.printin(cal. 
} 
} 
/* 
Output: 
4) 
1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
*/ 
See Also 
Reference 
Calendar Class 
Concepts 


Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.areFieldsSet Field 


Determines whether all the fields of a Calendar object are set. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


protected boolean areFieldsSet; 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar.AUGUST Field 


A constant representing the month of August. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final int AUGUST; 





Example 
See the example on APRIL. 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.DATE Field 


A constant representing the date. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final int DATE; 





See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar.DAY OF MONTH Field 


A constant representing the day of the month. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final int DAY_OF_MONTH; 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.DAY OF WEEK Field 


A constant representing the day of the week. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final int DAY_OF_WEEK; 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.DAY_OF_WEEK_IN_MONTH Field 


A constant representing a value for how many times a given day has occurred in the month. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final int DAY_OF_WEEK_IN_ MONTH; 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.DAY OF YEAR Field 


A constant representing the day of the year. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final int DAY_OF_YEAR; 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar.DECEMBER Field 


A constant representing the month of December. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final int DECEMBER; 


Example 
See the example on APRIL. 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.DST OFFSET Field 


A constant representing the offset for daylight savings time in milliseconds. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final int DST_OFFSET; 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar.ERA Field 


A constant representing the appropriate era (either AD or BC). 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final int ERA; 


Example ——________________c_c_t___§__~ 


// cal-erai.jsl 
// Calendar.ERA example 


import java.util.*; 


public class MyClass 
{ 
public static void main(String[] args) 
{ 
// Display the era as a constant: 
System.out.print1ln(Calendar.getInstance().ERA); // @ 


} 


/* 
Output: 
2) 

*/ 








See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar.FEBRUARY Field 


A constant representing the month of February. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final int FEBRUARY; 


Example 
See the example on APRIL. 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.FIELD COUNT Field 


A constant representing the number of fields that can be set. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final int FIELD COUNT; 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.fields Field 


An array of all the fields that can be set. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





protected int[] fields; 





See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar.FRIDAY Field 


A constant representing the day Friday. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final int FRIDAY; 


Example 


// cal-days1.jsl 
// Calendar days example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Create a calendar object: 
Calendar cal = Calendar.getInstance(); 
// Display the months as constants: 
System.out.println("Days of the week:"); 
System.out.println(cal.SUNDAY) ; 
System.out.println(cal.MONDAY) ; 
System.out.println(cal. TUESDAY) ; 
System.out.println(cal.WEDNESDAY) ; 
System.out.println(cal. THURSDAY) ; 
System.out.println(cal. FRIDAY) ; 
System.out.println(cal.SATURDAY) ; 
i 
} 
/ * 
Output: 
Days of the week: 
1 
2 
3 
4 
5 
6 
7 
* 
See Also 
Reference 
Calendar Class 
Concepts 


Calendar Members 
java.util Package 
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Calendar.HOUR Field 


A constant representing the hour. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final int HOUR; 





See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar.HOUR_OF_DAY Field 


A constant representing the hour of the day. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final int HOUR_OF_DAY; 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar.isSet Field 


An array of boolean values indicating which fields are set and which fields are not set. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





protected boolean[] isSet; 





See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar.isTimeSet Field 


A value indicating whether the time is set. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





protected boolean isTimeSet; 





See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar.JANUARY Field 


A constant representing the month of January. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final int JANUARY; 


Example 
See the example on APRIL. 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.JULY Field 


A constant representing the month of July. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final int JULY; 





Example 
See the example on APRIL. 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.JUNE Field 


A constant representing the month of June. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final int JUNE; 





Example 
See the example on APRIL. 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar.MARCH Field 


A constant representing the month of March. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final int MARCH; 





Example 
See the example on APRIL. 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar.MAY Field 


A constant representing the month of May. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final int MAY; 





Example 
See the example on APRIL. 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar.MILLISECOND Field 


A constant representing the milliseconds. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final int MILLISECOND; 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.MINUTE Field 


A constant representing the minutes. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final int MINUTE; 





See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar. MONDAY Field 


A constant representing the day Monday. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final int MONDAY; 


Example 
See the example on FRIDAY. 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar.MONTH Field 


A constant representing the month. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final int MONTH; 





See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.NOVEMBER Field 


A constant representing the month of November. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final int NOVEMBER; 


Example 
See the example on APRIL. 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar.OCTOBER Field 


A constant representing the month of October. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final int OCTOBER; 


Example 
See the example on APRIL. 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar.PM Field 


A constant indicating that the time is post meridiem (after noon). 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final int PM; 





See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar.SATURDAY Field 


A constant representing the day Saturday. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final int SATURDAY; 


Example 
See the example on FRIDAY. 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar.SECOND Field 


A constant representing the seconds. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final int SECOND; 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar.SEPTEMBER Field 


A constant representing the month of September. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final int SEPTEMBER; 


Example 
See the example on APRIL. 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar.SUNDAY Field 


A constant representing the day Sunday. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final int SUNDAY; 





Example 
See the example on FRIDAY. 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar. THURSDAY Field 


A constant representing the day Thursday. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final int THURSDAY; 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar.time Field 


A field containing the time in milliseconds. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





protected long time; 





See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar. TUESDAY Field 


A constant representing the day Tuesday. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final int TUESDAY; 





Example 
See the example on FRIDAY. 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar. UNDECIMBER Field 


A constant representing the thirteenth month of the year for calendars that have 13 months. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final int UNDECIMBER; 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar.WEDNESDAY Field 


A constant representing the day Wednesday. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final int WEDNESDAY; 


Example 
See the example on FRIDAY. 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar. WEEK_OF_MONTH Field 


A constant representing the week of the month. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final int WEEK_OF_MONTH; 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar.WEEK_OF_YEAR Field 


A constant representing the week of the year. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final int WEEK_OF_YEAR; 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.YEAR Field 


A constant representing the year. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final int YEAR; 





See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.ZONE OFFSET Field 


A constant representing the offset for the time zone in milliseconds. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final int ZONE_OFFSET; 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar Constructor 


Overload List 





Name Description 





Calendar () Constructs a new instance of a Calendar object. 





Calendar (TimeZone, Locale) |Constructs a new instance of a Calendar object using the provided TimeZone and Locale. 














See Also 
Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar Constructor () 


Constructs a new instance of a Calendar object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





protected java.util.Calendar(); 


Example ——________________c_c_t___§__~ 


// Create a calendar object: 

Calendar cal = Calendar.getInstance(); 
// or use a subclass: 

Calendar cal = new GregorianCalendar(); 








Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar Constructor (TimeZone, Locale) 


Constructs a new instance of a Calendar object using the provided TimeZone and Locale. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


protected java.util.Calendar( 
java.util.TimeZone tz, 
java.util.Locale loc); 


Parameters 
tz 


The Timezone that the Calendar will be initialized with. 
loc 
The Locale that the Calendar will be initialized with. 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar Meth 


Public Methods 


ods 














computeFields 


computeTime 


equals 


get 


getAvailableLocales 


getFirstDayOfWeek 


getGreatestMinimum 


hashCode 


getinstance 


getLeastMaximum 


getMaximum 


getMinimalDaysInFirstWeek 


getMinimum 


getTime 


Name Description 

add Adds the specified amount of time to a calendar field. 

after Determines whether the date-time in an instance of a Calendar object is after the date-time in the 
calendar specified. 

before Determines whether the date-time in an instance of a Calendar object is before the date-time in t 
he calendar specified. 

clear Overloaded. Clears the fields of an instance of a Calendar object. 

complete Sets all the fields of an instance of a Calendar object. 


Computes values for all the fields of an instance of a Calendar object. 


Computes the time for a current instance of a Calendar object. 


Overridden. Determines whether two Calendar objects are equal. 


Gets the value of the specified field. 


Gets an array of all the Locale values that are available. 


Gets a value representing the first day of the week. 


Gets a value representing the greatest possible minimum value for a given field. 


(inherited from Object ) 


Overloaded. 


Gets a value representing the smallest possible maximum value for a given field. 


Gets a value representing the maximum value for a given field. 


Gets a value representing the minimal number of days for the first week of the calendar year. 


Gets a value representing the minimum value for a given field. 


Gets a Date representing the time of a Calendar object. 





getTimelnMillis 


Gets the time of a Calendar object represented in milliseconds. 





getTimeZone 


Gets the TimeZone of a Calendar object. 





getClass 


(inherited from Object ) 





internalGet 





Gets the value of a given field. 














isLenient 


Determines whether a given Calendar is lenient. 





isSet 


Determines whether a given field is set. 





MemberwiseClone 





roll 


Modifies the value of a given field by one. 





set 


Overloaded. Sets various fields of a Calendar object. 





setFirstDayOfWeek 


Sets a value representing the first day of the week. 





setLenient 


Sets a value that determines whether a given Calendar is lenient. 





setMinimalDaysInFirstWeek 


setTime 


setTimelnMillis 


setTimeZone 


toString 





Protected Methods 


Sets a value representing the minimal number of days for the first week of the calendar year. 
Sets the time of a Calendar object to the given Date. 

Sets the time of a Calendar object to a value represented in milliseconds. 

Sets the TimeZone of a Calendar object. 


Overridden. Generates a human readable representation of a Calendar object. 








Name 


Description 





finalize 





(inherited from Object ) 








See Also 
Reference 
Calendar Class 
Concepts 
java.util Package 








Visual J# Reference 


Calendar.add Method 


Adds the specified amount of time to a calendar field. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public abstract void add( 
int fld, 
int amount); 





Parameters 


fld 
The field to be modified. 
amount 


The amount to add to the above field. 


Example OT 











// cal-add1.jsl 
// Calendar.add example 
import java.util.*; 
public class MyClass 
{ 
public static void main(String[] args) 
sf 
// Construct a calendar: 
Calendar cal = new GregorianCalendar(); 
// Add 4 years to the current calendar: 
cal.add(1,4); 
System.out.printin("Year: " + cal.get(Calendar.YEAR) ); 
} 
} 
/* 
Output: 
Year: 2008 
*/ 
Remarks 


Argument fld can be one of the following defined in class Calendar: 
ERA 

YEAR 

MONTH 

WEEK_OF_YEAR 

WEEK_OF_MONTH 

DATE 

DAY_OF_MONTH 

DAY_OF_YEAR 

DAY_OF_WEEK 


DAY_OF_WEEK_IN_MONTH 
AM_PM 

HOUR 

HOUR_OF_DAY 

MINUTE 

SECOND 

MILLISECOND 
ZONE_OFFSET 
DST_OFFSET 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.after Method 


Determines whether the date-time in an instance of a Calendar object is after the date-time in the calendar specified. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean after( 
java.lang.Object cal); 


Parameters 
cal 
The calendar to compare to the current object. 
Return Value 
true if the current calendar contains a later date/time than cal; false otherwise. 
Example 


// cal-after1.jsl 
// Calendar.after example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Construct the current calendar: 
Calendar call = new GregorianCalendar(); 
// Construct another calendar: 
Calendar cal2 = new GregorianCalendar(2004,7,10) ; 
// Check if cali is after cal2: 
System.out.println(cal1l.after(cal2)); 
} 
} 
/ * 
Output: 
true 
* 
See Also 
Reference 
Calendar Class 
Concepts 


Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.before Method 


Determines whether the date-time in an instance of a Calendar object is before the date-time in the calendar specified. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean before( 
java.lang.Object cal); 


Parameters 
cal 
The calendar to compare to the current object. 
Return Value 
true if the current calendar contains an earlier date-time than cal; false otherwise. 
Example 


// cal-before1.jsl 
// Calendar.after example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Construct the current calendar: 
Calendar call = new GregorianCalendar(); 
// Construct another calendar: 
Calendar cal2 = new GregorianCalendar(2004,7,10); 
// Check if cali is before cal2: 
System.out.println(cal1.before(cal2)); 
i 
I 
/ * 
Output: 
false 
*/ 
See Also 
Reference 
Calendar Class 
Concepts 


Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.clear Method 


Clears the fields of an instance of a Calendar object. 


Overload List 


Clears all the fields of an instance of a Calendar object. 





Calendar.clear (int) Clears the specified field of an instance of a Calendar object. 


See Also 
Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.clear Method () 


Clears all the fields of an instance of a Calendar object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public final void clear(); 


Example ————__________________~ 


// Create a calendar object: 

Calendar cal = Calendar.getInstance(); 

// Clear the year field of the calendar object: 
cal.clear(Calendar. YEAR) ; 








See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.clear Method (Int32) 


Clears the specified field of an instance of a Calendar object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public final void clear( 
int fld); 





Parameters 


fld 
The field to be cleared. 


Example 





// Create a calendar object: 

Calendar cal = Calendar.getInstance(); 
// Clear the field #4: 

cal.clear(4); 





See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.complete Method 


Sets all the fields of an instance of a Calendar object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





protected void complete(); 





See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.computeFields Method 


Computes values for all the fields of an instance of a Calendar object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


protected abstract void computeFields(); 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.computeTime Method 


Computes the time for a current instance of a Calendar object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


protected abstract void computeTime(); 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.equals Method 


Determines whether two Calendar objects are equal. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean equals( 
java.lang.Object obj); 


Parameters 
obj 
The Calendar object to compare to. 
Return Value 
true if the two Calendar objects are equal; false otherwise. 
Example 


// cal-equalsi.jsl 
// Calendar.Equals example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create two calendar objects: 
Calendar cal2 = new GregorianCalendar(2004,8,10); 
Calendar call = new GregorianCalendar(2004,8,10); 
// Compare the two objects: 
System.out.println(cal1.Equals(cal2)); 
} 
} 
/ * 
Output 
true 
*/ 
See Also 
Reference 
Calendar Class 
Concepts 


Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.get Method 


Gets the value of the specified field. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final int get( 
int fld); 


Parameters 
fld 

The field whose value is to be retrieved. 
Return Value 
The value of the calendar field specified by fld. 
Example 


// cal-get1.jsl 
// Calendar.get example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a default calendar: 
Calendar cal = Calendar.getInstance(); 
// Get and display information from the calendar: 
System.out.printlin("Year: " + cal.get(Calendar.YEAR) ); 
System.out.println("Month: " + cal.get(Calendar.MONTH) ); 
System.out.println("Day: " + cal.get(Calendar.DATE) ); 
System.out.println("Hour: " + cal.get(Calendar.HOUR) ) ; 
System.out.println("Minute: " + cal.get(Calendar.MINUTE) ); 
} 
} 
/ * 
Output: 
Year: 2004 
Month: 8 
Day: 14 
Hour: 1 
Minute: 30 
*/ 
See Also 
Reference 
Calendar Class 
Concepts 


Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.getAvailableLocales Method 


Gets an array of all the Locale values that are available. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static synchronized java.util.Locale[] getAvailableLocales(); 


Return Value 
An array of Locale values that are supported by Calendar. 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.getFirstDayOfWeek Method 


Gets a value representing the first day of the week. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public int getFirstDayOfWeek(); 


Return Value 
A value representing the first day of the week. 
Example 


// cal-gefirst.jsl 
// Calendar.getFirstDayOfWeek example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Construct a calendar: 
Calendar cal = Calendar.getInstance(); 
// Get and display information from the calendar: 
int fdw = cal.getFirstDayOfWeek(); 
System.out.print("The first day of the week is: "); 
switch(fdw) { 
case Calendar .SUNDAY: 
System.out.println("Sunday") ; 
break; 
case Calendar .MONDAY: 
System.out.println("Monday") ; 
break; 
case Calendar.TUESDAY: 
System.out.println("Tuesday") ; 
break; 
case Calendar.WEDNESDAY: 
System.out.println("Wednesday") ; 
break; 
case Calendar. THURSDAY: 
System.out.println("Thursday") ; 
break; 
case Calendar.FRIDAY: 
System.out.println("Friday") ; 
break; 
case Calendar .SATURDAY: 
System.out.println("Saturday") ; 
break; 
default: 
System.out.println("Invalid!"); 
} 
} 
} 
/* 
Output: 


The first day of the week is: Monday 
*f 


nF" 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.getGreatestMinimum Method 


Gets a value representing the greatest possible minimum value for a given field. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract int getGreatestMinimum( 
int fld); 


Parameters 
fld 
The field whose greatest possible minimum value is to be retrieved. 
Return Value 
The greatest possible minimum value for fld. 
Example 


// cal-Min1.jsl 
// Calendar.getLeastMinimum example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a GregorianCalendar object: 
Calendar cal = new GregorianCalendar(2004,9,10); 
// Display the greatest min. for field #1: 
System.out.println("The minimum is: " + 
cal.getGreatestMinimum(1) ); 
} 
} 
/ * 
Output: 
The minimum is: 1 
*/ 
See Also 
Reference 
Calendar Class 
Concepts 


Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.getinstance Method 


Overload List 





Name 


Description 





Calendar.getInstance () 


Provides access to a Calendar using the default TimeZone and Locale. 





Calendar.getinstance (Locale) 


Provides access to a Calendar using the default TimeZone and given Locale. 





Calendar.getInstance (TimeZone) 


Provides access to a Calendar using the given TimeZone and default Locale. 





Calendar.getInstance (TimeZone, Locale) 





Provides access to a Calendar using the given TimeZone and given Locale. 





See Also 
Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 





Visual J# Reference 


Calendar.getInstance Method () 


Provides access to a Calendar using the default TimeZone and Locale. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static synchronized java.util.Calendar getInstance(); 


Return Value 
A Calendar with the default TimeZone and Locale. 
Example 


// cal-getInst1.jsl 
// Calendar getInstance example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 


// Create a calendar object using defaults: 
Calendar cal = Calendar.getInstance(); 


// Display the time: 
System.out.println(cal.getTime()); 


// Display the time zone offset: 
System.out.println("TZ offset in hours: " + 
cal.get(Calendar.ZONE_OFFSET)/(1000*60*6@) ); 


} 


/* 

Output: 

Tue Sep 14 13:44:29 PDT 2004 
TZ offset in hours: -8 

i) 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.getInstance Method (Locale) 


Provides access to a Calendar using the default TimeZone and given Locale. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static synchronized java.util.Calendar getInstance( 
java.util.Locale aLocale); 


Parameters 
aLocale 


The Locale for the Calendar object. 


Return Value 


A Calendar with the default TimeZone and given Locale. 


Example 


// cal-getInst2.jsl 
// Calendar getInstance example 


import java.util.*; 


public class MyClass 


public static void main(String[] args) 


{ 


} 


/* 
Output: 
Locale: 


// Create a locale: 

Locale loc = new Locale("en","us"); 

// Create a calendar object using loc: 
Calendar cal = Calendar.getInstance(loc) ; 


// Display the locale and time zone offset: 

System.out.println("Locale: " + loc); 

System.out.println("TZ offset in hours: " + 
cal.get(Calendar.ZONE_OFFSET)/(1000*60*6@) ); 


en_US 


TZ offset in hours: -8 


*/ 


See Also 
Reference 


Calendar Class 


Concepts 


Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.getInstance Method (TimeZone) 


Provides access to a Calendar using the given TimeZone and default Locale. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static synchronized java.util.Calendar getInstance( 
java.util.TimeZone zone); 


Parameters 
zone 
The TimeZone for the Calendar object. 
Return Value 
A Calendar with the given TimeZone and default Locale. 
Example 


// cal-getInst3.jsl 
// Calendar getInstance example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create Pacific time zone with -8 hours offset: 
TimeZone tz = new SimpleTimeZone( -28800000, 
"America/Los_ Angeles"); 
// Create a calendar object using the time zone: 
Calendar cal = Calendar.getInstance(tz); 
// Display the time zone offset in hours: 
System.out.println("TZ offset in hours: " + 
cal.get(Calendar.ZONE_OFFSET)/(1000*60*6@) ); 
} 
} 
/ * 
Output: 
TZ offset in hours: -8 
a | 
See Also 
Reference 
Calendar Class 
Concepts 


Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.getInstance Method (TimeZone, Locale) 


Provides access to a Calendar using the given TimeZone and given Locale. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static synchronized java.util.Calendar getInstance( 
java.util.TimeZone zone, 
java.util.Locale aLocale); 


Parameters 
zone 


The TimeZone for the Calendar object. 
aLocale 
The Locale for the Calendar object. 
Return Value 
A Calendar with the given TimeZone and given Locale. 
Example 


// cal-getInst4.jsl 
// Calendar.getInstance example 


import java.util.*; 


public class MyClass 
{ 
public static void main(String[] args) 
{ 
// Create Pacific time zone with -8 hours offset: 
TimeZone tz = new SimpleTimeZone(-28800000, 
"America/Los_ Angeles"); 


// Create a locale: 

Locale loc = new Locale("en","us"); 

// Construct an object using tz and loc: 
Calendar cal = Calendar.getInstance(tz,loc); 


// Display the locale and time zone offset: 

System.out.println("Locale: " + loc); 

System.out.println("TZ offset in hours: " + 
cal.get(Calendar.ZONE_OFFSET)/(1000*60*6@) ); 


} 


/* 

Output: 

Locale: en_US 

TZ offset in hours: -8 
ar 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.getLeastMaximum Method 


Gets a value representing the smallest possible maximum value for a given field. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract int getLeastMaximum( 
int fld); 


Parameters 
fld 
The field whose smallest possible maximum value is to be retrieved. 
Return Value 
The smallest possible maximum value for fld. 
Example 


// cal-Max1.jsl 
// Calendar.getLeastMaximum example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a calendar object: 
Calendar cal = new GregorianCalendar(2004,9,10); 
// Display the least max. for field #1: 
System.out.println("The maximum is: " + 
cal.getLeastMaximum(1)); 
} 
} 
/ * 
Output: 
The maximum is: 5000000 
*/ 
See Also 
Reference 
Calendar Class 
Concepts 


Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.getMaximum Method 


Gets a value representing the maximum value for a given field. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract int getMaximum( 
int fld); 


Parameters 
fld 
The field whose maximum value is to be retrieved. 
Return Value 
The maximum value for fld. 
Example 


// cal-Max2.jsl 
// Calendar.getMaximum example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a calendar object: 
Calendar cal = new GregorianCalendar(2004,9,10); 
// Display the max. for field #1: 
System.out.println("The maximum is: " + 
cal.getMaximum(1)); 
} 
} 
/ * 
Output: 
The maximum is: 50e0000 
*/ 
See Also 
Reference 
Calendar Class 
Concepts 


Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.getMinimalDaysInFirstWeek Method 


Gets a value representing the minimal number of days for the first week of the calendar year. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public int getMinimalDaysInFirstWeek() ; 


Return Value 
The minimal number of days for the first week of the calendar year. 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.getMinimum Method 


Gets a value representing the minimum value for a given field. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract int getMinimum( 
int fld); 


Parameters 
fld 
The field whose minimum value is to be retrieved. 
Return Value 
The minimum value for fld. 
Example 


// cal-Min2.js1 
// Calendar.getMinimum example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a calendar object: 
Calendar cal = new GregorianCalendar(2004,9,10); 
// Display the least max. for field #1: 
System.out.println("The minimum is: " + 
cal.getMinimum(1)); 
} 
} 
/ * 
Output: 
The minimum is: 1 
*/ 
See Also 
Reference 
Calendar Class 
Concepts 


Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.getTime Method 


Gets a Date representing the time of a Calendar object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public final java.util.Date getTime(); 





Return Value 
A Date representing the time of a Calendar object. 


Example TE 


// cal-getTime1.jsl 
// Calendar.getTime example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create an object: 


Calendar cal = new GregorianCalendar(); 


// Display the time: 
System.out.println(cal.getTime()); 


} 


/* 

Output: 

Fri Sep 10 14:12:18 PDT 2004 
*/ 











See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.getTimelnMillis Method 


Gets the time of a Calendar object represented in milliseconds. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


protected long getTimeInMillis(); 


Return Value 
The time of a Calendar object represented in milliseconds. 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.getTimeZone Method 


Gets the TimeZone of a Calendar object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.TimeZone getTimeZone(); 


Return Value 
The TimeZone of the Calendar object. 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.internalGet Method 


Gets the value of a given field. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


protected final int internalGet( 
int fld); 


Parameters 


fld 

The field whose value is to be returned. 
Return Value 
The value of fld. 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.isLenient Method 


Determines whether a given Calendar is lenient. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean isLenient(); 


Return Value 
true if the Calendar is lenient; false otherwise. 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.isSet Method 


Determines whether a given field is set. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final boolean isSet( 
int fld); 


Parameters 


fld 

The field whose status is to be checked. 
Return Value 
true if fld is set; false otherwise. 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.MemberwiseClone Method 


Constructs a new instance of a Calendar object that is a shallow copy of the current Calendar object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


Return Value 
A clone of the current Calendar object that is a shallow copy. 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.roll Method 


Modifies the value of a given field by one. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract void roll( 
int fld, 
boolean up); 


Parameters 


fld 


The field whose value is to be modified. 
up 

Flag indicating whether the field is to be increased or decreased. true indicates the field is to be increased. 
Example 


// cal-roll1.jsl 
// Calendar.roll example 


import java.util.*; 


public class MyClass 
{ 


public static void main(String[] args) 


// Create a calendar object: 
Calendar cal = new GregorianCalendar(); 


// Display the current year: 
System.out.println("The current year: " + cal.get(Calendar.YEAR) ); 


// Roll by 1: 
cal.roll(1, true); 


// Display the new year: 
System.out.println("The new year: " + cal.get(Calendar.YEAR) ); 


} 


f® 

Output: 

The current year: 2004 
The new year: 2005 

*/ 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.set Method 


Sets various fields of a Calendar object. 


Overload List 


Name Description 
Calendar.set (int, int) Sets the value of a calendar field to a new value. 
Calendar.set (int, int, int) Sets an instance of a Calendar object to the given year, month, and day. 


Calendar.set (int, int, int, int, int) — |Sets an instance of a Calendar object to the given year, month, day, hour, and minute. 


Calendar.set (int, int, int, int, int, int)/Sets an instance of a Calendar object to the given year, month, day, hour, minute, and seco 
nd. 





See Also 
Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar.set Method (Int32, Int32) 


Sets the value of a calendar field to a new value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final void set( 
int fld, 
int newValue); 


Parameters 


fld 

The field whose value is to be modified. 
newValue 

The modified value for the field given. 


See Also 

Reference 
Calendar Class 
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Calendar Members 
java.util Package 
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Calendar.set Method (Int32, Int32, Int32) 


Sets an instance of a Calendar object to the given year, month, and day. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final void set( 
int year, 
int month, 
int date); 


Parameters 
year 

The value for the year field. 
month 

The value for the month field. 
date 

The value for the date field. 
Example 


// cal-set12.jsl 
// Calendar set example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a calendar object using defaults: 
Calendar cal = Calendar.getInstance(); 
// Set the calendar: 
cal.set(1999,3,5); 
// Display the results: 
System.out.printin("Year: " + cal.get(Calendar.YEAR) ); 
System.out.println("Month: " + cal.get(Calendar.MONTH) ); 
System.out.println("Day: " + cal.get(Calendar.DATE)); 
} 
} 
/ * 
Output: 
Year: 1999 
Month: 3 
Day: 5 
ef 
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Calendar.set Method (Int32, Int32, Int32, Int32, Int32) 


Sets an instance of a Calendar object to the given year, month, day, hour, and minute. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final void set( 
int year, 
int month, 
int date, 
int hourOfDay, 
int minute); 


Parameters 
year 


The value for the year field. 
month 

The value for the month field. 
date 

The value for the date field. 
hourOfDay 

The value for the hour field. 
minute 

The value for the minute field. 
Example 


// cal-set13.jsl 
// Calendar set example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
. 
// Create a calendar object using defaults: 
Calendar cal = Calendar.getInstance(); 
// Set the calendar: 
cal.set(1999,3,5,8,25); 
// Display the results: 
System.out.println("Year: " + cal.get(Calendar.YEAR) ); 
System.out.println("Month: " + cal.get(Calendar.MONTH) ); 
System.out.println("Day: " + cal.get(Calendar.DATE) ); 
System.out.println("Hour: " + cal.get(Calendar.HOUR) ); 
System.out.println("Minute: " + cal.get(Calendar.MINUTE) ); 
} 
} 
/* 
Output: 
Year: 1999 
Month: 3 


Day: 5 


Hour: 8 
Minute: 25 
at | 





See Also 
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Calendar.set Method (Int32, Int32, Int32, Int32, Int32, Int32) 


Sets an instance of a Calendar object to the given year, month, day, hour, minute, and second. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final void set( 
int year, 
int month, 
int date, 
int hourOfDay, 
int minute, 
int second); 


Parameters 
year 


The value for the year field. 
month 

The value for the month field. 
date 

The value for the date field. 
hourOfDay 

The value for the hour field. 
minute 

The value for the minute field. 
second 

The value for the second field. 
Example 


// cal-set14.jsl 
// Calendar set example 


import java.util.*; 


public class MyClass 


{ 

public static void main(String[] args) 

if 
// Create a calendar object using defaults: 
Calendar cal = Calendar.getInstance(); 
// Set the calendar: 
cal.set(1999,3,5,8,25,15); 
// Display the results: 
System.out.printlin("Year: " + cal.get(Calendar.YEAR) ); 
System.out.println("Month: " + cal.get(Calendar.MONTH) ); 
System.out.println("Day: " + cal.get(Calendar.DATE) ); 
System.out.println("Hour: " + cal.get(Calendar.HOUR) ); 
System.out.println("Minute: " + cal.get(Calendar.MINUTE) ); 
System.out.println("Second: " + cal.get(Calendar.SECOND) ); 

} 


/* 

Output: 
Year: 1999 
Month: 3 
Day: 5 
Hour: 8 
Minute: 25 
Second: 15 
*/ 











See Also 
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java.util Package 
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Calendar.setFirstDayOfWeek Method 


Sets a value representing the first day of the week. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void setFirstDayOfwWeek( 
int value); 


Parameters 
value 


A value representing the first day of the week. 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.setLenient Method 


Sets a value that determines whether a given Calendar is lenient. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void setLenient( 
boolean lenient); 


Parameters 
lenient 


true if the Calendar should be lenient; false otherwise. 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Calendar.setMinimalDaysInFirstWeek Method 


Sets a value representing the minimal number of days for the first week of the calendar year. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void setMinimalDaysInFirstweek( 
int value); 


Parameters 
value 


The minimal number of days for the first week of the calendar year. 


See Also 

Reference 
Calendar Class 
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Calendar Members 
java.util Package 


Visual J# Reference 


Calendar.setTime Method 


Sets the time of a Calendar object to the given Date. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final synchronized void setTime( 
java.util.Date date); 


Parameters 
date 


The Date to set the time of the Calendar to. 


See Also 
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Calendar Class 
Concepts 
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java.util Package 
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Calendar.setTimelnMillis Method 


Sets the time of a Calendar object to a value represented in milliseconds. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


protected void setTimeInMillis( 
long millis); 


Parameters 
millis 
The time of a Calendar object represented in milliseconds. 


See Also 

Reference 
Calendar Class 
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Calendar Members 
java.util Package 
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Calendar.setTimeZone Method 


Sets the TimeZone of a Calendar object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void setTimeZone( 
java.util.TimeZone tz); 


Parameters 
tz 


The TimeZone for the Calendar object. 


See Also 

Reference 
Calendar Class 
Concepts 

Calendar Members 
java.util Package 
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Collection Interface 


An interface that represents a group of objects or elements. It is implemented by many collection classes such as LinkedList, 
ArrayList, HashSet and TreeSet. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public interface java.util.Collection 


See Also 

Concepts 

Collection Members 
java.util Package 
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Collection Members 


An interface that represents a group of objects or elements. It is implemented by many collection classes such as LinkedList, 
ArrayList, HashSet and TreeSet. 


The following tables list the members exposed by the Collection type. 


Public Methods 












































Name Description 

add Inserts an element into a Collection object. 

addAll Inserts all the elements from one collection into another collection. 

clear Removes all the elements from a Collection object. 

contains Checks if a Collection object contains a specific element. 

containsAll Checks if a Collection object contains all the elements of another collection. 
equals Checks if a Collection object is equal to a specific object. 

hashCode Retrieves the hash code of a Collection.object. 

isEmpty Checks if a Collection object is empty. 

iterator Provides an iterator to iterate over a Collection object. 

remove Removes a specific element from a Collection object. 

removeAll Deletes all the elements from a Collection object that exist is a specified collection. 
retainAll Copies the elements of a specified collection into a Collection object. 

size Retrieves the number of elements in a Collection object. 

toArray Overloaded. 

See Also 

Reference 

Collection Interface 

Concepts 


java.util Package 
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Collection Methods 


Public Methods 























Name Description 

add Inserts an element into a Collection object. 

addAll Inserts all the elements from one collection into another collection. 

clear Removes all the elements from a Collection object. 

contains Checks if a Collection object contains a specific element. 

containsAll Checks if a Collection object contains all the elements of another collection. 
equals Checks if a Collection object is equal to a specific object. 

hashCode Retrieves the hash code of a Collection.object. 

isEmpty Checks if a Collection object is empty. 

iterator Provides an iterator to iterate over a Collection object. 

remove Removes a specific element from a Collection object. 

removeAll Deletes all the elements from a Collection object that exist is a specified collection. 
retainAll Copies the elements of a specified collection into a Collection object. 

size Retrieves the number of elements in a Collection object. 

toArray Overloaded. 

See Also 

Reference 


Collection Interface 


Concepts 


java.util Package 
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Collection.add Method 


Inserts an element into a Collection object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean add( 
java.lang.Object e); 


Parameters 
e 


The element to be added to Collection. 
Return Value 
true if the element was inserted successfully; false otherwise. 
Example 


// col-add1.jsl 
// Collection.add example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 

{ 
// Create a new collection object: 
Collection 1IList = new LinkedList(); 


// Add some elements: 
lList.add("Isabella Abolrous"); 
lList.add("Angelina Abolrous"); 


// Get and display the elements: 

System.out.println("The elements of the collection are:"); 

for (int i=@; i<lList.size(); i++) 
System.out.printin(lList.get(i)); 


} 


/* 

Output: 

The elements of the collection are: 
Isabella Abolrous 

Angelina Abolrous 


*/ 


See Also 

Reference 
Collection Interface 
Concepts 

Collection Members 
java.util Package 
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Collection.addAll Method 


Inserts all the elements from one collection into another collection. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean addA11( 
java.util.Collection c); 


Parameters 
c 

The name of the collection whose elements to be added. 
Return Value 
true if the elements were inserted successfully; false otherwise. 
Example 


// col-addAll1.jsl 
// Collection.addAll example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create ArrayList and LinkedList collections: 
Collection aList = new ArrayList(); 
Collection lList = new LinkedList(); 
// Initialize aList: 
aList.add("Craig"); 
aList.add("Sally"); 
// Add all the elements of aList to lList: 
lList.addAll(aList); 
// Display lList: 
System.out.println(lList) ; 
} 
} 
/ * 
Output: 
[Craig, Sally] 
nf 
See Also 
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java.util Package 
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Collection.clear Method 


Removes all the elements from a Collection object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract void clear(); 


Example 


In this example, you create a linked list object, add two elements to it, and then clear the list. You also print the elements and 
the size of the list before and after clearing the list. 


// col-clear.jsl 
// Collection.clear example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 
{ 
LinkedList 11 = new LinkedList(); 
Integer x = new Integer(123); 
Double y = new Double(4.56); 


// Build the list with the first and last elements: 
ll.addFirst(x); 
ll.addLast(y); 


// Print the list: 

System.out.println("The list elements are: + 
ll.getFirst() + ", " + ll.getLast()); 

// Print the size: 

System.out.println("The size of the list is: 
+ ll.size()); 


// Clear the list: 

ll.clear(); 

// Print the new size: 

System.out.println("The size after clearing the list is: 
+ ll.size()); 


I 


/* 

Output: 

The list elements are: 123, 4.56 

The size of the list is: 2 

The size after clearing the list is: @ 


*/ 


See Also 

Reference 

Collection Interface 
Concepts 

Collection Members 
java.util Package 
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Collection.contains Method 


Checks if a Collection object contains a specific element. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean contains( 
java.lang.Object e); 


Parameters 
e 
The element searched for. 
Return Value 
true if the element was found, false otherwise. 
Example 
In this example, you initialize a linked list with two elements, and then you test the list to see if one of the elements exits in it. 


// col-contains1.jsl 
// Collection.contains example 


import java.util.*; 


public class MyClass 


4 
public static void main(String[] args) 
{ 
// Create a collection object: 
Collection 1lList = new LinkedList(); 
// Add some elements: 
lList.add("Isabella"); 
lList.add( "Angelina" ) ; 
// Check if the element "Angelina" exists in the list: 
if(1lList.contains("Angelina") ) 
System.out.println("The element exists in the list."); 
} 
} 
/ * 
Output: 
The element exists in the list. 
7 | 
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Collection.containsAll Method 


Checks if a Collection object contains all the elements of another collection. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean containsA11( 
java.util.Collection c); 


Parameters 
c 
The name of the other collection. 
Return Value 
true if all the elements were found; false otherwise. 
Example 


// col-contAll1.jsl 
// Collection.containsAll example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a collection object: 
Collection 1lList = new LinkedList(); 
// Add some elements: 
lList.add("Sam") ; 
lList.add("Michelle"); 
lList.add("Jim"); 
lList.add("Virginia"); 
// Create a new list lList1: 
LinkedList lList1 = new LinkedList(); 
// Add all the elements of lList to lList1: 
lList1.addAl1(1List); 
// Confirm that the elements of IList exist in IList1: 
if(1lList1.containsAll(1lList)) 
System.out.println( 
"All the elements exist in the new list."); 
} 
} 
/ * 
Output: 
All the elements exist in the new list. 
*/ 
See Also 
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Collection.equals Method 


Checks if a Collection object is equal to a specific object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean equals( 
java.lang.Object c); 


Parameters 
c 
The object to compare to. 
Return Value 
true if the two elements are identical; false otherwise. 
Example 


// col-eqi.jsl 
// Collection.Equals example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a collection object lList: 
Collection 1lList = new LinkedList(); 
// Add some elements: 
lList.add("Sam") ; 
lList.add("Michelle"); 
lList.add("Jim"); 
lList.add("Virginia"); 
// Create a new collection object lList1: 
LinkedList lList1 = new LinkedList(); 
// Add all the element of 1List to lList1: 
lList1.addAl1l(1lList); 
// Check if the two lists are identical: 
if(1lList1.Equals(1lList)) 
System.out.println("The two lists are the same."); 
} 
} 
/ * 
Output: 
The two lists are the same. 
“ef 
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Collection.hashCode Method 


Retrieves the hash code of a Collection.object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract int hashCode(); 


Return Value 
An integer representing the hash code of the Collection object. 
Example 


// col-getHash1.jsl 
// Collection.GetHashCode example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a collection object: 
Collection 1IList = new LinkedList(); 
// Add some elements: 
lList.add(new Double(5.25)); 
lList.add(new Byte((byte)127)); 
lList.add(null1); 
lList.add(new Integer(55)); 
// Print the hash code: 
System.out.println("The hash code is: " + lList.GetHashCode()); 
} 
} 
/ * 
Output: 
The hash code is: -1898639464 
*/ 
See Also 
Reference 
Collection Interface 
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Collection.isEmpty Method 


Checks if a Collection object is empty. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean isEmpty(); 


Return Value 
true if the Collection object is empty; false otherwise. 
Example 


// col-isEmp1.jsl 
// Collection.isEmpty example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a linked list object: 
LinkedList lList = new LinkedList(); 
// Add some elements: 
lList.add("Sam") ; 
lList.add("Michelle"); 
lList.add("Jim"); 
lList.add("Virginia"); 
// Clear the list: 
lList.clear(); 
// Check if the list is empty: 
if(1lList.isEmpty()) 
System.out.println("The list is now empty."); 
} 
} 
/ * 
Output: 
The list is now empty. 
*/ 
See Also 
Reference 
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Collection.iterator Method 


Provides an iterator to iterate over a Collection object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.util.Iterator iterator(); 


Return Value 
An iterator that can be used over the Collection object. 
Example 


// col-iterator1.jsl 
// Collection.iterator example 


import java.util.*; 
public class MyClass 


public static void main() 


{ 
Collection hSet = new HashSet(); 


// Add some elements to the HashSet: 
hSet.add("1 "); 
hSet.add("2 "); 
hSet.add("3 "); 
hSet.add("4 "); 


// Retrieve an iterator to the hashset: 
Iterator iter = hSet.iterator(); 


// Extract elements from the list using the iterator. 
// Note that the elements may not follow the order in which they 
// are added to HashSet. 
while(iter.hasNext()) 
{ 
System.out.print(iter.next()); 
iter.remove(); 


} 

/* 
Output: 
3142 
*/ 


See Also 
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Collection.remove Method 


Removes a specific element from a Collection object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean remove( 
java.lang.Object e); 


Parameters 
e 


The element to be removed. 
Return Value 
true if the element was removed successfully; false otherwise. 
Example 


// col-rem1.jsl 
// Collection.remove example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 

{ 
// Create a new linked list object: 
LinkedList lList = new LinkedList(); 


// Add some elements: 
lList.add("Isabella"); 
lList.add( "Angelina" ) ; 
lList.add("Pille") ; 

lList.add("Anabella") ; 


// Display the elements: 
System.out.print("The old list: "+ lList); 


// Remove the element #3: 
lList.remove("Anabella"); 
System.out.print1n( 
"\nThe element \"Anabella\" has been removed."); 


// Display the new elements: 
System.out.print("The new list: " + lList); 


} 


/* 

Output: 

The old list: [Isabella, Angelina, Pille, Anabella] 
The element "Anabella" has been removed. 

The new list: [Isabella, Angelina, Pille] 

m/f 


See Also 
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Collection.removeAll Method 


Deletes all the elements from a Collection object that exist is a specified collection. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean removeA11( 
java.util.Collection c); 


Parameters 
c 
The collection of elements to be deleted. 
Return Value 
true if the elements were successfully deleted; false otherwise. 
Example 
In this example, you create and initialize two collections, aList and IList. Then you remove all the elements from the IList that 


exist in the aList. The output displays the new contents of IList. 


// col-remA1.js1 
// Collection.removeAll example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Create two collections: 
LinkedList lList = new LinkedList(); 
ArrayList aList = new ArrayList(); 
// Add some elements to lList: 
lList.add("Isabella"); 
lList.add( "Angelina" ) ; 
lList.add("Pille") ; 
lList.add( "Hazem" ) ; 
// Add some elements to aList: 
aList.add("Isabella") ; 
aList.add("Angelina") ; 
// Remove aList members: 
lList.removeAll(aList); 
// Display lList: 
System.out.println("The collection is: " + lList); 
} 
} 
/ * 
Output: 
The collection is: [Pille, Hazem] 
=f 
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Collection.retainAll Method 


Copies the elements of a specified collection into a Collection object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean retainAl1l( 
java.util.Collection c); 


Parameters 
Cc 


The collection whose elements are copied. 
Return Value 
true if the list has changed after the call; false otherwise. 
Example 


In this example, you create and initialize two collections, aList and IList. Then you copy the elements of aList into IList and 
display both collections. 


// col-retA1.jsl 
// Collection.retainAll example 


import java.util.*; 


public class MyClass 
{ 
public static void main(String[] args) 
{ 
// Create two collections: 
LinkedList lList = new LinkedList(); 
ArrayList aList = new ArrayList(); 


// Add some elements to lList: 
lList.add("Isabella"); 
lList.add( "Angelina" ) ; 
lList.add("Pille") ; 

lList.add( "Hazem" ) ; 


// Add some elements to aList: 
aList.add("Isabella") ; 
aList.add("Angelina") ; 


// Retain elements from aList to lList: 
lList.retainAll(aList); 


// Display the collection: 
System.out.println("The aList collection is: + aList); 
System.out.printin("The 1lList collection is: " + lList); 


} 


/* 

Output: 

The aList collection is: [Isabella, Angelina] 
The 1lList collection is: [Isabella, Angelina] 
ei 
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Collection.size Method 


Retrieves the number of elements in a Collection object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public abstract int size(); 





Return Value 


The number of elements in the Collection object. 


Example TE 








// col-size1.jsl 
// Collection.size example 
import java.util.*; 
public class MyClass 
public static void main(String[] args) 
{ 
// Costruct a new Collection object: 
Collection 1lList = new LinkedList(); 
// Add some elements: 
lList.add("Isabella"); 
lList.add( "Angelina" ) ; 
lList.add("Pille") ; 
lList.add("Camelia"); 
// Display the size of the list: 
System.out.println("The size of the collection is: " + 
lList.size()); 
} 
} 
/* 
Output: 
The size of the collection is: 4 
mf 
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Collection.toArray Method 


Overload List 





Name Description 





Collection.toArray () Converts a Collection to an array. 





Collection.toArray (Object[]) Copies the elements of a Collection into specified array object. 
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Collection.toArray Method () 


Converts a Collection to an array. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.Object[] toArray(); 


Return Value 
The array object that contains the collection elements. 
Example 


// Col-toArr2.jsl 
// Collection.toArray example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 

{ 
// Construct a new Collection object: 
Collection 1lList = new LinkedList(); 


// Add some elements: 
lList.add("Isabella"); 
lList.add( "Angelina" ) ; 
lList.add("Pille") ; 

lList.add("Camelia"); 


// Create an array from the list: 
Object[] s = lList.toArray(); 


// Display the array elements: 

System.out.println("The array elements are:"); 

for (int i=@; i<lList.size(); i++) 
System.out.printlin(i + " = " + s[i]); 


} 


/* 

Output: 

The array elements are: 
@ = Isabella 

1 = Angelina 

2 = Pille 

3 = Camelia 


*/ 


See Also 

Reference 
Collection Interface 
Concepts 

Collection Members 
java.util Package 


Visual J# Reference 


Collection.toArray Method (Object ]) 


Copies the elements of a Collection into specified array object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.Object[] toArray( 
java.lang.Object[] arr); 


Parameters 
arr 
The array object that receives the elements of the Collection object. 
Return Value 
The array object that contains the Collection elements. 
Example 


// col-toArr2.jsl 
// Collection.toArray example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Construct a new Collection object: 
Collection 1lList = new LinkedList(); 
// Add some elements: 
lList.add("Isabella"); 
lList.add( "Angelina" ) ; 
lList.add("Pille") ; 
lList.add("Camelia"); 
// Create an array "s" from the list: 
Object[] s = lList.toArray(); 
// Copy "s" to another object array "si": 
Object[] s1 = lList.toArray(s); 
// Display the array objects: 
System.out.println("The array objects are:"); 
for (int i=@; i<lList.size(); i++) 
System.out.println(i + " = " + s1f[i]); 
} 

} 

/* 

Output: 

The array objects are: 

@ = Isabella 

1 = Angelina 

2 = Pille 

3 = Camelia 

*/ 

Remarks 


Throws NullPointerException if the specified array is null. 


See Also 

Reference 
Collection Interface 
Concepts 

Collection Members 
java.util Package 


Visual J# Reference 


Collections Class 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public class java.util.Collections 
extends java.lang.Object 





Inheritance Hierarchy 
java.lang.Object 
java.util.Collections 


See Also 

Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections Members 


The following tables list the members exposed by the Collections type. 


Public Constructors 


Name Description 


Collections 





Public Fields 





Name Description 





EMPTY_LIST 





EMPTY_SET 








Public Methods 


















































Name Description 
binarySearch Overloaded. 

copy 

enumeration 

equals (inherited from Object ) 
fill 

hashCode (inherited from Object ) 
getClass (inherited from Object ) 
max Overloaded. 

min Overloaded. 

nCopies 

reverse 

reverseOrder 

shuffle Overloaded. 

singleton 

sort Overloaded. 
synchronizedCollection 

synchronizedList 














synchronizedMap 





synchronizedSet 


synchronizedSortedMap 
synchronizedSortedSet 
toString Overridden. 
unmodifiableCollection 
unmodifiableList 


unmodifiableMap 





unmodifiableSet 





unmodifiableSortedMap 





unmodifiableSortedSet 








Protected Methods 
Name Description 


finalize (inherited from Object ) 


MemberwiseClone Performs a shallow copy of the members. 





See Also 
Reference 
Collections Class 
Concepts 
java.util Package 





Visual J# Reference 


Collections Fields 


Public Fields 





Name 


Description 





EMPTY_LIST 





EMPTY_SET 











See Also 
Reference 
Collections Class 
Concepts 
java.util Package 





Visual J# Reference 


Collections.EMPTY LIST Field 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final java.util.List EMPTY_LIST; 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.EMPTY SET Field 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final java.util.Set EMPTY_SET; 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections Constructor 


Initializes a new instance of the Collections Class . 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.util.Collections(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections Methods 


Public Methods 





Name 


Description 





binarySearch 


Overloaded. 





copy 





enumeration 





equals 


(inherited from Object ) 





fill 


hashCode 


getClass 


max 


min 


nCopies 


reverse 


reverseOrder 


shuffle 


singleton 


sort 


synchronizedCollection 


synchronizedList 


synchronizedMap 


synchronizedSet 


synchronizedSortedMap 


(inherited from Object ) 


(inherited from Object ) 


Overloaded. 


Overloaded. 


Overloaded. 


Overloaded. 





synchronizedSortedSet 





toString 


Overridden. 





unmodifiableCollection 





unmodifiableList 

















unmodifiableMap 





unmodifiableSet 





unmodifiableSortedMap 





unmodifiableSortedSet 





Protected Methods 
Name 


finalize 


MemberwiseClone 





See Also 
Reference 
Collections Class 
Concepts 
java.util Package 


Description 


(inherited from Object ) 


Performs a shallow copy of the members. 








Visual J# Reference 


Collections.binarySearch Method 


Overload List 





Name Description 





Collections.binarySearch (List, Object) 





Collections.binarySearch (List, Object, Comparator) 











See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.binarySearch Method (List, Object) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static int binarySearch( 
java.util.List ls, 
java.lang.Object e); 


Parameters 
ls 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.binarySearch Method (List, Object, Comparator) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static int binarySearch( 
java.util.List ls, 
java.lang.Object e, 
java.util.Comparator comp); 


Parameters 
ls 


comp 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.copy Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void copy( 
java.util.List dest, 
java.util.List src); 


Parameters 
dest 


SIC 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.enumeration Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static java.util.Enumeration enumeration( 
java.util.Collection c); 


Parameters 
Cc 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.fill Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void fil11( 
java.util.List ls, 
java.lang.Object e); 


Parameters 
ls 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.max Method 


Overload List 





Name 


Description 





Collections.max (Collection) 





Collections.max (Collection, Comparator) 











See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 





Visual J# Reference 


Collections.max Method (Collection) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.Object max( 
java.util.Collection c); 


Parameters 
Cc 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.max Method (Collection, Comparator) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.Object max( 
java.util.Collection c, 
java.util.Comparator comp); 


Parameters 
Cc 


comp 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.min Method 


Overload List 





Name Description 





Collections.min (Collection) 





Collections.min (Collection, Comparator) 











See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.min Method (Collection) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.Object min( 
java.util.Collection c); 


Parameters 
Cc 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.min Method (Collection, Comparator) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static java.lang.Object min( 
java.util.Collection c, 
java.util.Comparator comp); 


Parameters 
Cc 


comp 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.nCopies Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static java.util.List nCopies( 
int n, 
java.lang.Object e); 


Parameters 
n 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.reverse Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void reverse( 
java.util.List 1s); 





Parameters 
ls 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.reverseOrder Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static java.util.Comparator reverseOrder(); 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.shuffle Method 


Overload List 





Name 


Description 





Collections.shuffle (List) 





Collections.shuffle (List, Random) 











See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 





Visual J# Reference 


Collections.shuffle Method (List) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void shuffle( 
java.util.List 1s); 


Parameters 
ls 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.shuffle Method (List, Random) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void shuffle( 
java.util.List ls, 
java.util.Random r); 


Parameters 
ls 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.singleton Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static java.util.Set singleton( 
java.lang.Object e); 


Parameters 
e 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.sort Method 


Overload List 





Name Description 





Collections.sort (List) 





Collections.sort (List, Comparator) 











See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.sort Method (List) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void sort( 
java.util.List 1s); 


Parameters 
ls 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.sort Method (List, Comparator) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static void sort( 
java.util.List ls, 
java.util.Comparator comp); 


Parameters 
ls 


comp 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.synchronizedCollection Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static java.util.Collection synchronizedCollection( 
java.util.Collection c); 


Parameters 
Cc 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.synchronizedList Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static java.util.List synchronizedList( 
java.util.List 1s); 


Parameters 
ls 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.synchronizedMap Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static java.util.Map synchronizedMap( 
java.util.Map m); 


Parameters 
m 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.synchronizedSet Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static java.util.Set synchronizedSet( 
java.util.Set s); 


Parameters 
Ss 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.synchronizedSortedMap Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static java.util.SortedMap synchronizedSortedMap( 
java.util.SortedMap m); 


Parameters 
m 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.synchronizedSortedSet Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static java.util.SortedSet synchronizedSortedSet( 
java.util.SortedSet s); 


Parameters 
Ss 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.unmodifiableCollection Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static java.util.Collection unmodifiableCollection( 
java.util.Collection c); 


Parameters 
Cc 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.unmodifiableList Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static java.util.List unmodifiableList( 
java.util.List 1s); 


Parameters 
ls 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.unmodifiableMap Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static java.util.Map unmodifiableMap( 
java.util.Map m); 


Parameters 
m 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.unmodifiableSet Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static java.util.Set unmodifiableSet( 
java.util.Set s); 


Parameters 
Ss 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.unmodifiableSortedMap Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static java.util.SortedMap unmodifiableSortedMap( 
java.util.SortedMap m); 


Parameters 
m 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Collections.unmodifiableSortedSet Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static java.util.SortedSet unmodifiableSortedSet( 
java.util.SortedSet s); 


Parameters 
Ss 


See Also 

Reference 
Collections Class 
Concepts 

Collections Members 
java.util Package 


Visual J# Reference 


Comparator Interface 


Contains methods to compare objects. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public interface java.util.Comparator 





See Also 

Concepts 

Comparator Members 
java.util Package 


Visual J# Reference 


Comparator Members 


Contains methods to compare objects. It is implemented by the abstract class Collator. 


The following tables 


Public Methods 


list the members exposed by the Comparator type. 




















Name Description 

compare Compares two string objects for equality. 

equals Checks if an object is equal to the current object. 
See Also 

Reference 


Comparator Interface 


Concepts 
java.util Package 





Visual J# Reference 


Comparator Methods 


Public Methods 




















Name Description 

compare Compares two string objects for equality. 

equals Checks if an object is equal to the current object. 
See Also 

Reference 


Comparator Interface 


Concepts 
java.util Package 





Visual J# Reference 


Comparator.compare Method 


Compares two objects for relative order. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract int compare( 
java.lang.Object o1, 
java.lang.Object 02); 


Parameters 
ol 


The first object to be compared. 
02 
The second object to be compared. 
Return Value 
Negative value if 01 is less than 02. 
Zero if 01 and o2 are equal. 
Positive value if 01 is greater than 02. 
Example 
In this example, you compare the three strings, two strings at a time. You get three different results for three comparisons. 


// comp-comp1.jsl 
// Comparator.compare example 


import java.text.*; 
import java.util.*; 


public class Program 


3 
public static void main(String[] args) 
{ 
// Construct a Collator object(implements Comparator): 
Collator col = Collator.getInstance(); 
// Declare some string objects: 
String s1 = "C#"; 
String s2 = "J#"; 
String s3 = "C#"; 
// Compare strings and display the results: 
System.out.println("The comparison result for s1 & s2 = " + 
col.compare(s1,s2)); 
System.out.println("The comparison result for s2 & s1 = " + 
col.compare(s2,s1)); 
System.out.println("The comparison result for s1 & s3 = " + 
col.compare(si1,s3)); 
} 
} 
/* 
Output: 
The comparison result for s1 & s2 = -1 
The comparison result for s2 & s1 = 1 
The comparison result for s1 & s3 = @ 


ef 





Remarks 


Throws java.lang.ClassCastException if the types of the two objects are different or cannot be compared with this method. 


See Also 

Reference 
Comparator Interface 
Concepts 

Comparator Members 
java.util Package 


Visual J# Reference 


Comparator.equals Method 


Checks if an object is equal to the current object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean equals( 
java.lang.Object obj); 


Parameters 
obj 
The object to compare to the current object. 
Return Value 
true if the two objects are identical; false otherwise. 
Example 
In this example you compare two collator objects; one of them is a clone of the other. The result of the comparison is true. 


// comp-eqi.jsl 
// Comparator.Equals example 


import java.text.*; 


public class Program 


4 
public static void main(String[] args) 
{ 
// Construct a Collator object(implements Comparator): 
Collator o1 = Collator.getInstance(); 
// Clone the Collator object: 
Object o2 = o1.clone(); 
// Compare the two objects and display the result: 
System.out.println("The comparison result is: " + 
o01.equals(o2)); 
} 
} 
/* 
Output: 
The comparison result is: true 
mf 
See Also 
Reference 
Comparator Interface 
Concepts 


Comparator Members 
java.util Package 


Visual J# Reference 


ConcurrentModificationException Class 


The exception that is thrown when two threads attempt to modify a collection concurrently. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public class java.util.ConcurrentModificationException 
extends java. lang.RuntimeException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.lang.RuntimeException 
java.util.ConcurrentModificationException 


See Also 

Concepts 

ConcurrentModificationException Members 
java.util Package 


Visual J# Reference 


ConcurrentModificationException Members 


The exception that is thrown when two threads attempt to modify a collection concurrently. 


The following tables list the members exposed by the ConcurrentModificationException type. 


Public Constructors 





Name 


Description 





ConcurrentModificationException |Overloaded. Initializes a new instance of a ConcurrentModificationException object. 





Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 





Description 


(inherited from Exception ) 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 








printStackTrace 





getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 

clone (inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 








toString (inherited from Throwable ) 





Protected Methods 
Name 








finalize (inherited from Object ) 
See Also 

Reference 

ConcurrentModificationException Class 

Concepts 


java.util Package 





Visual J# Reference 


ConcurrentModificationException Constructor 


Initializes a new instance of a ConcurrentModificationException object. 


Overload List 
Name Description 


ConcurrentModificationException () Initializes a new instance of a ConcurrentModificationE 
xception object. 





ConcurrentModificationException (String) Initializes a new instance of a ConcurrentModificationE 
xception with the given message. 


ConcurrentModificationException (SerializationInfo, StreamingContext)|Initializes a new instance of a ConcurrentModificationE 
xception object during deserialization. 


ConcurrentModificationException (String, Exception) Initializes a new instance of a ConcurrentModificationE 
xception with the given message and inner exception. 











See Also 

Reference 
ConcurrentModificationException Class 
Concepts 

ConcurrentModificationException Members 
java.util Package 


Visual J# Reference 


ConcurrentModificationException Constructor () 


Initializes a new instance of a ConcurrentModificationException object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.ConcurrentModificationException() ; 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
ConcurrentModificationException Class 
Concepts 

ConcurrentModificationException Members 
java.util Package 


Visual J# Reference 


ConcurrentModificationException Constructor (String) 


Initializes a new instance of a ConcurrentModificationException with the given message. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.ConcurrentModificationException( 


java.lang.String s); 
| 


Parameters 
S 


A message describing the exceptional condition. 


See Also 

Reference 
ConcurrentModificationException Class 
Concepts 

ConcurrentModificationException Members 
java.util Package 
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ConcurrentModificationException Constructor 
(SerializationInfo, StreamingContext) 


Initializes a new instance of a ConcurrentModificationException object during deserialization. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


protected java.util.ConcurrentModificationException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
ConcurrentModificationException Class 
Concepts 

ConcurrentModificationException Members 
java.util Package 


Visual J# Reference 


ConcurrentModificationException Constructor (String, 
Exception) 


Initializes a new instance of a ConcurrentModificationException with the given message and inner exception. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.ConcurrentModificationException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
S 


A message describing the exceptional condition. 
inner 
An inner exception that led to the ConcurrentModificationException being thrown. 


See Also 

Reference 
ConcurrentModificationException Class 
Concepts 

ConcurrentModificationException Members 
java.util Package 


Visual J# Reference 


ConcurrentModificationException Methods 


Public Methods 












































Name Description 

equals (inherited from Object ) 
filllnStackTrace (inherited from Throwable ) 
GetBaseException (inherited from Exception ) 
hashCode (inherited from Object ) 
getLocalizedMessage (inherited from Throwable ) 
getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 
clone (inherited from Throwable ) 
printStackTrace Overloaded. (inherited from Throwable ) 
toString (inherited from Throwable ) 
Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 

ConcurrentModificationException Class 

Concepts 


java.util Package 


Visual J# Reference 


ConcurrentModificationException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 


ConcurrentModificationException Class 


Concepts 
java.util Package 
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Date Class (J#) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public class java.sql.Date 
extends java.util.Date 





Inheritance Hierarchy 

java.lang.Object 
java.util.Date 
java.sql.Date 


See Also 
Concepts 

Date Members 
java.sql Package 


Visual J# Reference 


Date Members (J#) 


The following tables list the members exposed by the Date type. 


Public Constructors 


Name 


Date 





Public Methods 











getTimezoneOffset 


Name Description 

after Determines whether the Date object is after a given date. (inherited from Date) 
before Determines whether the Date object is before a given date. (inherited from Date) 
compareTo Compares two dates. (inherited from Date) 

equals Determines whether two Date objects are equal. (inherited from Date) 

getDate Gets a value indicating the date. (inherited from Date) 

getDay Gets a value indicating the day of the week. (inherited from Date) 

hashCode Generates a hash of the date. (inherited from Date) 

getHours Overridden. 

getMinutes Overridden. 

getMonth Gets a value indicating the month. (inherited from Date) 

getSeconds Overridden. 

getTime Gets a value indicating the time in milliseconds since epoch. (inherited from Date) 


Gets a value indicating the time zone offset in milliseconds. (inherited from Date) 




















getClass (inherited from Object ) 

getYear Gets a value indicating the year. (inherited from Date) 
clone (inherited from Date ) 

setDate Sets a value indicating the date. (inherited from Date) 
setHours Overridden. 

setMinutes Overridden. 

setMonth Sets a value indicating the month. (inherited from Date) 








setSeconds 


Overridden. 




















setTime Sets the time to the value represented in milliseconds since epoch. (inherited from Date) 
setYear Sets a value indicating the year. (inherited from Date) 

ToBoolean Converts an instance of a Date object to a Boolean. (inherited from Date) 

ToByte Converts an instance of a Date object to a Byte. (inherited from Date) 

ToChar Converts an instance of a Date object to a Char. (inherited from Date) 

ToDateTime Converts an instance of a Date object to a DateTime. (inherited from Date) 

ToDecimal Converts an instance of a Date object to a Decimal. (inherited from Date) 

ToDouble Converts an instance of a Date object to a Double. (inherited from Date) 

toGMTString Displays a value representing the date/time of a Date object in GMT. (inherited from Date) 
Tolnt16 Converts an instance of a Date object to an Int16. (inherited from Date) 

Tolnt32 Converts an instance of a Date object to an Int32. (inherited from Date) 

Tolnt64 Converts an instance of a Date object to an Int64. (inherited from Date) 





toLocaleString 


ToSByte 


ToSingle 


toString 


ToType 


ToUInt16 


ToUInt32 


ToUInt64 


valueOf 


Name 


finalize 





See Also 
Reference 

Date Class 
Concepts 
java.sql Package 





Displays a value representing the date/time of a Date object displayed in the format of current locale. (inhe 
rited from Date) 


Converts an instance of a Date object to a SByte. (inherited from Date) 


Converts an instance of a Date object to a Single. (inherited from Date) 


Overloaded. Overridden. 


Converts an instance of a Date object to a given Type. (inherited from Date) 


Converts an instance of a Date object to an Ulnt16. (inherited from Date) 


Converts an instance of a Date object to an Ulnt32. (inherited from Date) 


Converts an instance of a Date object to an Ulnt64. (inherited from Date) 


Protected Methods 


(inherited from Object ) 








Visual J# Reference 


Date Constructor (J#) 


Overload List 

















Name Description 

Date () Constructs a new instance of a Date object. 

Date (long) Constructs a new instance of a Date object and initializes it using the milliseconds since epoch. 
Date (String) Constructs a new instance of a Date object and initializes it using the given string. 

Date (int, int, int) Constructs a new instance of a Date object and initializes it with the given year, month, and day. 





Date (int, int, int, int, int) | |Constructs a new instance of a Date object and initializes it with the given year, month, day, hours, 
and minutes. 





Date (int, int, int, int, int, int)|\Constructs a new instance of a Date object and initializes it with the given year, month, day, hours, 
minutes, and seconds 








See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.util Package 





Visual J# Reference 


Date Constructor () (J#) 


Constructs a new instance of a Date object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.util.Date(); 


Example OOOO 


// da-ctor1.jsl 
// Date.ctor example 


import java.util.*; 


public class MyClass 











{ 
public static void main(String[] args) 
, 
// Construct a date object: 
Date d = new Date(); // Current date 
// Display the date: 
System.out.println(d); 
} 
} 
[* 
Output: 
Wed Sep @8 13:19:55 PDT 2004 
ay A 
Remarks 


The default constructor initializes any fields to their default values. 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.util Package 


Visual J# Reference 


Date Constructor (Int64) (J#) 


Package: java.sq| 


Assembly: vjslib (in vjslib.dll) 


public java.sql.Date( 
long msSinceEpoch) ; 


Parameters 
msSinceEpoch 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.sql Package 


Visual J# Reference 


Date Constructor (String) (J#) 


Constructs a new instance of a Date object and initializes it using the given string. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Date( 
java.lang.String dateStr); 


Parameters 
dateStr 


A string representation of the date to be set. The format of this string is dependent on the current Locale. 
Example 


// da-ctor2.jsl 
// Date.#ctor example 


import java.util.*; 


public class MyClass 
{ 


public static void main(String[] args) 


{ 
Date d = new Date("9/8/2004") ; 


System.out.println(d) ; 


} 


/* 

Output: 

Wed Sep 08 00:00:00 PDT 2004 
*/ 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.util Package 


Visual J# Reference 


Date Constructor (Int32, Int32, Int32) (J#) 


Constructs a new instance of a Date object and initializes it with the given year, month, and day. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Date( 
int year, 
int month, 
int day); 


Parameters 
year 


A value indicating the year. 1900 is always added to the value passed to this parameter. 
month 

A value indicating the month, where 0 represents January and 11 represents December. 
day 

A value indicating the day. The value should be between 1 and 31, or else it will wrap. 
Example 


// da-ctor4.jsl 
// Date.#ctor example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


< 
// Construct a date: Dec. 1st, 2004 


Date d = new Date(104,11,1); // 2004-1900=104 


System.out.println(d); 


/* 

Output: 

Wed Dec 01 00:00:00 PST 2004 
*/ 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.util Package 


Visual J# Reference 


Date Constructor (Int32, Int32, Int32, Int32, Int32) (J#) 


Constructs a new instance of a Date object and initializes it with the given year, month, day, hours, and minutes. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Date( 
int year, 
int month, 
int day, 
int hours, 
int minutes); 


Parameters 
year 


A value indicating the year. 1900 is always added to the value passed to this parameter. 
month 

A value indicating the month, where 0 represents January and 11 represents December. 
day 

A value indicating the day. The value should be between 1 and 31, or else it will wrap. 
hours 

A value indicating the hours. The value should be between 0 and 23, or else it will wrap. 
minutes 

A value indicating the minutes. The value should be between 0 and 59, or else it will wrap. 
Example 


// da-ctor5.jsl 
// Date.#ctor example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
// Construct a date: Jun. 3rd, 8:25 AM, 2002. 
Date d = new Date(102,5,3,8,25); 
System.out.println(d); 
} 
} 
/* 
Output: 
Mon Jun @3 08:25:00 PDT 2002 
*/ 
See Also 
Reference 
Date Class 
Concepts 


Date Members 
java.util Package 


Visual J# Reference 


Date Constructor (Int32, Int32, Int32, Int32, Int32, Int32) (J#) 


Constructs a new instance of a Date object and initializes it with the given year, month, day, hours, minutes, and seconds 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Date( 
int year, 
int month, 
int day, 
int hours, 
int minutes, 
int seconds); 


Parameters 
year 


A value indicating the year. 1900 is always added to the value passed to this parameter. 
month 

A value indicating the month, where 0 represents January and 11 represents December. 
day 

A value indicating the day. The value should be between 1 and 31, or else it will wrap. 
hours 

A value indicating the hours. The value should be between 0 and 23, or else it will wrap. 
minutes 

A value indicating the minutes. The value should be between 0 and 59, or else it will wrap. 
seconds 

A value indicating the seconds. The value should be between 0 and 59, or else it will wrap. 
Example 


// da-ctor6.jsl 
// Date.#ctor example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
J 
// Construct a date: Jun. 3rd, 8:25:24 AM, 20@2. 
Date d = new Date(102,5,3,8,25,24); 
System.out.println(d); 
} 
} 
/ * 
Output: 
Mon Jun @3 08:25:24 PDT 2002 
=f 
See Also 
Reference 


Date Class 


Concepts 
Date Members 
java.util Package 


Visual J# Reference 


Date Methods (J#) 


Public Methods 




















getTimezoneOffset 


Name Description 

after Determines whether the Date object is after a given date. (inherited from Date ) 
before Determines whether the Date object is before a given date. (inherited from Date ) 
compareTo Compares two dates. (inherited from Date ) 

equals Determines whether two Date objects are equal. (inherited from Date ) 

getDate Gets a value indicating the date. (inherited from Date ) 

getDay Gets a value indicating the day of the week. (inherited from Date ) 

hashCode Generates a hash of the date. (inherited from Date ) 

getHours Overridden. 

getMinutes Overridden. 

getMonth Gets a value indicating the month. (inherited from Date ) 

getSeconds Overridden. 

getTime Gets a value indicating the time in milliseconds since epoch. (inherited from Date ) 


Gets a value indicating the time zone offset in milliseconds. (inherited from Date ) 





























getClass (inherited from Object ) 

getYear Gets a value indicating the year. (inherited from Date ) 

clone (inherited from Date ) 

setDate Sets a value indicating the date. (inherited from Date ) 

setHours Overridden. 

setMinutes Overridden. 

setMonth Sets a value indicating the month. (inherited from Date ) 

setSeconds Overridden. 

setTime Sets the time to the value represented in milliseconds since epoch. (inherited from Date ) 
setYear Sets a value indicating the year. (inherited from Date ) 

















ToBoolean Converts an instance of a Date object to a Boolean. (inherited from Date ) 

ToByte Converts an instance of a Date object to a Byte. (inherited from Date ) 

ToChar Converts an instance of a Date object to a Char. (inherited from Date ) 

ToDateTime Converts an instance of a Date object to a DateTime. (inherited from Date ) 

ToDecimal Converts an instance of a Date object to a Decimal. (inherited from Date ) 

ToDouble Converts an instance of a Date object to a Double. (inherited from Date ) 

toGMTString Displays a value representing the date/time of a Date object in GMT. (inherited from Date ) 
Tolnt16 Converts an instance of a Date object to an Int16. (inherited from Date ) 

Tolnt32 Converts an instance of a Date object to an Int32. (inherited from Date ) 

Tolnt64 Converts an instance of a Date object to an Int64. (inherited from Date ) 





toLocaleString 


ToSByte 


ToSingle 


toString 


ToType 


ToUInt16 


ToUInt32 


ToUInt64 


valueOf 





Displays a value representing the date/time of a Date object displayed in the format of current locale. (inhe 
rited from Date ) 


Converts an instance of a Date object to a SByte. (inherited from Date ) 


Converts an instance of a Date object to a Single. (inherited from Date ) 


Overloaded. Overridden. 


Converts an instance of a Date object to a given Type. (inherited from Date ) 


Converts an instance of a Date object to an Ulnt16. (inherited from Date ) 


Converts an instance of a Date object to an Ulnt32. (inherited from Date ) 


Converts an instance of a Date object to an Ulnt64. (inherited from Date ) 


Protected Methods 





Name 


Description 





finalize 





(inherited from Object ) 








See Also 
Reference 

Date Class 
Concepts 
java.sql Package 





Visual J# Reference 


Date.after Method 


Determines whether the Date object is after a given date. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public boolean after( 
java.util.Date when); 





Parameters 
when 


The Date object to be compared against. 
Return Value 


true if an instance of a Date object is after when; false otherwise. 








Example 
// da-after1.jsl 
// Date.after example 
import java.util.*; 
public class MyClass 
public static void main(String[] args) 
{ 
// Construct two dates: 
Date d1 = new Date(102,5,3); 
Date d2 = new Date(99,4,2); 
// Compare the dates: 
boolean b = d1.after(d2); 
System.out.println(b) ; 
} 
} 
/* 
Output: 
true 
* f 
See Also 
Reference 
Date Class 
Concepts 


Date Members 
java.util Package 





Visual J# Reference 


Date.before Method 


Determines whether the Date object is before a given date. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public boolean before( 
java.util.Date when); 





Parameters 
when 


The Date object to be compared against. 
Return Value 


true if an instance of a Date object is before when; false otherwise. 








Example 
// da-before1.jsl 
// Date.after example 
import java.util.*; 
public class MyClass 
public static void main(String[] args) 
{ 
// Construct two dates: 
Date d1 = new Date(102,5,3); 
Date d2 = new Date(99,4,2); 
// Compare the dates: 
boolean b = d1.before(d2); 
System.out.println(b) ; 
} 
} 
/* 
Output: 
false 
=f 
See Also 
Reference 
Date Class 
Concepts 


Date Members 
java.util Package 





Visual J# Reference 


Date.clone Method 


Creates an instance of a Date object that is a deep copy. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





Return Value 
A deep copy of an instance of a Date object. 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.util Package 


Visual J# Reference 


Date.compareTo Method 


Compares two dates. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public int compareTo( 
java.lang.Object obj); 


Parameters 
obj 
A Date object to compare against. 
Return Value 
-1 if an instance of a Date object is before obj 
0 if the two dates are equal 
1 if an instance of a Date object is after obj. 
Example 


// da-compari1.jsl 
// Date.compareTo example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Construct two dates: 
Date d1 = new Date(102,5,3); 
Date d2 = new Date(99,4,2); 
// Compare the dates: 
System.out.println(d1.compareTo(d2) ); // 1 
System.out.println(d1.compareTo(d1) ); // @ 
System.out.println(d2.compareTo(d1)); // -1 
} 
} 
/ * 
Output: 
1 
2) 
-1 
a A 
See Also 
Reference 
Date Class 
Concepts 


Date Members 
java.util Package 


Visual J# Reference 


Date.equals Method 


Determines whether two Date objects are equal. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public boolean equals( 
java.lang.Object obj); 





Parameters 


obj 
A Date object to compare against. 
Return Value 


true if the two Date objects are equal; false otherwise. 








Example 
// da-Equalsi.jsl 
// Date.Equals example 
import java.util.*; 
public class MyClass 
public static void main(String[] args) 
{ 
// Construct two dates: 
Date d1 = new Date(102,5,3); 
Date d2 = new Date(99,4,2); 
// Compare the dates: 
System.out.printin(d1.Equals(d2)); 
} 
} 
/* 
Output 
false 
*/ 
See Also 
Reference 
Date Class 
Concepts 


Date Members 
java.util Package 





Visual J# Reference 


Date.getDate Method 


Gets a value indicating the date. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public int getDate(); 





Return Value 


A value indicating the date. The returned value will be between 1 and 31. 


Example —————————————————————— 











// da-getDate1.jsl 
// Date.getDate example 
import java.util.*; 
public class MyClass 
public static void main(String[] args) 
{ 
// Construct a date object: 
Date d = new Date(); // Current date 
// Get today's number: 
System.out.println("Today is: " + d.getDate()); 
} 
} 
/* 
Output: 
8 
*/ 
See Also 
Reference 
Date Class 
Concepts 


Date Members 
java.util Package 


Visual J# Reference 


Date.getDay Method 


Gets a value indicating the day of the week. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public int getDay(); 





Return Value 


A value indicating the day of the week. The returned value will be between 0 and 6. 


Example a 


// da-getDay1.jsl 
// Date.getDay example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Construct a date object: 


Date d = new Date("11-Dec-1314") ; 


// Get the day number: 
System.out.println("Date part in 11-Dec-1314 is: + 


d.getDay()); 
} 


/* 

Output: 

Date part in 11-Dec-1314 is: 11 
*/ 








Remarks 
The days are: Sat: 0, Mon: 1, Tue: 2, Wed: 3, Thu: 4, Fri: 5, Sat: 6. 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.util Package 


Visual J# Reference 


Date.hashCode Method 


Generates a hash of the date. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public int hashCode(); 





Return Value 


A hash value of the date. 


Example TE 











// da-HashCode1.jsl 
// Date.GetHashCode example 
import java.util.*; 
public class MyClass 
public static void main(String[] args) 
{ 
// Construct a date object: 
Date d = new Date(); // Current date 
// Get the hash code: 
System.out.println("The hash code is: " + d.GetHashCode()); 
} 
} 
/* 
Output: 
The hash code is: -538450330 
*/ 
See Also 
Reference 
Date Class 
Concepts 


Date Members 
java.util Package 


Visual J# Reference 


Date.getHours Method (J#) 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public int getHours(); 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.sql Package 


Visual J# Reference 


Date.getMinutes Method (J#) 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public int getMinutes(); 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.sql Package 


Visual J# Reference 


Date.getMonth Method 


Gets a value indicating the month. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public int getMonth(); 





Return Value 


A value indicating the month. The returned value will be between 0 and 11. 


Example ——————————————— 











// da-getMon1.jsl 
// Date.getMonth example 
import java.util.*; 
public class MyClass 
public static void main(String[] args) 
{ 
// Construct a date object: 
Date d = new Date(); // Current date 
// Get the month: 
System.out.println("The month is: " + d.getMonth()); 
} 
} 
/* 
Output: 
The month is: 8 
*/ 
See Also 
Reference 
Date Class 
Concepts 


Date Members 
java.util Package 


Visual J# Reference 


Date.getSeconds Method (J#) 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public int getSeconds(); 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.sql Package 


Visual J# Reference 


Date.getTime Method 


Gets a value indicating the time in milliseconds since epoch. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public long getTime(); 





Return Value 


A value indicating the time in milliseconds since epoch. 


Example TE 











// da-gettim1.jsl 
// Date.getTime example 
import java.util.*; 
public class MyClass 
public static void main(String[] args) 
{ 
// Construct a date object: 
Date d = new Date(); // Current date 
// Get the time in ms: 
System.out.println("The time is: " + d.getTime()); 
} 
} 
/* 
Output: 
The time is: 1094678953321 
*/ 
See Also 
Reference 
Date Class 
Concepts 


Date Members 
java.util Package 


Visual J# Reference 


Date.getTimezoneOffset Method 


Gets a value indicating the time zone offset in milliseconds. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public int getTimezoneOffset(); 


Return Value 
A value indicating the time zone offset in milliseconds. 
Example 


// da-gettimz1.jsl 
// Date.getTimezoneOffset example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Construct a date object: 
Date d = new Date(); // Current date 
// Get the timezone offset: 
System.out.println("The time offset is: " + 
d.getTimezoneOffset()); 
is 
} 
Vis 
Output: 
The time offset is: 420 
i 
Remarks 


The time offset returned is relative to UTC. 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.util Package 


Visual J# Reference 


Date.getYear Method 


Gets a value indicating the year. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public int getYear(); 





Return Value 


A value indicating the year. The returned value will be the current year - 1900. 


Example ee 











// da-getY1.jsl 
// Date.getYear example 
import java.util.*; 
public class MyClass 
public static void main(String[] args) 
{ 
// Construct a date object: 
Date d = new Date(); // Current date 
// Get the year (The year - 1900): 
System.out.println("The year is: " + d.getYear()); 
} 
} 
/* 
Output: 
The year is: 104 
*/ 
See Also 
Reference 
Date Class 
Concepts 


Date Members 
java.util Package 


Visual J# Reference 


Date.parse Method 


Parses a date written in string format. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static long parse( 
java.lang.String s); 


Parameters 
s 
A representation of a Date in string format. The format for this string will vary according to the value of the current Locale. 
Return Value 
A value indicating the time of the given string in milliseconds since epoch. 
Example 


// da-parse1.jsl 
// Date.parse example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Construct a date object: 
Date d = new Date(); // Current date 
// Parse the date: 
System.out.printin("The time in ms is: " + 
d.parse("9/8/2004")); 
} 
} 
/* 
Output: 
The time in ms is: 1094626800000 
*/ 
See Also 
Reference 
Date Class 
Concepts 


Date Members 
java.util Package 


Visual J# Reference 


Date.setDate Method 


Sets a value indicating the date. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public void setDate( 
int day); 





Parameters 
day 


A value indicating the date. The value should be between 1 and 31, or else it will wrap. 








Example 
// da-setDate1.jsl 
// Date.setDate example 
import java.util.*; 
public class MyClass 
{ 
public static void main(String[] args) 
{ 
// Construct a date object: 
Date d = new Date(); // Current date 
// Set the day: 
d.setDate(8) ; 
System.out.println("The day is set."); 
} 
: 
/* 
Output: 
The day is set. 
a7 
See Also 
Reference 
Date Class 
Concepts 


Date Members 
java.util Package 





Visual J# Reference 


Date.setHours Method (J#) 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public void setHours( 
int hour); 


Parameters 
hour 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.sql Package 


Visual J# Reference 


Date.setMinutes Method (J#) 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public void setMinutes( 
int minute) ; 


Parameters 
minute 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.sql Package 


Visual J# Reference 


Date.setMonth Method 


Sets a value indicating the month. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void setMonth( 
int month); 


Parameters 
month 

A value indicating the month. The value should be between 0 and 11, or else it will wrap. 
Example 


// da-setMon1.jsl 
// Date.setMonth example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Construct a date object: 
Date d = new Date(); // Current date 
// Set the month: 
d.setMonth(9) ; 
System.out.println("The month is set."); 
i; 
I 
/* 
Output: 
The month is set. 
* 
See Also 
Reference 
Date Class 
Concepts 


Date Members 
java.util Package 


Visual J# Reference 


Date.setSeconds Method (J#) 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public void setSeconds( 
int second); 


Parameters 
second 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.sql Package 


Visual J# Reference 


Date.setTime Method 


Sets the time to the value represented in milliseconds since epoch. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public void setTime( 
long time); 





Parameters 
time 


The time, in milliseconds, since epoch. 








Example 
// da-settim1.jsl 
// Date.setTime example 
import java.util.*; 
public class MyClass 
{ 
public static void main(String[] args) 
{ 
// Construct a date object: 
Date d = new Date(); // Current date 
// Set the time: 
d.setTime(10946268) ; 
System.out.println("The time is set."); 
} 
: 
/* 
Output: 
The time is set. 
=/ 
See Also 
Reference 
Date Class 
Concepts 


Date Members 
java.util Package 





Visual J# Reference 


Date.setYear Method 


Sets a value indicating the year. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public void setYear( 
int year); 





Parameters 
year 


A value indicating the year. This value should be the current year - 1900. 








Example 
// da-setYeari1.jsl 
// Date.setYear example 
import java.util.*; 
public class MyClass 
{ 
public static void main(String[] args) 
{ 
// Construct a date object: 
Date d = new Date(); // Current date 
// Set the year: 
d.setYear(1900 + 104); 
System.out.println("The year is set to: " + d.getYear()); 
} 
: 
/* 
Output: 
The year is set to: 2004 
a7 
See Also 
Reference 
Date Class 
Concepts 


Date Members 
java.util Package 





Visual J# Reference 


Date. ToBoolean Method 


Converts an instance of a Date object to a Boolean. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean ToBoolean( 
System. IFormatProvider provider) ; 


Parameters 
provider 


Provides information needed for formatting. 
Return Value 
A Boolean object representing a Date object. 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.util Package 


Visual J# Reference 


Date.ToByte Method 


Converts an instance of a Date object to a Byte. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public System.Byte ToByte( 
System. IFormatProvider provider) ; 


Parameters 
provider 


Provides information needed for formatting. 
Return Value 
A Byte object representing a Date object. 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.util Package 
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Date. ToChar Method 


Converts an instance of a Date object to a Char. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public char ToChar( 
System. IFormatProvider provider) ; 


Parameters 
provider 


Provides information needed for formatting. 
Return Value 
A Char object representing a Date object. 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.util Package 
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Date. ToDateTime Method 


Converts an instance of a Date object to a DateTime. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public System.DateTime ToDateTime( 
System. IFormatProvider provider) ; 


Parameters 
provider 


Provides information needed for formatting. 
Return Value 
A DateTime object representing a Date object. 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.util Package 
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Date.ToDecimal Method 


Converts an instance of a Date object to a Decimal. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public System.Decimal ToDecimal ( 
System. IFormatProvider provider) ; 


Parameters 
provider 


Provides information needed for formatting. 
Return Value 
A Decimal object representing a Date object. 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.util Package 
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Date. ToDouble Method 


Converts an instance of a Date object to a Double. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public double ToDouble( 
System. IFormatProvider provider) ; 


Parameters 
provider 


Provides information needed for formatting. 
Return Value 
A Double object representing a Date object. 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.util Package 
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Date.toGMTString Method 


Displays a value representing the date/time of a Date object in GMT. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toGMTString(); 


Return Value 
A value representing the date/time of a Date object in GMT, or Greenwich Mean Time. 
Example 


// da-toGMT1.js1 
// Date.toGMTString example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Construct a date object: 
Date d = new Date(); // Current date 
// To GMT time: 
System.out.println("The GMT time is: " + d.toGMTString()); 
} 
} 
/* 
Output: 
The GMT time is: 8 Sep 2004 22:53:04 GMT 
*/ 
Remarks 


GMT is sometimes referred to as UTC, or Universal Time Coordinated. 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.util Package 
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Date.TolInt16 Method 


Converts an instance of a Date object to an Int16. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public short ToInt16( 
System. IFormatProvider provider) ; 


Parameters 
provider 


Provides information needed for formatting. 
Return Value 
An Int16 object representing a Date object. 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.util Package 
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Date.ToInt32 Method 


Converts an instance of a Date object to an Int32. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public int ToInt32( 
System. IFormatProvider provider) ; 


Parameters 
provider 


Provides information needed for formatting. 
Return Value 
An Int32 object representing a Date object. 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.util Package 
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Date.TolInt64 Method 


Converts an instance of a Date object to an Int64. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public long ToInt64( 
System. IFormatProvider provider) ; 


Parameters 
provider 


Provides information needed for formatting. 
Return Value 
An Int64 object representing a Date object. 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.util Package 
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Date.toLocaleString Method 


Displays a value representing the date/time of a Date object displayed in the format of current locale. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toLocaleString(); 


Return Value 
A value representing the date/time of a Date object displayed in the format of the current locale. 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.util Package 


Visual J# Reference 


Date.ToSByte Method 


Converts an instance of a Date object to a SByte. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public byte ToSByte( 
System. IFormatProvider provider) ; 


Parameters 
provider 


Provides information needed for formatting. 
Return Value 
An SByte object representing a Date object. 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.util Package 
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Date.ToSingle Method 


Converts an instance of a Date object to a Single. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public float ToSingle( 
System. IFormatProvider provider) ; 


Parameters 
provider 


Provides information needed for formatting. 
Return Value 
A Single object representing a Date object. 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.util Package 
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Date.toString Method (J#) 


Overload List 





Name Description 





Date.ToString () Displays a human readable representation of a Date object. 





Date.ToString (IFormatProvider) Converts an instance of a Date object to a String. 











See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.util Package 
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Date.toString Method () (J#) 


Package: java.sql 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toString(); 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.sql Package 
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Date.toString Method (IFormatProvider) (J#) 


Converts an instance of a Date object to a String. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String ToString( 
System. IFormatProvider provider) ; 


Parameters 
provider 


Provides information needed for formatting. 
Return Value 
A String object representing a Date object. 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.util Package 
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Date.ToType Method 


Converts an instance of a Date object to a given Type. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object ToType( 
System.Type conversionType, 
System.IFormatProvider provider) ; 


Parameters 
conversionType 


The Type to convert the Date object into. 
provider 
Provides information needed for formatting. 
Return Value 
An object of type conversionType representing a Date object. 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.util Package 
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Date. ToUInt16 Method 


Converts an instance of a Date object to an Ulnt16. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public System.UInt16 ToUInt16( 
System. IFormatProvider provider) ; 


Parameters 
provider 


Provides information needed for formatting. 
Return Value 
An UInt16 object representing a Date object. 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.util Package 
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Date. ToUInt32 Method 


Converts an instance of a Date object to an Ulnt32. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public System.UInt32 ToUInt32( 
System. IFormatProvider provider) ; 


Parameters 
provider 


Provides information needed for formatting. 
Return Value 
An UInt32 object representing a Date object. 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.util Package 
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Date. ToUInt64 Method 


Converts an instance of a Date object to an Ulnt64. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public System.UInt64 ToUInt64( 
System. IFormatProvider provider) ; 


Parameters 
provider 


Provides information needed for formatting. 
Return Value 
An UInt64 object representing a Date object. 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.util Package 


Visual J# Reference 


Date.UTC Method 


Calculates the value, in milliseconds, of the provided date/time converted to UTC. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static long UTC( 
int year, 
int month, 
int day, 
int hours, 
int minutes, 
int seconds); 


Parameters 
year 


A value indicating the year. This value should be the current year - 1900 
month 

A value indicating the month, where 0 represents January and 11 represents December. 
day 

A value indicating the day. The value should be between 1 and 31, or else it will wrap. 
hours 

A value indicating the hours. The value should be between 0 and 23, or else it will wrap. 
minutes 

A value indicating the minutes. The value should be between 0 and 59, or else it will wrap. 
seconds 

A value indicating the seconds. The value should be between 0 and 59, or else it will wrap. 
Return Value 
The time, represented in milliseconds, of the provided date/time, converted to UTC. 
Example 


// da-DateUTC.jsl 
// Date.Date.UTC example 


import java.util.*; 


public class MyClass 
{ 
public static void main(String[] args) 
{ 
// Construct a date object: 
Date d = new Date(); // Current date 


// Calculate UTC: 
long 1 = d.UTC( 
1900+140, // year 


8, // month 
3, // day 
16, // hours 
2, // minutes 
30 // seconds 





// Display the date: 
System.out.println("The date in ms is: " + 1); 
} 
} 
/* 
Output: 
The date in ms is: 62188444950000 
wf 
Remarks 


UTC, or Universal Time Coordinated, is also sometimes referred to as GMT, or Greenwich Mean Time. 


See Also 
Reference 

Date Class 
Concepts 

Date Members 
java.util Package 
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Dictionary Class 


An abstract class that contains a map of elements associated with keys. Both elements and keys are non-null objects. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public abstract class java.util.Dictionary 
extends java.lang.Object 





Remarks 
This class is extended by the Hashtable class. 
Inheritance Hierarchy 
java.lang.Object 
java.util.Dictionary 
java.util.Hashtable 


See Also 

Concepts 

Dictionary Members 
java.util Package 
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Dictionary Members 


An abstract class that contains a map of elements associated with keys. Both elements and keys are non-null objects. 


The following tables list the members exposed by the Dictionary type. 


Public Constructors 





Name Description 





Dictionary This constructor is used by subclasses. 





Public Methods 








Name Description 

elements Returns an enumeration that contains the values in a Dictionary object. 
equals (inherited from Object ) 

get Retrieves an element associated with a specified key in a Dictionary object. 





hashCode (inherited from Object ) 























getClass (inherited from Object ) 

isEmpty Checks if a Dictionary object is empty. 

keys Returns an enumeration of the keys in a Dictionary object. 

put Adds an element at a specific key entry to a Dictionary object. 

remove Deletes an element associated with a specific key from a Dictionary object. 
size Retrieves the number of the key-value mappings of a Dictionary object. 
toString Overridden. Generates the string representation of a Hashtable object. 








Protected Methods 
Name Description 


finalize (inherited from Object ) 


MemberwiseClone Performs a shallow copy of the members. 





See Also 
Reference 
Dictionary Class 
Concepts 
java.util Package 
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Dictionary Constructor 


This constructor is used by subclasses. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.util.Dictionary(); 


Example ——________________céct___§_~" 


// Create a new hashtable object: 
Dictionary ht = new Hashtable(); 











Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
Dictionary Class 
Concepts 

Dictionary Members 
java.util Package 
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Dictionary Methods 


Public Methods 









































Name Description 

elements Returns an enumeration that contains the values in a Dictionary object. 
equals (inherited from Object ) 

get Retrieves an element associated with a specified key in a Dictionary object. 
hashCode (inherited from Object ) 

getClass (inherited from Object ) 

isEmpty Checks if a Dictionary object is empty. 

keys Returns an enumeration of the keys in a Dictionary object. 

put Adds an element at a specific key entry to a Dictionary object. 

remove Deletes an element associated with a specific key from a Dictionary object. 
size Retrieves the number of the key-value mappings of a Dictionary object. 
toString Overridden. Generates the string representation of a Hashtable object. 
Protected Methods 

Name Description 

finalize (inherited from Object ) 

MemberwiseClone Performs a shallow copy of the members. 

See Also 

Reference 

Dictionary Class 

Concepts 


java.util Package 
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Dictionary.elements Method 


Returns an enumeration that contains the values in a Dictionary object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.util.Enumeration elements(); 


Return Value 
The current value at the key entry. 
Example 

// Dic-put1.jsl 

// Dictionary.put example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Create a new hashtable object: 
Hashtable ht = new Hashtable(); 
// Add some elements: 
System.out.printin("The current value at \"4\" is " + ht.put("4", "Eve Kennedy") ); 
// Add a key that is already present. 
System.out.printin("The current value at \"4\" is " + ht.put("4", "Jack")); 
} 
/* 
Output: 


The current value at “4” is null 
The current value at “4” is Eve Kennedy 


ee 


See Also 

Reference 
Dictionary Class 
Concepts 

Dictionary Members 
java.util Package 
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Dictionary.get Method 


Retrieves an element associated with a specified key in a Dictionary object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.Object get( 
java.lang.Object key); 


Parameters 
key 
The key of the element. 
Return Value 
The element associated with key. 
Example 


// Dic-get1.jsl 
// Dictionary.get example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a new hashtable object: 
Dictionary ht = new Hashtable(); 
// Add some elements: 
ht.put("4","Eve Kennedy"); 
ht.put("1","Isabella Abolrous"); 
ht.put("2","Camelia Solomon"); 
ht.put("6","Nick Fredette") ; 
// Get the elemnt associated with the key "6": 
System.out.printlin(ht.get("6")); 
} 
} 
/* 
Output: 
Nick Fredette 
= 
See Also 
Reference 
Dictionary Class 
Concepts 


Dictionary Members 
java.util Package 
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Dictionary.isEmpty Method 


Checks if a Dictionary object has no key/value pairs. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean isEmpty(); 


Return Value 
true if the Dictionary object has no key/value pairs; false otherwise. 
Example 


// Dic-isempt1.jsl 
// Dictionary.isEmpty example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a new hashtable object: 
Hashtable ht = new Hashtable(); 
// Add some elements: 
ht.put("4","Eve Kennedy") ; 
ht.put("1","Isabella Abolrous"); 
ht.put("2","Camelia Solomon"); 
// Clear the elements: 
ht.clear(); 
// Check if the object is empty: 
System.out.println(ht.isEmpty()); 
} 
} 
/* 
Output: 
true 
af 
See Also 
Reference 
Dictionary Class 
Concepts 


Dictionary Members 
java.util Package 
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Dictionary.keys Method 


Returns an enumeration of the keys in a Dictionary object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.util.Enumeration keys(); 


Return Value 
An enumeration of the keys in the Dictionary object. 
Example 


// Dic-keys1.jsl 
// Dictionary.keys example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a new hashtable object: 
Dictionary ht = new Hashtable(); 
// Add some elements: 
ht.put("4","Eve Kennedy"); 
ht.put("1","Isabella Abolrous"); 
ht.put("2","Nick Fredette") ; 
// Create an enumeration of the table keys: 
Enumeration htEnum = ht.keys(); 
// Enumerate over the key values: 
System.out.println("The table keys are:"); 
while (htEnum.hasMoreElements()) 
{ 
System.out.println(htEnum.nextElement() ); 
} 
} 
} 
/* 
Output: 
The table keys are: 
4 
2 
1 
*/ 
See Also 
Reference 
Dictionary Class 
Concepts 


Dictionary Members 
java.util Package 
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Dictionary.put Method 


Adds an element at a specific key entry to a Dictionary object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.Object put( 
java.lang.Object key, 
java.lang.Object element) ; 


Parameters 


key 
The key entry at which the element is added. 
element 
The element to be added. 
Return Value 
The element to be added to Dictionary and the key entry. 
Example 


// Dic-put1.jsl 
// Dictionary.put example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Create a new hashtable object: 
Hashtable ht = new Hashtable(); 
// Add some elements: 
System.out.printin("The current value at \"4\" is " + ht.put("4", "Eve Kennedy") ); 
// Add a key that is already present: 
System.out.printin("The current value at \"4\" is " + ht.put("4", "Jack")); 
} 
} 
/* 
Output: 


The current value at “4” is null 
The current value at “4” is Eve Kennedy 


i | 


See Also 

Reference 
Dictionary Class 
Concepts 

Dictionary Members 
java.util Package 
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Dictionary.remove Method 


Removes the element with the specified key from the Dictionary object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.Object remove( 
java.lang.Object key); 


Parameters 


key 

The key of the element to remove. 
Return Value 
The value associated with the specified key. 
Example 


// Dic-rem1.jsl 
// Dictionary.remove example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 
{ 
// Create a new hashtable object: 
Dictionary ht = new Hashtable(); 


// Add some elements: 
ht.put("3","Sally Abolrous"); 
ht.put("2","Craig Combel"); 
ht.put("5","Pille Mandla"); 


// Remove an object: 
System.out.println("The following object has been removed:\n" + 
ht.remove("5")); 


} 


/* 

Output: 

The following object has been removed: 
Pille Mandla 

*/ 


See Also 

Reference 
Dictionary Class 
Concepts 

Dictionary Members 
java.util Package 
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Dictionary.size Method 


Retrieves the number of the key-value mappings of a Dictionary object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public abstract int size(); 





Return Value 


The number of the key-value mappings of the Dictionary object. 


Example 


// Dic-size1.jsl 
// Dictionary.size example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 
{ 
// Create a new hashtable object: 
Dictionary ht = new Hashtable(); 


// Add some elements: 
ht.put("4","Eve Kennedy"); 
ht.put("1","Isabella Abolrous"); 
ht.put("2","Nick Fredette") ; 


// Display the table size: 
System.out.println("The size of the table is: " + ht.size()); 


} 


/* 

Output: 

The size of the table is: 3 
yd 








See Also 

Reference 
Dictionary Class 
Concepts 

Dictionary Members 
java.util Package 
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EmptyStackException Class 


The exception that is thrown when attempting to pop an element off of an empty stack. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public class java.util.EmptyStackException 
extends java. lang.RuntimeException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.lang.RuntimeException 
java.util.EmptyStackException 


See Also 

Concepts 

EmptyStackException Members 
java.util Package 
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EmptyStackException Members 


The exception that is thrown when attempting to pop an element off of an empty stack. 


The following tables list the members exposed by the EmptyStackException type. 


Public Constructors 





Name 


Description 





EmptyStackException 


Overloaded. Initializes a new instance of an EmptyStackException object. 





Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 


Description 


(inherited from Exception ) 








Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 








printStackTrace 





getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 

clone (inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 








toString 


(inherited from Throwable ) 





Protected Methods 
Name 


finalize 





See Also 

Reference 
EmptyStackException Class 
Concepts 

java.util Package 





(inherited from Object ) 
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EmptyStackException Constructor 


Initializes a new instance of an EmptyStackException object. 


Overload List 
Name Description 


EmptyStackException () Initializes a new instance of an EmptyStackException object. 


EmptyStackException (SerializationInfo, StreamingContext)|Initializes a new instance of an EmptyStackException object during 
deserialization. 





EmptyStackException (String, Exception) Initializes a new instance of an EmptyStackException object with th 
e given message and inner exception. 





See Also 

Reference 
EmptyStackException Class 
Concepts 

EmptyStackException Members 
java.util Package 
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EmptyStackException Constructor () 


Initializes a new instance of an EmptyStackException object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util. EmptyStackException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
EmptyStackException Class 
Concepts 

EmptyStackException Members 
java.util Package 
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EmptyStackException Constructor (SerializationInfo, 
StreamingContext) 


Initializes a new instance of an EmptyStackException object during deserialization. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


protected java.util. EmptyStackException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
EmptyStackException Class 
Concepts 

EmptyStackException Members 
java.util Package 
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EmptyStackException Constructor (String, Exception) 


Initializes a new instance of an EmptyStackException object with the given message and inner exception. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util. EmptyStackException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the exceptional condition. 
inner 
An inner exception that led to the EmptyStackException being thrown. 


See Also 

Reference 
EmptyStackException Class 
Concepts 

EmptyStackException Members 
java.util Package 
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EmptyStackException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


EmptyStackException Class 


Concepts 
java.util Package 
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EmptyStackException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 

Reference 
EmptyStackException Class 
Concepts 

java.util Package 
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Enumeration Interface 


Provides an efficient mechanism to traverse the elements of various collections. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public interface java.util.Enumeration 


Example 


The following example demonstrates how to use an Enumeration to enumerate over the elements in a Hashtable. 


// en-Enum1.jsl 
// Enumeration example 


import java.util.*; 


class MyClass 


{ 
public static void main(String[] args) 
{ 
// Create a HashTable: 
Hashtable ht = new Hashtable(); 
// Add some elements: 
ht.put("1","Eve Kennedy") ; 
ht.put("2","Audrey Esteban"); 
ht.put("5","Emma Esteban"); 
// Enumerate over the values that were just added. 
Enumeration htEnum = ht.elements(); 
while (htEnum.hasMoreElements()) 
{ 
System.out.println(htEnum.nextElement() ); 
} 
} 
; 
/* 
Output: 


Emma Esteban 
Audrey Esteban 
Eve Kennedy 


*/ 


See Also 

Concepts 

Enumeration Members 
java.util Package 
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Enumeration Members 


Provides an efficient mechanism to traverse the elements of various collections. 


The following tables list the members exposed by the Enumeration type. 


Public Methods 





Name Description 





hasMoreElements/Determines whether there are any more elements in the collection beyond where the enumerator is currentl 
y positioned. 


nextElement Advances the enumerator one step in the collection and retrieves the element at that position. 








See Also 

Reference 
Enumeration Interface 
Concepts 

java.util Package 
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Enumeration Methods 


Public Methods 
Name Description 








hasMoreElements|Determines whether there are any more elements in the collection beyond where the enumerator is currentl 
y positioned. 





nextElement Advances the enumerator one step in the collection and retrieves the element at that position. 








See Also 

Reference 
Enumeration Interface 
Concepts 

java.util Package 
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Enumeration.hasMoreElements Method 


Determines whether there are any more elements in the collection beyond where the enumerator is currently positioned. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean hasMoreElements(); 


Return Value 

true if there are more elements in the collection beyond where the enumerator is currently positioned; false otherwise. 
Example 

See the example on Enumeration. 


See Also 

Reference 
Enumeration Interface 
Concepts 

Enumeration Members 
java.util Package 
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Enumeration.nextElement Method 


Advances the enumerator one step in the collection and retrieves the element at that position. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.Object nextElement(); 


Return Value 

The element in the collection one step beyond where the enumerator was positioned before nextElement was called. 
Example 

See the example on Enumeration. 


See Also 

Reference 
Enumeration Interface 
Concepts 

Enumeration Members 
java.util Package 
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EventListener Interface 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public interface java.util.EventListener 


See Also 
Concepts 
java.util Package 
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EventObject Class 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public class java.util.EventObject 
extends java.lang.Object 
implements java.io.Serializable 





Inheritance Hierarchy 
java.lang.Object 
java.util.EventObject 
java.aawtAWTEvent 
java.beans.PropertyChangeEvent 


See Also 

Concepts 

EventObject Members 
java.util Package 
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EventObject Members 


The following tables list the members exposed by the EventObject type. 


Public Constructors 
Name 


EventObject 





Public Fields 





Name Description 





source 








Public Methods 























Name Description 

equals (inherited from Object) 
hashCode (inherited from Object) 
GetObjectData 

getSource 

getClass (inherited from Object) 
toString Overridden. 








Protected Methods 


Name Description 


finalize (inherited from Object) 








See Also 
Reference 
EventObject Class 
Concepts 

java.util Package 
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EventObject Fields 


Public Fields 





Name Description 





source 














See Also 
Reference 
EventObject Class 
Concepts 

java.util Package 
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EventObject.source Field 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





protected transient java.lang.Object source; 





See Also 

Reference 
EventObject Class 
Concepts 

EventObject Members 
java.util Package 
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EventObject Constructor 


Overload List 





Name 


Description 





EventObject (Object) 





EventObject (SerializationInfo, StreamingContext) 











See Also 

Reference 
EventObject Class 
Concepts 

EventObject Members 
java.util Package 
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EventObject Constructor (Object) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.EventObject( 
java.lang.Object source); 


Parameters 
source 


See Also 

Reference 
EventObject Class 
Concepts 

EventObject Members 
java.util Package 
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EventObject Constructor (SerializationInfo, StreamingContext) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


protected java.util.EventObject( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


context 


See Also 

Reference 
EventObject Class 
Concepts 

EventObject Members 
java.util Package 
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EventObject Methods 


Public Methods 























Protected Methods 


Name Description 

equals (inherited from Object) 
hashCode (inherited from Object) 
GetObjectData 

getSource 

getClass (inherited from Object) 
toString Overridden. 








Name 


Description 





finalize 








(inherited from Object) 





See Also 
Reference 
EventObject Class 
Concepts 

java.util Package 
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EventObject.GetObjectData Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void GetObjectData( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


context 


See Also 

Reference 
EventObject Class 
Concepts 

EventObject Members 
java.util Package 
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EventObject.getSource Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object getSource(); 


See Also 

Reference 
EventObject Class 
Concepts 

EventObject Members 
java.util Package 
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EventObject.toString Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String toString(); 


See Also 

Reference 
EventObject Class 
Concepts 

EventObject Members 
java.util Package 
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GregorianCalendar Class 


Extends the abstract class Calendar and provides the common standard calendar. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public class java.util.GregorianCalendar 
extends java.util.Calendar 





Inheritance Hierarchy 

java.lang.Object 
java.util.Calendar 
java.util.GregorianCalendar 


See Also 

Concepts 

GregorianCalendar Members 
java.util Package 
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GregorianCalendar Members 


Extends the abstract class Calendar and provides the common standard calendar. 


The following tables list the members exposed by the GregorianCalendar type. 


Public Constructors 





Name 


Description 











GregorianCalendar Overloaded. 

Public Fields 

Name Description 

AD Represents the ERA field, which indicates the Common Era, in a GregorianCalendar object. 





areFieldsSet|Determines whether all the fields of a Calendar object are set.(inherited from Calendar) 











BC Represents the ERA field, which indicates the period before the Common Era, in a GregorianCalendar object. 
fields An array of all the fields that can be set.(inherited from Calendar) 
isSet An array of boolean values indicating which fields are set and which fields are not set.(inherited from Calendar) 





isTimeSet |A value indicating whether the time is set.(inherited from Calendar) 





time A field containing the time in milliseconds.(inherited from Calendar) 





Public Methods 
Name 


Description 





computeFields 


computeTime 


add Overridden. Adds the specified amount of time to a calendar field. 

after Overridden. Determines whether the date-time in an instance of a GregorianCalendar object is aft 
er the date-time in the calendar specified. 

before Overridden. Determines whether the date-time in an instance of a GregorianCalendar object is be 
fore the date-time in the calendar specified. 

clear Overloaded. Clears the fields of an instance of a Calendar object. (inherited from Calendar) 

complete Sets all the fields of an instance of a Calendar object. (inherited from Calendar) 


Overridden. Computes values for all the fields of an instance of a GregorianCalendar object. 


Overridden. Computes the time for a current instance of a GregorianCalendar object. 





equals 


Overridden. Determines whether two GregorianCalendar objects are equal. 





get 


Gets the value of the specified field. (inherited from Calendar) 





getFirstDayOfWeek 


Gets a value representing the first day of the week. (inherited from Calendar) 





getGreatestMinimum 








Overridden. Gets a value representing the greatest possible minimum value for a given field. 











getGregorianChange 


Retrieves the date of switching from Julian to Gregorian calendar. 





hashCode 


Overridden. Returns the hash code of a GregorianCalendar object. 





getLeastMaximum 


Overridden. Gets a value representing the smallest possible maximum value for a given field. 





getMaximum 


Overridden. Gets a value representing the maximum value for a given field. 





getMinimalDaysInFirstWeek 


getMinimum 


getTime 


Gets a value representing the minimal number of days for the first week of the calendar year. (inh 
erited from Calendar) 


Overridden. Gets a value representing the minimum value for a given field. 


Gets a Date representing the time of a Calendar object. (inherited from Calendar) 





getTimelnMillis 


Gets the time of a Calendar object represented in milliseconds. (inherited from Calendar) 





getTimeZone 


Gets the TimeZone of a Calendar object. (inherited from Calendar) 

















getClass (inherited from Object) 

internalGet Gets the value of a given field. (inherited from Calendar) 

isLeapYear Checks if a specified year is a leap year. 

isLenient Determines whether a given Calendar is lenient. (inherited from Calendar) 
isSet Determines whether a given field is set. (inherited from Calendar) 





MemberwiseClone 


(inherited from Calendar) 





roll 


Overridden. Modifies the value of a given field by one. 





set 


Overloaded. Sets various fields of a Calendar object. (inherited from Calendar) 





setFirstDayOfWeek 


Sets a value representing the first day of the week. (inherited from Calendar) 





setGregorianChange 


Sets a specified date for the GregorianCalendar calendar change. 





setLenient 


Sets a value that determines whether a given Calendar is lenient. (inherited from Calendar) 





setMinimalDaysInFirstWeek 


setTime 


Sets a value representing the minimal number of days for the first week of the calendar year. (inh 
erited from Calendar) 


Sets the time of a Calendar object to the given Date. (inherited from Calendar) 








setTimelnMillis 


setTimeZone 


toString 





Sets the time of a Calendar object to a value represented in milliseconds. (inherited from 
Calendar) 


Sets the TimeZone of a Calendar object. (inherited from Calendar) 


Generates a human readable representation of a Calendar object. (inherited from Calendar) 





Protected Methods 
Name ——iescription, eeeeeesess—s—‘—ssS 





See Also 

Reference 
GregorianCalendar Class 
Concepts 

java.util Package 
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GregorianCalendar Fields 


Public Fields 





Name Description 





AD Represents the ERA field, which indicates the Common Era, in a GregorianCalendar object. 





areFieldsSet |Determines whether all the fields of a Calendar object are set. (inherited from Calendar ) 

















BC Represents the ERA field, which indicates the period before the Common Era, in a GregorianCalendar object. 
fields An array of all the fields that can be set. (inherited from Calendar ) 

isSet An array of boolean values indicating which fields are set and which fields are not set. (inherited from Calendar ) 
isTimeSet —|A value indicating whether the time is set. (inherited from Calendar ) 

time A field containing the time in milliseconds. (inherited from Calendar ) 

See Also 

Reference 

GregorianCalendar Class 

Concepts 


java.util Package 
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GregorianCalendar.AD Field 


Represents the ERA field, which indicates the Common Era, in a GregorianCalendar object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final int AD; 


Example OOOO 


// gcal-BC_AD.jsl 
// GregorianCalendar.AD-BC example 


import java.util.*; 


public class MyClass 








{ 
public static void main(String[] args) 
i 
// Create a calendar object: 
GregorianCalendar cal = new GregorianCalendar(2004,9,10); 
// Display the contants BC AD: 
System.out.println("BC = " + cal.BC); // ®@ 
System.out.println("AD = " + cal.AD); // 1 
} 
} 
/* 
Output 
(4) 
1 
| 
Remarks 


The Common Era is also known as CE. 


See Also 

Reference 
GregorianCalendar Class 
Concepts 

GregorianCalendar Members 
java.util Package 
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GregorianCalendar.BC Field 


Represents the ERA field, which indicates the period before the Common Era, in a GregorianCalendar object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final int BC; 





Example 

See the example on AD. 

Remarks 

The period before the Common Era is also known as BCE. 


See Also 

Reference 
GregorianCalendar Class 
Concepts 

GregorianCalendar Members 
java.util Package 
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GregorianCalendar Constructor 


Overload List 





Name 


Description 





GregorianCalendar () 


Constructs a new GregorianCalendar object. 





GregorianCalendar (Locale) 


Constructs a new GregorianCalendar object with a specified locale. 





GregorianCalendar (TimeZone) 


Constructs a new GregorianCalendar object with a specified time zone. 





GregorianCalendar (TimeZone, Locale) 


Constructs a new GregorianCalendar object with a specified time zone and locale. 





GregorianCalendar (int, int, int) 


Constructs a new GregorianCalendar object with a specified date using the default ti 
me zone and locale. 





GregorianCalendar (int, int, int, int, int) 


GregorianCalendar (int, int, int, int, int, int) 








Constructs a new GregorianCalendar object with a specified date using the default ti 
me zone and locale. 


Constructs a new GregorianCalendar object with a specified date using the default ti 
me zone and locale. 





See Also 

Reference 
GregorianCalendar Class 
Concepts 

GregorianCalendar Members 
java.util Package 
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GregorianCalendar Constructor () 


Constructs a new GregorianCalendar object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.util.GregorianCalendar(); 


Example OC 


// Create a calendar object: 
Calendar cal = new GregorianCalendar(); 











Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
GregorianCalendar Class 
Concepts 

GregorianCalendar Members 
java.util Package 
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GregorianCalendar Constructor (Locale) 


Constructs a new GregorianCalendar object with a specified locale. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.GregorianCalendar( 
java.util.Locale aLocale); 


Parameters 
aLocale 

The specified locale. 
Example 


// gcal-ctor2.jsl 
// GregorianCalendar #ctor example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Create a locale: 
Locale loc = new Locale("en","us"); 
// Create a calendar object using loc: 
Calendar cal = new GregorianCalendar(loc); 
} 
} 
See Also 
Reference 
GregorianCalendar Class 
Concepts 


GregorianCalendar Members 
java.util Package 
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GregorianCalendar Constructor (TimeZone) 


Constructs a new GregorianCalendar object with a specified time zone. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.GregorianCalendar( 
java.util.TimeZone zone); 


Parameters 
zone 

The specified time zone. 
Example 


// gcal-ctor3.jsl 
// GregorianCalendar #ctor example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Create Pacific time zone with -8 hours offset: 
TimeZone tz = new SimpleTimeZone(-28800000, 
"America/Los_ Angeles"); 
// Create a calendar object using the time zone: 
Calendar cal = new GregorianCalendar(tz) ; 
// Display the time zone offset: 
System.out.println("TZ offset in hours: " + 
cal.get(Calendar.ZONE_OFFSET)/(1000*60*6@) ); 
} 
} 
/ * 
Output: 
TZ offset in hours: -8 
*/ 
See Also 
Reference 
GregorianCalendar Class 
Concepts 


GregorianCalendar Members 
java.util Package 
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GregorianCalendar Constructor (TimeZone, Locale) 


Constructs a new GregorianCalendar object with a specified time zone and locale. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.GregorianCalendar( 
java.util.TimeZone zone, 
java.util.Locale aLocale); 


Parameters 
zone 


The specified time zone. 
aLocale 

The specified locale. 
Example 


// gcal-ctor4.jsl 
// GregorianCalendar #ctor example 


import java.util.*; 


public class MyClass 
{ 


public static void main(String[] args) 


// Create Pacific time zone with -8 hours offset: 
TimeZone tz = new SimpleTimeZone( -28800000, 
"America/Los Angeles"); 


// Create a locale: 
Locale loc = new Locale("en","us"); 
Calendar cal = new GregorianCalendar(tz, loc); 


// Display the locale and time zone offset: 

System.out.println("Locale: " + loc); 

System.out.println("TZ offset in hours: " + 
cal.get(Calendar.ZONE_OFFSET)/(1000*60*6@) ); 


} 


/* 

Output: 

Locale: en_US 

TZ offset in hours: -8 
*/ 


See Also 

Reference 
GregorianCalendar Class 
Concepts 

GregorianCalendar Members 
java.util Package 
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GregorianCalendar Constructor (Int32, Int32, Int32) 


Constructs a new GregorianCalendar object with a specified date using the default time zone and locale. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.GregorianCalendar( 
int year, 
int month, 
int date); 


Parameters 
year 

The specified year. 
month 

The specified month. 
date 

The specified day. 
Example 


// gcal-ctor5.jsl 
// GregorianCalendar.#ctor example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Construct a calendar: 
Calendar cal = new GregorianCalendar(1999,8,12); 
// Get and display information from the calendar: 
System.out.printin("Year: " + cal.get(Calendar.YEAR) ); 
System.out.println("Month: " + cal.get(Calendar.MONTH) ); 
System.out.println("Day: " + cal.get(Calendar.DATE) ); 
} 
H 
/* 
Output: 
Year: 1999 
Month: 8 
Day: 12 
A 
Remarks 


The values year, month and date are used to set the fields YEAR, MONTH and DATE in the calendar object. 


See Also 

Reference 
GregorianCalendar Class 
Concepts 

GregorianCalendar Members 
java.util Package 
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GregorianCalendar Constructor (Int32, Int32, Int32, Int32, 
Int32) 


Constructs a new GregorianCalendar object with a specified date using the default time zone and locale. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.GregorianCalendar( 
int year, 
int month, 
int date, 
int hour, 
int minute); 


Parameters 
year 

The specified year. 
month 

The specified month. 
date 

The specified day. 
hour 

The specified hour. 
minute 

The specified minute. 
Example 


// gcal-ctorS.jsl 
// GregorianCalendar.#ctor example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Construct a calendar: 
Calendar cal = new GregorianCalendar(1999,8,12,6,25); 

// Get and display information from the calendar: 
System.out.printlin("Year: " + cal.get(Calendar.YEAR) ); 
System.out.println("Month: " + cal.get(Calendar.MONTH) ); 
System.out.println("Day: " + cal.get(Calendar.DATE) ); 
System.out.println("Hour: " + cal.get(Calendar.HOUR) ); 
System.out.printin("Minute: " + cal.get(Calendar.MINUTE) ); 

} 
} 
/* 
Output: 
Year: 1999 
Month: 8 
Day: 12 


Hour: 6 


Minute: 25 
* 


Remarks 


The values year, month, date, hour and minute are used to set the fields YEAR, MONTH, DATE, HOUR and MINUTE in the 
calendar object. 


See Also 

Reference 
GregorianCalendar Class 
Concepts 

GregorianCalendar Members 
java.util Package 
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GregorianCalendar Constructor (Int32, Int32, Int32, Int32, 
Int32, Int32) 


Constructs a new GregorianCalendar object with a specified date using the default time zone and locale. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.GregorianCalendar( 
int year, 
int month, 
int date, 
int hour, 
int minute, 
int second); 


Parameters 
year 


The specified year. 
month 

The specified month. 
date 

The specified day. 
hour 

The specified hour. 
minute 

The specified minute. 
second 

The specified second. 
Example 


// gcal-ctor6.jsl 
// GregorianCalendar.#ctor example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Construct a calendar: 
Calendar cal = new GregorianCalendar(1999,8,12,6,25,22); 
// Get and display information from the calendar: 
System.out.printin("Year: " + cal.get(Calendar.YEAR) ); 
System.out.println("Month: " + cal.get(Calendar.MONTH) ); 
System.out.println("Day: " + cal.get(Calendar.DATE) ); 
System.out.println("Hour: " + cal.get(Calendar.HOUR) ); 
System.out.println("Minute: " + cal.get(Calendar.MINUTE) ); 
System.out.println("Second: " + cal.get(Calendar.SECOND) ); 
} 


/* 

Output: 
Year: 1999 
Month: 8 
Day: 12 
Hour: 6 
Minute: 25 
Second: 22 
“7 











Remarks 


The values year, month, date, hour, minute and second are used to set the fields YEAR, MONTH, DATE, HOUR, MINUTE and 
SECOND in the calendar object. 


See Also 

Reference 
GregorianCalendar Class 
Concepts 

GregorianCalendar Members 
java.util Package 
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GregorianCalendar Methods 


Public Methods 





Name 


Description 











computeFields 


computeTime 


equals 


get 


getFirstDayOfWeek 


getGreatestMinimum 


getGregorianChange 


hashCode 


getLeastMaximum 


getMaximum 


getMinimalDaysInFirstWeek 


add Overridden. Adds the specified amount of time to a calendar field. 

after Overridden. Determines whether the date-time in an instance of a GregorianCalendar object is aft 
er the date-time in the calendar specified. 

before Overridden. Determines whether the date-time in an instance of a GregorianCalendar object is be 
fore the date-time in the calendar specified. 

clear Overloaded. Clears the fields of an instance of a Calendar object. (inherited from Calendar) 

complete Sets all the fields of an instance of a Calendar object. (inherited from Calendar) 


Overridden. Computes values for all the fields of an instance of a GregorianCalendar object. 


Overridden. Computes the time for a current instance of a GregorianCalendar object. 


Overridden. Determines whether two GregorianCalendar objects are equal. 


Gets the value of the specified field. (inherited from Calendar) 


Gets a value representing the first day of the week. (inherited from Calendar) 


Overridden. Gets a value representing the greatest possible minimum value for a given field. 


Retrieves the date of switching from Julian to Gregorian calendar. 


Overridden. Returns the hash code of a GregorianCalendar object. 


Overridden. Gets a value representing the smallest possible maximum value for a given field. 


Overridden. Gets a value representing the maximum value for a given field. 


Gets a value representing the minimal number of days for the first week of the calendar year. (inh 
erited from Calendar) 





getMinimum 


Overridden. Gets a value representing the minimum value for a given field. 





getTime 


Gets a Date representing the time of a Calendar object. (inherited from Calendar) 





getTimelnMillis 


getTimeZone 


getClass 


internalGet 


isLeapYear 








Gets the time of a Calendar object represented in milliseconds. (inherited from Calendar) 


Gets the TimeZone of a Calendar object. (inherited from Calendar) 


(inherited from Object) 


Gets the value of a given field. (inherited from Calendar) 


Checks if a specified year is a leap year. 








isLenient 


isSet 


MemberwiseClone 


roll 


set 


setFirstDayOfWeek 


setGregorianChange 


setLenient 


Determines whether a given Calendar is lenient. (inherited from Calendar) 


Determines whether a given field is set. (inherited from Calendar) 

(inherited from Calendar) 

Overridden. Modifies the value of a given field by one. 

Overloaded. Sets various fields of a Calendar object. (inherited from Calendar) 
Sets a value representing the first day of the week. (inherited from Calendar) 
Sets a specified date for the GregorianCalendar calendar change. 


Sets a value that determines whether a given Calendar is lenient. (inherited from Calendar) 





setMinimalDaysInFirstWeek 


setTime 


setTimelnMillis 


Sets a value representing the minimal number of days for the first week of the calendar year. (inh 
erited from Calendar) 


Sets the time of a Calendar object to the given Date. (inherited from Calendar) 


Sets the time of a Calendar object to a value represented in milliseconds. (inherited from 
Calendar) 





setTimeZone 


Sets the TimeZone of a Calendar object. (inherited from Calendar) 





toString 


Generates a human readable representation of a Calendar object. (inherited from Calendar) 








Protected Methods 
Name 


finalize 





See Also 

Reference 
GregorianCalendar Class 
Concepts 

java.util Package 


Description 


(inherited from Object) 








Visual J# Reference 


GregorianCalendar.add Method 


Adds the specified amount of time to a calendar field. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void add( 
int fld, 
int amount); 


Parameters 
fld 
The field to be modified. 
amount 
The amount of time to add to the above field. 
Example 


// gcal-add1.jsl 
// GregorianCalendar.add example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
sf 
// Construct a calendar: 
Calendar cal = new GregorianCalendar(); 
// Add 4 years to the current calendar: 
cal.add(1,4); 
System.out.printlin("Year: " + cal.get(Calendar.YEAR) ); 
} 
} 
/ * 
Output: 
Year: 2008 
*/ 
See Also 
Reference 
GregorianCalendar Class 
Concepts 


GregorianCalendar Members 
java.util Package 
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GregorianCalendar.after Method 


Determines whether the date-time in an instance of a GregorianCalendar object is after the date-time in the calendar specified. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean after( 
java.lang.Object cal); 


Parameters 
cal 

The calendar to compare to the current object. 
Return Value 


true if the current calendar contains a later date/time than cal; false otherwise. 
Example 


// gcal-after1.jsl 
// GregorianCalendar.after example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Construct the current calendar: 
Calendar call = new GregorianCalendar(); 
// Construct another calendar: 
Calendar cal2 = new GregorianCalendar(2004,7,10) ; 
// Check if call is after cal2: 
System.out.println(cal1l.after(cal2)); 
} 
} 
/ * 
Output: 
true 
* f 
See Also 
Reference 
GregorianCalendar Class 
Concepts 


GregorianCalendar Members 
java.util Package 
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GregorianCalendar.before Method 


Determines whether the date-time in an instance of a GregorianCalendar object is before the date-time in the calendar 
specified. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean before( 
java.lang.Object cal); 


Parameters 
cal 
The calendar to compare to the current object. 
Return Value 
true if the current calendar contains an earlier date-time than cal; false otherwise. 
Example 


// gcal-before1.jsl 
// GregorianCalendar.after example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Construct the current calendar: 
Calendar call = new GregorianCalendar(); 
// Construct another calendar: 
Calendar cal2 = new GregorianCalendar(2004,7,10); 
// Check if call is before cal2: 
System.out.println(cal1.before(cal2)); 
} 
i 
/ * 
Output 
false 
*/ 
See Also 
Reference 
GregorianCalendar Class 
Concepts 


GregorianCalendar Members 
java.util Package 


Visual J# Reference 


GregorianCalendar.computeFields Method 


Computes values for all the fields of an instance of a GregorianCalendar object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


protected void computeFields(); 


See Also 

Reference 
GregorianCalendar Class 
Concepts 

GregorianCalendar Members 
java.util Package 


Visual J# Reference 


GregorianCalendar.computeTime Method 


Computes the time for a current instance of a GregorianCalendar object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


protected void computeTime(); 


See Also 

Reference 
GregorianCalendar Class 
Concepts 

GregorianCalendar Members 
java.util Package 


Visual J# Reference 


GregorianCalendar.equals Method 


Determines whether two GregorianCalendar objects are equal. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean equals( 
java.lang.Object obj); 


Parameters 
obj 
The object to compare to. 
Return Value 
true if the two objects are equal; false otherwise. 
Example 


// gcal-equals1.jsl 
// GregorianCalendar.Equals example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create two calendar objects: 
Calendar cal2 = new GregorianCalendar(2004,8,10); 
Calendar call = new GregorianCalendar(2004,8,10); 
// Compare the two objects: 
System.out.println(cal1.Equals(cal2)); 
} 
} 
/ * 
Output 
true 
*/ 
See Also 
Reference 
GregorianCalendar Class 
Concepts 


GregorianCalendar Members 
java.util Package 


Visual J# Reference 


GregorianCalendar.getGreatestMinimum Method 


Gets a value representing the greatest possible minimum value for a given field. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public int getGreatestMinimum( 
int fld); 


Parameters 
fld 
The field whose greatest possible minimum value is to be retrieved. 
Return Value 
The greatest possible minimum value for fld. 
Example 


// gcal-Min1.jsl 
// GregorianCalendar.getLeastMinimum example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a calendar object: 
Calendar cal = new GregorianCalendar(2004,9,10); 
// Display the greatest min. for field #1: 
System.out.println("The minimum is: " + 
cal.getGreatestMinimum(1) ); 
} 
} 
/ * 
Output: 
The minimum is: 1 
*/ 
See Also 
Reference 
GregorianCalendar Class 
Concepts 


GregorianCalendar Members 
java.util Package 


Visual J# Reference 


GregorianCalendar.getGregorianChange Method 


Retrieves the date of switching from Julian to Gregorian calendar. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final java.util.Date getGregorianChange(); 


Return Value 
The Gregorian switching date for the current calendar. 


See Also 

Reference 
GregorianCalendar Class 
Concepts 

GregorianCalendar Members 
java.util Package 


Visual J# Reference 


GregorianCalendar.hashCode Method 


Returns the hash code of a GregorianCalendar object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized int hashCode(); 


Return Value 
The hash code of the GregorianCalendar object. 
Example 


// gcal-GetHCode.jsl 
// GregorianCalendar.GetHashCode example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a calendar object: 
Calendar cal = new GregorianCalendar(); 
// Display the hash code: 
System.out.println(cal.GetHashCode()); 
} 
} 
/ * 
Output: 
12 
mf 
See Also 
Reference 
GregorianCalendar Class 
Concepts 


GregorianCalendar Members 
java.util Package 


Visual J# Reference 


GregorianCalendar.getLeastMaximum Method 


Gets a value representing the smallest possible maximum value for a given field. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public int getLeastMaximum( 
int fld); 


Parameters 
fld 
The field whose smallest possible maximum value is to be retrieved. 
Return Value 
The smallest possible maximum value for fld. 
Example 


// gcal-Max1.jsl 
// GregorianCalendar.getLeastMaximum example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create the two objects: 
Calendar cal = new GregorianCalendar(2004,9,10); 
// Display the least max. for field #1: 
System.out.println("The maximum is: " + 
cal.getLeastMaximum(1)); 
} 
} 
/ * 
Output: 
The maximum is: 5000000 
*/ 
See Also 
Reference 
GregorianCalendar Class 
Concepts 


GregorianCalendar Members 
java.util Package 


Visual J# Reference 


GregorianCalendar.getMaximum Method 


Gets a value representing the maximum value for a given field. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public int getMaximum( 
int fld); 


Parameters 
fld 
The field whose maximum value is to be retrieved. 
Return Value 
The maximum value for fld. 
Example 


// gcal-Max2.jsl 
// GregorianCalendar.getMaximum example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a calendar object: 
Calendar cal = new GregorianCalendar(2004,9,10); 
// Display the least max. for field #1: 
System.out.println("The maximum is: " + 
cal.getMaximum(1)); 
} 
} 
/ * 
Output: 
The maximum is: 5000000 
*/ 
See Also 
Reference 
GregorianCalendar Class 
Concepts 


GregorianCalendar Members 
java.util Package 


Visual J# Reference 


GregorianCalendar.getMinimum Method 


Gets a value representing the minimum value for a given field. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public int getMinimum( 
int fld); 


Parameters 
fld 
The field whose minimum value is to be retrieved. 
Return Value 
The minimum value for fld. 
Example 


// gcal-Min2.jsl 
// GregorianCalendar.getMinimum example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a calendar object: 
Calendar cal = new GregorianCalendar(2004,9,10); 
// Display the least max. for field #1: 
System.out.println("The minimum is: " + 
cal.getMinimum(1)); 
} 
} 
/ * 
Output: 
The minimum is: 1 
*/ 
See Also 
Reference 
GregorianCalendar Class 
Concepts 


GregorianCalendar Members 
java.util Package 


Visual J# Reference 


GregorianCalendar.isLeapYear Method 


Checks if a specified year is a leap year. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean isLeapYear( 
int year); 


Parameters 
year 
The year to be checked. 
Return Value 
true if year is a leap year; false otherwise. 
Example 


// gcal-isLYri1.jsl 
// GregorianCalendar.isLeapYear example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a calendar object: 
GregorianCalendar cal = new GregorianCalendar(); 
// Check if the year 2000 is a leap year: 
System.out.println(cal.isLeapYear (2000) ) ; 
} 
} 
/ * 
Output: 
true 
ar A 
See Also 
Reference 
GregorianCalendar Class 
Concepts 


GregorianCalendar Members 
java.util Package 
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GregorianCalendar.roll Method 


Modifies the value of a given field by one. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void roll( 
int fld, 
boolean up); 


Parameters 


fld 


The field whose value is to be modified. 
up 

Flag indicating whether the field is to be increased or decreased. true indicates the field is to be increased. 
Example 


// gcal-rolli.jsl 
// GregorianCalendar.roll example 


import java.util.*; 


public class MyClass 
{ 


public static void main(String[] args) 


// Create a calendar object: 
Calendar cal = new GregorianCalendar(); 


// Display the year: 
System.out.println("The current year: " + cal.get(Calendar.YEAR) ); 


// Roll by 1: 
cal.roll(1, true); 


// Display the new year: 
System.out.println("The new year: " + cal.get(Calendar.YEAR) ); 


} 


f® 

Output: 

The current year: 2004 
The new year: 2005 

*/ 


See Also 

Reference 
GregorianCalendar Class 
Concepts 

GregorianCalendar Members 
java.util Package 


Visual J# Reference 


GregorianCalendar.setGregorianChange Method 


Sets a specified date for the GregorianCalendar calendar change. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public void setGregorianChange( 
java.util.Date date); 





Parameters 
date 


The specified change date. 


Example 





See Also 

Reference 
GregorianCalendar Class 
Concepts 

GregorianCalendar Members 
java.util Package 
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HashMap Class 


Represents a unique collection of key-value pairs. The elements are sorted according to the hash value of the key, and each key 
can exist only once in the collection. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public class java.util.HashMap 
extends java.util.AbstractMap 
implements java.util.Map, java.lang.Cloneable, java.io.Serializable 


Example 


The following example demonstrates the containsKey, containsValue, entrySet, get, isEmpty, keySet, put, remove, size and 
values methods of the HashMap class. 


// hashmap_overview.jsl 
import java.util.*; 
public class Program 


public static void main(String[] args) 
{ 
// Create a HashMap with three key/value pairs. 
HashMap hm = new HashMap(); 
hm.put("One", "1"); 
hm.put("Two", "2a"); 
hm.put("Two", "2b"); 
hm.put("Three", "3"); 


// Iterate over the HashMap to see what we just put in. 
Set set = hm.entrySet(); 

Iterator setIter = set.iterator(); 

while (setIter.hasNext()) 


{ 
} 


// Print the size of the HashMap. Hint, it won't be 4! 
if (!hm.isEmpty()) 


System.out.println(setIter.next()); 


{ 
System.out.println("The HashMap contians " + 
hm.size() + " entries."); 
} 
else 
{ 
System.out.println("The HashMap is empty!"); 
} 


// Print out the keys and the values. 
Set keys = hm.keySet(); 

Iterator keysIter = keys.iterator(); 
while (keysIter.hasNext()) 


System.out.println( "key: + keysIter.next()); 


} 


Collection values = hm.values(); 
Iterator valuesIter = values.iterator(); 
while (valuesIter.hasNext()) 


{ 


System.out.printlin("value: " + valuesIter.next()); 


} 


// Look for a value corresponding to a key. 
if (hm.containsKey("Two") ) 


Object v = hm.get("Two"); 
System.out.println("The value corresponding to the " + 
"key \"Two\" is " + v.toString()); 


} 


// Look for the value "2a". 
if (!hm.containsValue("2a")) 


{ 


System.out.println("The value \"2a\" does not exist " + 
"because it was replaced by the value \"2b\"."); 


} 


// Remove an entry from the HashMap. 
if (hm.containsKey("Three") ) 
{ 
Object v = hm.remove("Three") ; 
System.out.printin("The value " + v.toString() + 
"was removed from the HashMap."); 


} 


/* 

Output: 

[One, 1] 

[Two, 2b] 

[Three, 3] 

The HashMap contians 3 entries. 

key: One 

key: Two 

key: Three 

value: 1 

value: 2b 

value: 3 

The value corresponding to the key "Two" is 2b 
The value "2a" does not exist because it was replaced by the value "2b". 
The value 3 was removed from the HashMap. 


*/ 
Inheritance Hierarchy 
java.lang.Object 
java.util AbstractMap 


java.util.HashMap 


See Also 

Concepts 

HashMap Members 
java.util Package 
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HashMap Members 


Represents a unique collection of key-value pairs. The elements are sorted according to the hash value of the key, and each key 
can exist only once in the collection. 


The following tables list the members exposed by the HashMap type. 


Public Constructors 





HashMap Overloaded. Constructs a new instance of a HashMap object. 


Public Methods 





Name 


Description 





clear 


containsKey 


containsValue 


entrySet 


equals 


get 


hashCode 


getClass 


isEmpty 


keySet 


MemberwiseClone 


Overridden. Clears the contents of a HashMap object. 

Overridden. Determines whether a key exists in a HashMap object. 

Overridden. Determines whether a value exists in a HashMap object. 

Overridden. Creates and populates a Set object with the elements in the HashMap object. 
(inherited from AbstractMap ) 

Overridden. Retrieves the value associated with the given key. 

(inherited from AbstractMap ) 

(inherited from Object ) 

Overridden. Determines whether the HashMap object contains any elements. 
Overridden. Creates and populates a Set object with all the keys in the HashMap object. 


Creates a shallow copy of a HashMap object. 








put Overridden. Inserts a new key-value pair into the HashMap object. 

putAll Overridden. Inserts all the key-value pairs in the Map object into the HashMap object. 

remove Overridden. Removes the key-value pair associated with the given key from the HashMap object. 
size Overridden. Determines the number of key-value pairs in the HashMap object. 

toString (inherited from AbstractMap ) 

values Overridden. Creates and populates a Set object with all the values in the HashMap object. 





Name 


finalize 





Protected Methods 


Description 


(inherited from Object ) 








See Also 
Reference 
HashMap Class 
Concepts 
java.util Package 
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HashMap Constructor 


Constructs a new instance of a HashMap object. 


Overload List 
Name 


HashMap () 


HashMap (int) 


HashMap (Map) 


HashMap (int, float) 








Description 


Constructs a new instance of a HashMap object. 
Constructs a new instance of a HashMap object with the specified size. 
Constructs a new instance of a HashMap object, and initializes it with a Map object. 


Constructs a HashMap object with the initial size and load factor specified. 





See Also 
Reference 
HashMap Class 
Concepts 

HashMap Members 
java.util Package 





Visual J# Reference 


HashMap Constructor () 


Constructs a new instance of a HashMap object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.util.HashMap(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
HashMap Class 
Concepts 

HashMap Members 
java.util Package 


Visual J# Reference 


HashMap Constructor (Int32) 


Constructs a new instance of a HashMap object with the specified size. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.HashMap( 
int initCap); 


Parameters 
initCap 


The initial size of the HashMap object. 


See Also 

Reference 
HashMap Class 
Concepts 

HashMap Members 
java.util Package 


Visual J# Reference 


HashMap Constructor (Map) 


Constructs a new instance of a HashMap object, and initializes it with a Map object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.HashMap( 
java.util.Map m); 


Parameters 
m 


The Map object used to initialize the HashMap object. 


See Also 

Reference 
HashMap Class 
Concepts 

HashMap Members 
java.util Package 


Visual J# Reference 


HashMap Constructor (Int32, Single) 


Constructs a HashMap object with the initial size and load factor specified. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.HashMap( 
int initCap, 
float loadFactor) ; 


Parameters 
initCap 


The initial size of the HashMap object. 
loadFactor 

A value used to determine when the HashMap object should be rehashed. This value must be between 0.0 and 1.0. 
Remarks 


Specify the value of the loadFactor when you want to control when the HashMap object should be rehashed. A value of 0.7 
would cause the HashMap object to be rehashed when it became 70% full. 


See Also 
Reference 


HashMap Class 
Concepts 

HashMap Members 
java.util Package 
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HashMap Methods 


Public Methods 





Name 


Description 





clear 


Overridden. Clears the contents of a HashMap object. 





containsKey 


Overridden. Determines whether a key exists in a HashMap object. 





containsValue 


Overridden. Determines whether a value exists in a HashMap object. 








MemberwiseClone 


put 


putAll 


remove 


size 


toString 


values 





entrySet Overridden. Creates and populates a Set object with the elements in the HashMap object. 
equals (inherited from AbstractMap ) 

get Overridden. Retrieves the value associated with the given key. 

hashCode (inherited from AbstractMap ) 

getClass (inherited from Object ) 

isEmpty Overridden. Determines whether the HashMap object contains any elements. 

keySet Overridden. Creates and populates a Set object with all the keys in the HashMap object. 


Creates a shallow copy of a HashMap object. 


Overridden. Inserts a new key-value pair into the HashMap object. 


Overridden. Inserts all the key-value pairs in the Map object into the HashMap object. 


Overridden. Removes the key-value pair associated with the given key from the HashMap object. 


Overridden. Determines the number of key-value pairs in the HashMap object. 


(inherited from AbstractMap ) 


Overridden. Creates and populates a Set object with all the values in the HashMap object. 


Protected Methods 





Name 


Description 





finalize 





(inherited from Object ) 








See Also 
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HashMap.clear Method 


Clears the contents of a HashMap object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void clear(); 


Example 

The following example shows how to clear the contents of a HashMap object. 
// hashmap_clear.jsl 
import java.util.*; 
public class Program 


public static void main(String[] args) 


{ 
// Create a HashMap with three key/value pairs. 
HashMap hm = new HashMap(); 
hm.put("One", new Integer(1)); 
hm.put("Two", new Integer(2)); 
hm.put("Three", new Integer(3)); 
// Clear the key/value pairs from the HashMap. 
hm.clear(); 
System.out.println("hm contains " + hm.size() + 
" elements"); 
} 
} 
/* 
Output: 
hm contains @ elements 
ri 
See Also 
Reference 
HashMap Class 
Concepts 
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java.util Package 
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HashMap.clone Method 


Creates a shallow copy of a HashMap object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





Return Value 
The cloned HashMap object. 


See Also 

Reference 
HashMap Class 
Concepts 

HashMap Members 
java.util Package 
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HashMap.containsKey Method 


Determines whether a key exists in a HashMap object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean containsKey( 
java.lang.Object k); 


Parameters 


k 
The key to check the HashMap object for. 
Return Value 
Returns true if the HashMap object contains the specified key; false otherwise. 
Example 


The following example demonstrates how to determine if a given key is present in the HashMap. 


// hashmap_containskey.jsl 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
if 
// Create a HashMap with three key/value pairs. 
HashMap hm = new HashMap(); 
hm.put("One", new Integer(1)); 
hm.put("Two", new Integer(2)); 
hm.put("Three", new Integer(3)); 


// Does the key "Three" exist? 
boolean threeExists = hm.containsKey("Three"); 
if (threeExists) 


{ 
} 
else 


{ 
} 


System.out.println("The key \"Three\" exists!"); 


System.out.println("The key \"Three\" does NOT exist!"); 


// Does the key "Seven" exist? 
boolean sevenExists = hm.containsKey("Seven"); 
if (sevenExists) 


{ 
ie 
else 


{ 
} 


System.out.println("The key \"Seven\" exists!"); 


System.out.printlin("The key \"Seven\" does NOT exist!"); 


} 


/* 
Output: 
The key "Three" exists! 


The key "Seven" does NOT exist! 
a | 


See Also 

Reference 
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HashMap.containsValue Method 


Determines whether a value exists in a HashMap object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean containsValue( 
java.lang.Object v); 


Parameters 
V 


The value object to check for in the HashMapobject. 
Return Value 
Returns true if the HashMap object contains the specified value; false otherwise. 
Example 


The following example demonstrates how to determine if a given value is present in the HashMap. 


// hashmap_containsvalue.jsl 
import java.util.*; 


public class Program 


{ 


public static void main(String[] args) 


if 
// Create a HashMap with three key/value pairs. 


HashMap hm = new HashMap(); 
hm.put("One", new Integer(1)); 
hm.put("Two", new Integer(2)); 
hm.put("Three", new Integer(3)); 


// Does the value 3 exist? 
boolean threeExists = hm.containsValue(new Integer(3)); 
if (threeExists) 


{ 
} 


else 


{ 
} 


// Does the value 7 exist? 
boolean sevenExists = hm.containsValue(new Integer(7)); 
if (sevenExists) 


{ 
ie 
else 


{ 
} 


System.out.println("The value 3 exists!"); 


System.out.println("The value 3 does NOT exist!"); 


System.out.println("The value 7 exists!"); 


System.out.println("The value 7 does NOT exist!"); 


} 


/* 
Output: 
The value 3 exists! 


The value 7 does NOT exist! 
*/ 


See Also 

Reference 
HashMap Class 
Concepts 

HashMap Members 
java.util Package 


Visual J# Reference 


HashMap.entrySet Method 


Creates and populates a Set object with the elements in the HashMap object. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Set entrySet(); 


Return Value 


A Set object containing the elements of the HashMap object. 


Example 


The following example populates a Set with the contents of a HashMap. 


// hashmap_entryset.jsl 


import java.util.*; 


public class Program 


{ 


public static void main(String[] args) 


A 


} 


/* 
Output: 


// 


Create a HashMap with seven entries. 


HashMap hm = new HashMap(); 


hm. 
hm. 
hm. 
hm. 


hm 
hm 


hm. 


// 


put("One", "1"); 
put("Two", "2"); 
put("Three", "3"); 
put("Four", "4"); 
.put( "Five", "5"); 
-put( "Six", "6"); 
put("Seven", "7"); 


Create a Set with the entries in the HashMap. 


Set set = hm.entrySet(); 


// 


Iterate over the Set to see what it contains. 


Iterator iter = set.iterator(); 
while (iter.hasNext()) 


{ 


entrySet: 
entrySet: 
entrySet: 
entrySet: 
entrySet: 
entrySet: 
entrySet: 


*/ 


See Also 
Reference 
HashMap Clas 
Concepts 


S 


Object o = iter.next(); 
System.out.println("entrySet: 


[One, 1] 
[Two, 2] 
[Five, 5] 
[Four, 4] 
[Seven, 7] 
[Six, 6] 
[Three, 3] 


+ o.toString()); 


HashMap Members 
java.util Package 
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HashMap.get Method 


Retrieves the value associated with the given key. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object get( 
java.lang.Object k); 


Parameters 


k 


The key whose value is to be retrieved. 


Return Value 


The value associated with the given key. 


Example 


The following example shows how to get the value associated with a key. 


// hashmap_get.jsl 


import java.util.*; 


public class Program 


public static void main(String[] args) 


// Create a HashMap with three key/value pairs. 
HashMap hm = new HashMap(); 

hm.put("One", new Integer(1)); 

hm.put("Two", new Integer(2)); 

hm.put("Three", new Integer(3)); 


// Get the value associated with the key "Three". 
Object v = hm.get("Three"); 
if (v != null) 


{ 
System.out.println("The value associated with \"Three\" is " 
v.toString()); 
} 
else 
{ 
System.out.println("There is no key named \"Three\" " + 
"in the HashMap."); 
} 


The value associated with "Three" is 3 


{ 
{ 
i; 
i 
/* 
Output: 
* 
See Also 
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HashMap.isEmpty Method 


Determines whether the HashMap object contains any elements. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean isEmpty(); 


Return Value 
Returns true if the HashMap contains any elements; false otherwise. 
Example 


The following example shows how to safely access a HashMap by first determining if it is empty. 
// hashmap_isempty.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a HashMap with three key/value pairs. 
HashMap hm = new HashMap(); 
hm.put("One", new Integer(1)); 
hm.put("Two", new Integer(2)); 
hm.put("Three", new Integer(3)); 
// Determine if the HashMap is empty. 
if (!hm.isEmpty()) 
{ 
// Do something useful with the HashMap here. 
} 
} 
} 
See Also 
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HashMap.keySet Method 


Creates and populates a Set object with all the keys in the HashMap object. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Set keySet(); 


Return Value 


A Set object containing the keys in the HashMap object. 


Example 


The following example populates a Set with the keys contained in a HashMap. 


// hashmap_keyset.jsl 


import java.util.*; 


public class Program 


{ 


public static void main(String[] args) 


A 


See Also 
Reference 


// Create a HashMap with seven entries. 
HashMap hm = new HashMap(); 
hm.put("One", "1"); 

hm.put("Two", "2"); 

hm.put("Three", "3"); 

hm.put("Four", "4"); 

hm.put("Five", "5"); 

hm.put("Six", "6"); 

hm.put("Seven", "7"); 


// Create a Set with the keys in the HashMap. 
Set set = hm.keySet(); 


// Iterate over the Set to see what it contains. 
Iterator iter = set.iterator(); 
while (iter.hasNext()) 
{ 
Object o = iter.next(); 
System.out.println("keySet: 


+ o.toString()); 


: One 

: Two 

: Five 
: Four 
: Seven 
: Six 

: Three 
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HashMap.put Method 


Inserts a new key-value pair into the HashMap object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object put( 
java.lang.Object k, 
java.lang.Object v); 


Parameters 


k 


The key to be inserted. 


The value to be inserted with the above key. 
Return Value 
The existing value associated with the given key, if it was already present in the HashMap object; null otherwise. 
Example 


The following example shows how to add key/value pairs to a HashMap. 
// hashmap_put.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
ii 
// Create a HashMap with three key/value pairs. 
HashMap hm = new HashMap(); 
hm.put("One", new Integer(1)); 
hm.put("Two", new Integer(2)); 
hm.put("Three", new Integer(3)); 
// Iterate over the HashMap to see what we just put in. 
Set set = hm.entrySet(); 
Iterator setIter = set.iterator(); 
while (setIter.hasNext()) 
{ 
System.out.println(setIter.next()); 
} 
} 
} 
f® 
Output: 
[One, 1] 
[Two, 2] 
[Three, 3] 
+] 
See Also 
Reference 
HashMap Class 
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HashMap.putAll Method 


Inserts all the key-value pairs in the Map object into the HashMap object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void putAl11l( 
java.util.Map m); 


Parameters 
m 


The Map object whose elements are to be inserted into the HashMap object. 
Example 


The following example populates a HashMap with the contents of another HashMap. 
// hashmap_putall.jsl 
import java.util.*; 
public class Program 


public static void main(String[] args) 


{ 
// Create a HashMap with three key/value pairs. 
HashMap hm1 = new HashMap(); 
hm1.put("One", new Integer(1)); 
hm1.put("Two", new Integer(2)); 
hm1.put("Three", new Integer(3)); 
HashMap hm2 = new HashMap(); 
hm2.putAl1(hm1) ; 
// Iterate over the HashMap to see what we just put in. 
Set set = hm2.entrySet(); 
Iterator setIter = set.iterator(); 
while (setIter.hasNext() ) 
{ 
System. out.println(setIter.next()); 
} 
} 
} 
/* 
Output: 
[One, 1] 
[Two, 2] 
[Three, 3] 
*/ 
See Also 
Reference 
HashMap Class 
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HashMap.remove Method 


Removes the key-value pair associated with the given key from the HashMap object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object remove( 
java.lang.Object k); 


Parameters 


k 
The key representing the key-value pair to be removed. 
Return Value 
The value associated with the given key, if the key already exists in the HashMap object; null otherwise. 
Example 


The following example shows how to remove key/value pairs from a HashMap. 


// hashmap_remove.jsl 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
if 
// Create a HashMap with three key/value pairs. 
HashMap hm = new HashMap(); 
hm.put("One", "1"); 
hm.put("Two", "2"); 
hm.put("Three", "3"); 


// Remove "One" and "Two" from the HashMap. 
Object o1 = hm.remove("One"); 
Object o2 = hm.remove("Two"); 


// Print out the values associated with "One" and "Two". 
if (01 != null) 
{ 


} 


if (02 != null) 
{ 


} 


System.out.println("removed 01: " + 01.toString()); 


System.out.println("removed 02: " + 02.toString()); 


System.out.println("The HashMap now contains + 
hm.size() + " entries."); 


} 


/* 

Output: 

removed o1: 1 

removed 02: 2 

The HashMap now contains 1 entries. 


*/ 


See Also 
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HashMap.size Method 


Determines the number of key-value pairs in the HashMap object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public int size(); 


Return Value 
The number of key-value pairs in the HashMap object. 
Example 


The following example shows how to determine the number of key/value pairs in a HashMap. 


// hashmap_size.jsl 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
if 
// Create a HashMap with two key/value pairs. Since the key 
// "One" is added twice, only the value "2" is actually 
// present in the HashMap. 
HashMap hm = new HashMap(); 
hm.put("One", "1"); 
hm.put("One", "2"); 
hm.put("Three", "3"); 


System.out.println("The HashMap contains + 


hm.size() + " entries."); 


// Remove "One" from the HashMap. 
Object o1 = hm.remove("One"); 


System.out.println("The HashMap now contains + 
hm.size() + " entries."); 


} 


/* 

Output: 

The HashMap contains 2 entries. 

The HashMap now contains 1 entries. 


ed 


See Also 
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HashMap.values Method 


Creates and populates a Set object with all the values in the HashMap object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Collection values(); 


Return Value 
A Set object containing the values in the HashMap object. 
Example 


The following example populates a Collection with the values contained in a HashMap. 
// hashmap_values.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
// Create a HashMap with seven entries. 
HashMap hm = new HashMap(); 
hm.put("One", "1"); 
hm.put("Two", "2"); 
hm.put("Three", "3"); 
hm.put("Four", "4"); 
hm.put("Five", "5"); 
hm.put("Six", "6"); 
hm.put("Seven", "7"); 
// Create a Collection with the values in the HashMap. 
Collection coll = hm.values(); 
// Iterate over the Collection to see what it contains. 
Iterator iter = coll.iterator(); 
while (iter.hasNext()) 
{ 
Object o = iter.next(); 
System.out.println("values: " + o.toString()); 
I 
} 
} 
/ * 
Output: 
values: 1 
values: 2 
values: 5 
values: 4 
values: 7 
values: 6 
values: 3 
*/ 
See Also 
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HashSet Class 


Represents a unique collection of elements that are sorted according to their hash value, and can each exist only once in the 
collection. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public class java.util.HashSet 
extends java.util.AbstractSet 
implements java.util.Set, java.lang.Cloneable, java.io.Serializable 


Example 

The following example demonstrates the add, contains, isEmpty, iterator, remove, and size methods of the HashSet class. 
// hashset_overview.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
// Populate a HashSet with three integers. 
HashSet hs = new HashSet(); 
hs.add(new Integer(1)); 
hs.add(new Integer(2)); 
hs.add(new Integer(2)); 
hs.add(new Integer(3)); 
// Determine the size of the HashSet. 
System.out.printin("The HashSet contains " + 
hs.size() + " elements."); 
// Iterate over the contents of the HashSet. 
Iterator iter = hs.iterator(); 
while (iter.hasNext()) 
{ 
System.out.println(iter.next().toString()); 
} 
// Determine if an element exists, and if it does, 
// remove it. 
if (!hs.isEmpty()) 
{ 
Integer toRemove = new Integer(2); 
if (hs.contains(toRemove) ) 
si 
if (hs.remove(toRemove) ) 
{ 
System.out.println("Successfully removed element " + 
toRemove.toString()); 
} 
} 
} 
} 
} 
/* 
Output: 


The HashSet contains 3 elements. 
1 


2 
3 


Successfully removed element 2 
*/ 





Inheritance Hierarchy 


java.lang.Object 
java.util. AbstractCollection 
java.util AbstractSet 
java.util.HashSet 


See Also 
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HashSet Members 


Represents a unique collection of elements that are sorted according to their hash value, and can each exist only once in the 


collection. 


The following tables list the members exposed by the HashSet type. 


Public Constructors 





HashSet Overloaded. Creates a new instance of a HashSet object. 


Public Methods 








MemberwiseClone 


Name Description 

add Overridden. Adds an element to a HashSet object. 

addAll (inherited from AbstractCollection ) 

clear Overridden. Clears the content of a HashSet object. 

contains Overridden. Checks if a HashSet object contains a specific element. 
containsAll (inherited from AbstractCollection ) 

equals (inherited from AbstractSet ) 

hashCode (inherited from AbstractSet ) 

getClass (inherited from Object ) 

isEmpty Overridden. Checks if the HashSet object is empty. 

iterator Overridden. Provides an iterator over the contents of the HashSet object. 


Creates a new instance of a HashSet object that is a shallow copy of an existing HashSet object. 





remove Overridden. Removes an element from a HashSet object. 
removeAll (inherited from AbstractCollection ) 

retainAll (inherited from AbstractCollection ) 

size Overridden. Returns the number of elements in the HashSet object. 
toArray Overloaded. (inherited from AbstractCollection ) 

toString (inherited from AbstractCollection ) 





Name 


finalize 





Protected Methods 


Description 


(inherited from Object ) 








See Also 
Reference 
HashSet Class 
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HashSet Constructor 


Creates a new instance of a HashSet object. 


Overload List 











Name Description 

HashSet () Constructs a HashSet object. 

HashSet (Collection) Constructs a HashSet object, and initializes it with a collection. 

HashSet (int) Constructs a HashSet object with the initial size specified. 

HashSet (int, float) Constructs a HashSet object with the initial size and load factor specified. 
See Also 

Reference 

HashSet Class 
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HashSet Constructor () 


Constructs a HashSet object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.util.HashSet(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 
Reference 
HashSet Class 
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HashSet Constructor (Collection) 


Constructs a HashSet object, and initializes it with a collection. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.HashSet( 
java.util.Collection c); 


Parameters 
Cc 


The collection used to initialize the object. 


See Also 
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Concepts 

HashSet Members 
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HashSet Constructor (Int32) 


Constructs a HashSet object with the initial size specified. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.HashSet( 
int initCap); 


Parameters 
initCap 


The initial size of HashSet. 


See Also 
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HashSet Constructor (Int32, Single) 


Constructs a HashSet object with the initial size and load factor specified. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.HashSet( 
int initCap, 
float loadFactor) ; 


Parameters 
initCap 


The initial size of HashSet. 
loadFactor 

A value used to determine when HashSet should be rehashed. This value must be between 0.0 and 1.0. 
Remarks 


Specify the value of loadFactor when you want to control when the HashSet object should be rehashed. A value of 0.7 would 
cause the HashSet object to be rehashed when it became 70% full. 


See Also 
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HashSet Methods 


Public Methods 





Name 


Description 

















MemberwiseClone 


remove 


removeAll 


retainAll 


size 


toArray 


toString 


add Overridden. Adds an element to a HashSet object. 

addAll (inherited from AbstractCollection ) 

clear Overridden. Clears the content of a HashSet object. 

contains Overridden. Checks if a HashSet object contains a specific element. 
containsAll (inherited from AbstractCollection ) 

equals (inherited from AbstractSet ) 

hashCode (inherited from AbstractSet ) 

getClass (inherited from Object ) 

isEmpty Overridden. Checks if the HashSet object is empty. 

iterator Overridden. Provides an iterator over the contents of the HashSet object. 


Creates a new instance of a HashSet object that is a shallow copy of an existing HashSet object. 
Overridden. Removes an element from a HashSet object. 

(inherited from AbstractCollection ) 

(inherited from AbstractCollection ) 

Overridden. Returns the number of elements in the HashSet object. 

Overloaded. (inherited from AbstractCollection ) 


(inherited from AbstractCollection ) 


Protected Methods 





Name 


Description 





finalize 





(inherited from Object ) 








See Also 
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HashSet.add Method 


Adds an element to a HashSet object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public boolean add( 
java.lang.Object e); 





Parameters 
e 


The object to be added to the HashSet object. 
Return Value 


Returns true if the element was successfully added; false otherwise. 








Example 
// HashSet-add1.jsl 
// HashSet example 
import java.util.*; 
public class MyClass 
i 
public static void main() 
{ 
HashSet hs = new HashSet(1); 
Integer x = new Integer(22); 
Double y = new Double(2.45); 
System.out.printin(hs.add(x) + ", " + hs.add(y)); 
System.out.println(hs) ; 
} 
} 
/* 
Output 
true, true 
[2.45,22] 
*/ 
See Also 
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HashSet.clear Method 


Clears the content of a HashSet object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public void clear(); 


Example OOOO 


// HashSet-clear.jsl 
// HashSet example 
import java.util.*; 


public class MyClass 
{ 
public static void main() 


{ 
HashSet hs = new HashSet(1); 


hs.add(new Integer(22)); 
hs.add(new Double(2.45)); 


System.out.println("Before:" + hs); 
hs.clear(); 
System.out.printin("After:" + hs); 


} 


/* 

Output: 

Before: [2.45,22] 
After: [] 

A 
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HashSet.clone Method 


Constructs a clone of a HashSet object by creating a shallow copy of it. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





Return Value 
The cloned HashSet object. 


Example TE 


// HashSet-clone.jsl 
// HashSet clone example 
import java.util.*; 


public class MyClass 


{ 
public static void main() 
{ 
HashSet hs = new HashSet(); 
hs.add(new Integer(22)); 
hs.add(new Double(2.45)); 
System.out.println("Original: " + hs); 
System.out.println("Clone: " + hs.clone()); 
} 
} 
/* 
Output: 


Original: [22,2.45] 
Clone: [22,2.45] 
*/ 








See Also 
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HashSet.contains Method 


Checks if a HashSet object contains a specific element. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean contains ( 
java.lang.Object e); 


Parameters 
e 
The object to search for in HashSet. 
Return Value 
Returns true if the HashSet object contains the element; false otherwise. 
Example 


// HashSet-contains.jsl 
// HashSet contains example 
import java.util.*; 


public class MyClass 


i 
public static void main() 
{ 
HashSet hs = new HashSet(); 
Integer x = new Integer(22); 
Double y = new Double(2.45); 
hs.add(x); 
hs.add(y); 
System.out.printin(hs.contains(x)); 
} 
} 
/ * 
Output 
true 
*/ 
See Also 
Reference 
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HashSet.isEmpty Method 


Checks if the HashSet object is empty. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean isEmpty(); 


Return Value 
Returns true if the HashSet object is empty; false otherwise. 
Example 


The following example shows how to determine if a HashSet is empty. 
// hashset_isempty.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Populate a HashSet with three integers. 
HashSet hs = new HashSet(); 
hs.add(new Integer(1)); 
hs.add(new Integer(2)); 
hs.add(new Integer(3)); 
if (!hs.isEmpty()) 
// Do something useful with the HashSet here. 
} 
} 
See Also 
Reference 
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HashSet.iterator Method 


Provides an iterator over the contents of the HashSet object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Iterator iterator(); 


Return Value 
An iterator that can be used to traverse the contents of the HashSet object. 
Example 


In the following example, an iterator is created for a HashSet object, and then used to extract the elements of the HashSet 
object. 


// HashSet-iterator1.jsl 
// An iterator method example 


import java.util.*; 


public class MyClass 
{ 


public static void main() 


{ 
HashSet hSet = new HashSet(); 


// Add some elements to the HashSet: 
hSet.add("This"); 

hSet.add(" is"); 

hSet.add(" a"); 

hSet.add(" test."); 


// Retrieve an iterator to the hashset: 
Iterator iter = hSet.iterator(); 


// Extract elements from iterator. 
// Note that the elements may not follow the order in which they 
// are added to HashSet. 
while(iter.hasNext()) 
{ 
System.out.print(iter.next()); 
iter.remove(); 


} 
/* 
Output: 
isThis a test. 


*/ 


Remarks 
The iterator might not return elements in the same order as they were added. 


See Also 
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HashSet.remove Method 


Removes an element from a HashSet object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean remove( 
java.lang.Object e); 


Parameters 
e 
The element to be removed from the HashSet object. 
Return Value 
Returns true if the element was successfully removed; false otherwise. 
Example 


The following example shows how to remove an element from a HashSet. 
// hashset_remove.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Populate a HashSet with three integers. 
HashSet hs = new HashSet(); 
hs.add(new Integer(1)); 
hs.add(new Integer(2)); 
hs.add(new Integer(3)); 
Integer toRemove = new Integer(2); 
if (hs.contains(toRemove) ) 
if (hs.remove(toRemove) ) 
{ 
System.out.println("Successfully removed element " + 
toRemove.toString()); 
} 
} 
} 
} 
/ * 
Output: 
Successfully removed element 2 
*/ 
See Also 
Reference 
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HashSet.size Method 


Returns the number of elements in the HashSet object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public int size(); 





Return Value 


The number of elements in the HashSet object. 


Example TE 


// HashSet-size.jsl 

// HashSet size example 
import java.util.*; 
public class MyClass 

{ 


public static void main() 


HashSet hs = new HashSet(); 
hs.add(new Integer(22)); 
hs.add(new Double(3.45)); 
System.out.println("The size is: 
} 

} 

/* 

Output: 

The size is: 2 


a 


+ hs.size()); 











See Also 
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Hashtable Class 


Provides an object for key entries mapped to their corresponding values. Both keys and values must be non-null objects. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public class java.util.Hashtable 
extends java.util.Dictionary 
implements java.lang.Cloneable, java.util.Map, java.io.Serializable 





Inheritance Hierarchy 
java.lang.Object 
java.util. Dictionary 
java.util.Hashtable 
java.util.Properties 


See Also 
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Hashtable Members 


Provides an object for key entries mapped to their corresponding values. Both keys and values must be non-null objects. 


The following tables list the members exposed by the Hashtable type. 


Public Constructors 





Name 


Description 





Hashtable 


Overloaded. 








Public Methods 





Name Description 
clear Clears a Hashtable object. 
contains Checks for a specific element in a Hashtable object. 





containsKey 


Checks for a specific key in a Hashtable object. 





containsValue 


Checks for a specific value in a Hashtable object. 





























elements Overridden. Returns an enumeration that contains the values in a Hashtable object. 
entrySet Retrieves the set of mappings contained in a Hashtable object. 

equals Overridden. Compares a specified object to an object in a Hashtable. 

get Overridden. Retrieves an element associated with a specified key in a Hashtable object. 
hashCode Overridden. Returns the hash code of a Hashtable object. 

getClass (inherited from Object ) 

isEmpty Overridden. Checks if a Hashtable object is empty. 

keys Overridden. Returns an enumeration of the keys in a Hashtable object. 

keySet Returns the key set in a Hashtable object. 





MemberwiseClone 


Performs a shallow copy of the object. 








toString 








put Overridden. Adds an element at a specific key entry to a Hashtable object. 
putAll Copies all the elements from a specified map to the current Hashtable object. 
rehash Rehashes the content of the Hashtable into a larger table. 

remove Overridden. Removes a key/element pair from a Hashtable object. 

size Overridden. Returns the size (number of buckets) of a Hashtable object. 


Overridden. Generates the string representation of a Hashtable object. 








values Returns the set of elements in a Hashtable object. 








Protected Methods 
Name 


finalize (inherited from Object ) 








See Also 
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Hashtable Constructor 


Overload List 





Name 


Description 





Hashtable () 


Constructs a new Hashtable object with default initial capacity (11) and load factor (0.75). 





Hashtable (int) 


Constructs a new Hashtable object with a specified initial capacity and default load factor. 





Hashtable (Map) 


Constructs a new Hashtable object with the same mappings as the specified Map object. 





Hashtable (int, float) 





Constructs a new Hashtable object with a specified initial capacity and load factor. 





See Also 
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Hashtable Constructor () 


Constructs a new Hashtable object with default initial capacity (11) and load factor (0.75). 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.util.Hashtable(); 


Example OC 


// Create a new hashtable object: 
Hashtable ht = new Hashtable(); 











Remarks 
The default constructor initializes any fields to their default values. 


See Also 
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Hashtable Constructor (Int32) 


Constructs a new Hashtable object with a specified initial capacity and default load factor. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.util.Hashtable( 
int initialCapacity); 





Parameters 
initialCapacity 


The specified initial capacity. 


Example 





// Create a new hashtable object with an initial capacity 20: 


Hashtable ht = new Hashtable(2@) ; 





Remarks 
Throws IllegalArgumentException if the initial capacity is negative. 


See Also 

Reference 
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Hashtable Constructor (Map) 


Constructs a new Hashtable object with the same mappings as the specified Map object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Hashtable( 
java.util.Map m); 


Parameters 
m 
The specified Map object. 
Example 
In this example, you create a HashMap object, which implements the Map interface, and then you create a Hashtable object 


using the HashMap object. Displaying the elements of both objects gives the same result. 


// HT-ctor3.jsl 
// Map.#ctor example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a HashMap object (implements Map): 
HashMap hm = new HashMap(); 
// Add some elements: 
hm.put("4","Eve Kennedy") ; 
hm.put("1","Isabella Abolrous"); 
hm.put("2","Nick Fredette") ; 
// Display the values in the hashmap object: 
System.out.println("The values in the hashmap are:\n" + 
hm.values()); 
// Create a new hashtable object using the HashMap object: 
Hashtable ht = new Hashtable(hm) ; 
// Display the values in the hashtable object: 
System.out.println("The values in the hashtable are:\n" + 
ht.values()); 
} 
} 
/* 
Output: 


The values in the hashmap are: 

[Isabella Abolrous, Nick Fredette, Eve Kennedy] 
The values in the hashtable are: 

[Isabella Abolrous, Nick Fredette, Eve Kennedy] 
*/ 


Remarks 
Throws IllegalArgumentException if the initial capacity is negative. 


See Also 
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Hashtable Constructor (Int32, Single) 


Constructs a new Hashtable object with a specified initial capacity and load factor. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.util.Hashtable( 
int initialCapacity, 
float loadFactor) ; 





Parameters 
initialCapacity 


The specified initial capacity. 
loadFactor 

The specified load factor. 
Example 


// Create a new hashtable object with initial capacity 20 
// and load factor 60.0: 


Hashtable ht = new Hashtable( 20, 6@F) ; 





Remarks 
Throws IllegalArgumentException if the initial capacity is negative. 


See Also 
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Hashtable Methods 


Public Methods 























Name Description 

clear Clears a Hashtable object. 

contains Checks for a specific element in a Hashtable object. 

containsKey Checks for a specific key in a Hashtable object. 

containsValue Checks for a specific value in a Hashtable object. 

elements Overridden. Returns an enumeration that contains the values in a Hashtable object. 
entrySet Retrieves the set of mappings contained in a Hashtable object. 

equals Overridden. Compares a specified object to an object in a Hashtable. 

get Overridden. Retrieves an element associated with a specified key in a Hashtable object. 
hashCode Overridden. Returns the hash code of a Hashtable object. 

getClass (inherited from Object ) 

isEmpty Overridden. Checks if a Hashtable object is empty. 

keys Overridden. Returns an enumeration of the keys in a Hashtable object. 
keySet Returns the key set in a Hashtable object. 

MemberwiseClone Performs a shallow copy of the object. 

put Overridden. Adds an element at a specific key entry to a Hashtable object. 
putAll Copies all the elements from a specified map to the current Hashtable object. 
rehash Rehashes the content of the Hashtable into a larger table. 

remove Overridden. Removes a key/element pair from a Hashtable object. 

size Overridden. Returns the size (number of buckets) of a Hashtable object. 
toString Overridden. Generates the string representation of a Hashtable object. 
values Returns the set of elements in a Hashtable object. 








Protected Methods 


Name Description 


finalize (inherited from Object ) 
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Hashtable.clear Method 


Clears a Hashtable object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized void clear(); 


Example 


In the following example, you create and initialize a Hashtable object and then you remove all the elements and display the 
values. The result is an empty set. 


// HT-clear1.jsl 
// Hashtable.clear example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a new hashtable object: 
Hashtable ht = new Hashtable(); 
// Add some elements: 
ht.put("4","Eve Kennedy") ; 
ht.put("1","Isabella Abolrous"); 
ht.put("2","Emma Esteban"); 
// Clear the elements: 
ht.clear(); 
// Display the values: 
System.out.println("The values are: " + ht.values()); 
} 
} 
/* 
Output: 
The values are: [] 
arf 
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Hashtable.clone Method 


Creates a shallow copy of a Hashtable object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





Return Value 


A shallow copy of the Hashtable object. 
Example 








// HT-clone1.jsl 
// Hashtable.clone example 
import java.util.*; 
public class MyClass 
public static void main(String[] args) 
{ 
// Create a new hashtable object: 
Hashtable ht1 = new Hashtable(); 
// Add some elements: 
ht1.put("4","Eve Kennedy"); 
ht1.put("1","Isabella Abolrous"); 
ht1.put("2","Nick Fredette"); 
// Clone the hashtable object and display the clone: 
System.out.printlin(ht1.clone()); 
} 
} 
f* 
Output: 
{1=Isabella Abolrous, 2=Nick Fredette, 4=Eve Kennedy} 
a7 f 
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Hashtable.contains Method 


Checks for a specific element in a Hashtable object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized boolean contains( 
java.lang.Object element); 


Parameters 
element 
The element to search for in the Hashtable object. 
Return Value 
true if the element exists; false otherwise. 
Example 


In this example, you create and initialize a Hashtable object and then you check for the value "Nick Fredette." The result is true. 


// HT-cont1.jsl 
// Hashtable.contains example 


import java.util.*; 


public class MyClass 


4 
public static void main(String[] args) 
{ 
// Create a new hashtable object: 
Hashtable ht = new Hashtable(); 
// Add some elements: 
ht.put("4","Eve Kennedy"); 
ht.put("1","Isabella Abolrous"); 
ht.put("2","Nick Fredette") ; 
// Check for a specific element: 
System.out.println(ht.contains("Nick Fredette")); 
} 
} 
/* 
true 
*/f 
Remarks 


This method is identical to the method containsValue. 
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Hashtable.containsKey Method 


Checks for a specific key in a Hashtable object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized boolean containsKey( 
java.lang.Object pkey); 


Parameters 


pkey 
The key to search for in the Hashtable object. 
Return Value 
true if the key exists; false otherwise. 
Example 
In this example, you create and initialize a Hashtable object and then you check for the key "3" The result is false because this 


key is not in the object. 


// HT-conkey1.jsl 
// Hashtable.containsKey example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Create a new hashtable object: 
Hashtable ht = new Hashtable(); 
// Add some elements: 
ht.put("4","Eve Kennedy"); 
ht.put("1","Isabella Abolrous"); 
ht.put("2","Nick Fredette"); 
// Check for a specific key: 
System.out.println(ht.containsKey("3")); 
} 
} 
/* 
false 
*/ 
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Hashtable.containsValue Method 


Checks for a specific value in a Hashtable object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean containsValue( 
java.lang.Object v); 


Parameters 
V 
The value to search for in the Hashtable object. 
Return Value 
true if the value exists; false otherwise. 
Example 
In the following example, you create and initialize a Hashtable object and then you check for the value "Eve Kennedy.” The 


result is true. 


// HT-conValue1.jsl 
// Hashtable.containsValue example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Create a new hashtable object: 
Hashtable ht = new Hashtable(); 
// Add some elements: 
ht.put("4","Eve Kennedy"); 
ht.put("1","Isabella Abolrous"); 
ht.put("2","Emma Esteban"); 
// Check for a specific value: 
System.out.printlin(ht.containsValue("Eve Kennedy") ); 
} 
} 
/* 
true 
*/ 
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Hashtable.elements Method 


Returns an enumeration that contains the values in a Hashtable object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized java.util.Enumeration elements(); 


Return Value 
The enumeration that contains the values in the Hashtable object. 
Example 


The following example demonstrates how to use an Enumeration to enumerate over the elements in a Hashtable object. 


// HT-Elements1.jsl 
// Hashtable.elements example 


import java.util.*; 


class MyClass 
{ 
public static void main(String[] args) 
{ 
// Create a new hashtable object: 
Hashtable ht = new Hashtable(); 


// Add some elements: 
ht.put("1","Eve Kennedy") ; 
ht.put("2","Nick Fredette"); 
ht.put("5","Angelina Abolrous"); 


// Create an enumeration from the hashtable: 
Enumeration htEnum = ht.elements(); 


// Enumerate over the values: 
while (htEnum.hasMoreElements()) 
{ 


} 


System.out.println(htEnum.nextElement() ); 


} 


/* 

Output: 

Angelina Abolrous 
Nick Fredette 

Eve Kennedy 


mh 


Remarks 
Use the Enumeration class methods to get the values of the elements. 
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Hashtable.entrySet Method 


Retrieves the set of key/value pairs contained in a Hashtable object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Set entrySet(); 


Return Value 
The set of mappings in the Hashtable object. 
Example 


// HT-entrysm1.jsl 
// Hashtable.entrySet example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 
{ 
// Create a new hashtable object: 
Hashtable ht = new Hashtable(); 


// Add some elements: 
ht.put("1","Sally Abolrous"); 
ht.put("3","Craig Combel"); 
ht.put("5","Pille Mandla"); 


// Display the entry set of the object: 
System.out.println("The entry set is:\n" + ht.entrySet()); 


} 


fe 

Output: 

The entry set is: 

[[1, Sally Abolrous], [3, Craig Combel], [5, Pille Mandla]] 
*/ 


See Also 
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Hashtable.equals Method 


Compares a specified object to this Hashtable. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean equals( 
java.lang.Object c); 


Parameters 
Cc 


Return Value 

true if the object is a map and has the same key/value pairs, false otherwise. 

Example 

In the following example, you create and initialize a Hashtable object and then compare the element at the key "1" to the name 


"Isabella Abolrous". The result is true. 


// HT-Eq1.jsl 
// Hashtable.Equals example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Create a new hashtable object: 
Hashtable ht = new Hashtable(); 
// Add some elements: 
ht.put("4","Eve Kennedy"); 
ht.put("1","Isabella Abolrous"); 
ht.put("2","Nick Fredette"); 
Map map = new TreeMap(); 
map.put("4", "Eve Kennedy") ; 
map.put("1", "Isabella Abolrous"); 
map.put("2", "Nick Fredette") ; 
System.out.println(ht.equals(map) ) ; 
} 
} 
/* 
Output: 
true 
*/ 
See Also 
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Hashtable.get Method 


Retrieves an element associated with a specified key in a Hashtable object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized java.lang.Object get( 
java.lang.Object key); 


Parameters 
key 
The key of the element. 
Return Value 
The element associated with key. 
Example 


// HT-get1.jsl 
// Hashtable.get example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a new hashtable object: 
Hashtable ht = new Hashtable(); 
// Add some elements: 
ht.put("4","Eve Kennedy") ; 
ht.put("1","Isabella Abolrous"); 
ht.put("2","Emma Esteban"); 
ht.put("6","Nick Fredette") ; 
// Get the elemnt associated with the key "6": 
System.out.printlin(ht.get("6")); 
} 
} 
/* 
Output: 
Nick Fredette 
=f 
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Hashtable.hashCode Method 


Returns the hash code of a Hashtable object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public int hashCode(); 


Return Value 
The hash code of the Hashtable object. 
Example 


// HT-Hcode1.jsl 
// Hashtable.GetHashCode example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a new hashtable object: 
Hashtable ht = new Hashtable(); 
// Add some elements: 
ht.put("4","Eve Kennedy"); 
ht.put("1","Isabella Abolrous"); 
ht.put("2","Nick Fredette") ; 
// Get the hash code of the hashtable object: 
System.out.println(ht.GetHashCode()); 
} 
} 
/* 
Output: 
477852222 
=) 
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Hashtable.isEmpty Method 


Checks if a Hashtable object is empty. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean isEmpty(); 


Return Value 

true if empty; false otherwise. 

Example 

In the following example, you create and initialize a Hashtable object and then you remove all the elements and check if the 


object is empty. The result is true. 


// HT-isempti1.jsl 
// Hashtable.isEmpty example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Create a new hashtable object: 
Hashtable ht = new Hashtable(); 
// Add some elements: 
ht.put("4","Eve Kennedy") ; 
ht.put("1","Isabella Abolrous"); 
ht.put("2","Emma Esteban"); 
// Clear the elements: 
ht.clear(); 
// Check if the object is empty: 
System.out.printin(ht.isEmpty()); 
} 
} 
/* 
Output: 
true 
ed 
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Hashtable.keys Method 


Returns an enumeration of the keys in a Hashtable object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized java.util.Enumeration keys(); 


Return Value 
An enumeration of the keys in the Hashtable object. 
Example 


// HT-keys1.jsl 
// Hashtable.keys example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a new hashtable object: 
Hashtable ht = new Hashtable(); 
// Add some elements: 
ht.put("4","Eve Kennedy"); 
ht.put("1","Isabella Abolrous"); 
ht.put("2","Nick Fredette") ; 
// Create an enumeration of the table keys: 
Enumeration htEnum = ht.keys(); 
// Enumerate over the key values: 
System.out.println("The table keys are:"); 
while (htEnum.hasMoreElements()) 
{ 
System.out.println(htEnum.nextElement() ); 
} 
} 
} 
/* 
Output: 
The table keys are: 
4 
2 
1 
*/ 
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Hashtable.keySet Method 


Returns the key set in a Hashtable object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Set keySet(); 


Return Value 
The key set in the Hashtable object. 
Example 


In the following example, you create and initialize a Hashtable object and then you display the set of keys in the object. 


// HT-keyset1.jsl 
// Hashtable.keySet example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Create a new hashtable object: 
Hashtable ht = new Hashtable(); 
// Add some elements: 
ht.put("4","Eve Kennedy"); 
ht.put("1","Isabella Abolrous"); 
ht.put("2","Emma Esteban"); 
// Display the key set: 
System.out.printin(ht.keySet()); 
} 
} 
/* 
Output 
[1, 2, 4] 
yf 
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Hashtable.put Method 


Adds an element at a specific key entry to a Hashtable object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized java.lang.Object put( 
java.lang.Object key, 
java.lang.Object element) ; 


Parameters 
key 
The key entry at which the element is added. 
element 
The element to be added. 
Return Value 
The element to be added to Hashtable. 
Example 
In the following example, you create and initialize a Hashtable object and then you display the values stored in the object. 


// HT-put1.jsl 
// Hashtable.put example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Create a new hashtable object: 
Hashtable ht = new Hashtable(); 
// Add some elements: 
System.out.printin("The current value at \"4\" is " + ht.put("4", "Eve Kennedy” 
))3 
// Add a key that is already present. 
System.out.println("The current value at \"4\" is " + ht.put("4", "Jack")); 
} 
} 
/* 
Output: 


The current value at “4” is null 
The current value at “4” is Eve Kennedy 


“A 
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Hashtable.putAll Method 


Copies all the elements from a specified map to the current Hashtable object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized void putA1l1( 
java.util.Map m); 


Parameters 
m 


The specified Map object. 
Example 


In this example, you create and initialize a TreeMap object, which implements the Map interface, and then you copy it to a 
Hashtable object. Displaying the element #2 in both objects gives the same result. 


// HT-putAll1.jsl 
// Hashtable.putAll example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 
{ 
// Create a TreeMap object (implements Map): 
TreeMap tm = new TreeMap(); 
// Create a new hashtable object: 
Hashtable ht = new Hashtable(); 


// Add some elements to tm: 
tm.put( "1", "Sally Abolrous"); 
tm.put("2","Craig Combel"); 


// Copy tm to ht: 
ht.putAl1l(tm) ; 


// Display the element #2 in both objects: 

System.out.println("The element #2 in tm is: 
+ tm.get("2")); 

System.out.println("The element #2 in ht is: 
+ ht.get("2")); 


} 


/* 

Output: 

The element #2 in tm is: Craig Combel 
The element #2 in ht is: Craig Combel 
ar 
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Hashtable.rehash Method 


Rehashes the content of the Hashtable into a larger table. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





protected void rehash(); 
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Hashtable.remove Method 


Removes a key/element pair from a Hashtable object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized java.lang.Object remove( 
java.lang.Object key); 


Parameters 


key 
The key associated with the element. 
Return Value 
The element associated with key. If the key is not present, it returns null. 
Example 


In this example, you create and initialize a Hashtable object and then you remove one element from the object. 


// HT-rem1.jsl 
// Hashtable.remove example 


import java.util.*; 


public class MyClass 
4 
public static void main(String[] args) 
{ 
// Create a new hashtable object: 
Hashtable ht = new Hashtable(); 


// Add some elements: 
ht.put("3","Sally Abolrous"); 
ht.put("2","Craig Combel"); 
ht.put("5","Pille Mandla"); 


// Remove an object: 
System.out.println("The following object has been removed:\n" + 
ht.remove("5")); 


} 


/* 

Output: 

The following object has been removed: 
Pille Mandla 

wa 
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Hashtable.size Method 


Returns the size of a Hashtable object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public int size(); 


Return Value 
The size of the Hashtable object. 
Example 


In this example, you create and initialize a Hashtable object and then you display the size of the table. 


// HT-size1.jsl 
// Hashtable.size example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Create a new hashtable object: 
Hashtable ht = new Hashtable(); 
// Add some elements: 
ht.put("4","Eve Kennedy"); 
ht.put("1","Isabella Abolrous"); 
ht.put("2","Nick Fredette"); 
// Display the table size: 
System.out.println("The size of the table is: " + ht.size()); 
} 
} 
/* 
Output: 
The size of the table is: 3 
tf, 
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Hashtable.toString Method 


Generates the string representation of a Hashtable object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized java.lang.String toString(); 


Return Value 
The string representation of the Hashtable object. 
Example 


// HT-toStr1.jsl 
// Hashtable.toString example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 
{ 
// Create a new hashtable object: 
Hashtable ht = new Hashtable(); 


// Add some elements: 
ht.put("4","Eve Kennedy"); 
ht.put("1","Isabella Abolrous"); 
ht.put("2","Nick Fredette"); 


// Display the table as a string: 
System.out.printin(ht.toString()); 


} 


f* 

Output: 

{1=Isabella Abolrous, 2=Nick Fredette, 4=Eve Kennedy} 
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Hashtable.values Method 


Returns the set of elements in a Hashtable object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Collection values(); 


Return Value 
The set of elements in the Hashtable object. 
Example 


// HT-val1.jsl 
// Hashtable.values example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a new hashtable object: 
Hashtable ht = new Hashtable(); 


// Add some elements: 
ht.put("4","Eve Kennedy"); 
ht.put("1","Isabella Abolrous"); 
ht.put("2","Nick Fredette"); 


// Display the table vlaues: 
System.out.println("The values are:\n" + ht.values()); 


} 


/* 

Output: 

The values are: 

[Isabella Abolrous, Nick Fredette, Eve Kennedy] 
*/ 


Remarks 
If the table is empty, an empty set is returned. 
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Iterator Interface 


Provides an efficient mechanism to traverse the elements of various collections. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public interface java.util.Iterator 


Example 


In the following example, an iterator is used to iterate over HashSet and display its elements. 


// HashSet-iterator1.jsl 
// An iterator method example 


import java.util.*; 


public class MyClass 
{ 


public static void main() 


{ 
HashSet hSet = new HashSet(); 


// Add some elements to the HashSet: 
hSet.add("This"); 

hSet.add(" is"); 

hSet.add(" a"); 

hSet.add(" test."); 


// Retrieve an iterator to the hashset: 
Iterator iter = hSet.iterator(); 


// Extract elements from an iterator. 

// Note that the elements may not follow the order in which 
// they are added to HashSet. 

while(iter.hasNext()) 


{ 
System.out.print(iter.next()); 
iter.remove(); 


} 


/* 
Output: 
isThis a test. 


*/ 
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Iterator Members 


Provides an efficient mechanism to traverse the elements of various collections. 


The following tables list the members exposed by the Iterator type. 


Public Methods 





Name |Description 





hasNext|/Determines whether there are any more elements in the collection beyond where the iterator is currently positioned. 





next — |Advances the iterator one step in the collection, and retrieves the element at that position. 





remove |Removes the element from the collection that the iterator is currently pointing to. 
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Iterator Methods 


Public Methods 





Name |Description 





hasNext|/Determines whether there are any more elements in the collection beyond where the iterator is currently positioned. 





next — |Advances the iterator one step in the collection, and retrieves the element at that position. 





remove |Removes the element from the collection that the iterator is currently pointing to. 
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Iterator.hasNext Method 


Determines whether there are any more elements in the collection beyond where the iterator is currently positioned. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean hasNext(); 


Return Value 
Returns true if there are more elements in the collection beyond where the iterator is currently positioned; false otherwise. 
Example 


In the following example, an iterator is used to iterate over HashSet and displays its elements. 


// HashSet-iterator1.jsl 
// An iterator method example 


import java.util.*; 


public class MyClass 


{ 
public static void main() 
{ 
HashSet hSet = new HashSet(); 
// Add some elements to the HashSet: 
hSet.add("This"); 
hSet.add(" is"); 
hSet.add(" a"); 
hSet.add(" test."); 
// Retrieve an iterator to the hashset: 
Iterator iter = hSet.iterator(); 
// Extract elements from an iterator. 
// Note that the elements may not follow the order in which 
// they are added to HashSet. 
while(iter.hasNext()) 
{ 
System.out.print(iter.next()); 
iter.remove(); 
} 
} 
} 
/ * 
Output: 
isThis a test. 
a 
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Iterator.next Method 


Advances the iterator one step in the collection, and retrieves the element at that position. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.Object next(); 


Return Value 


The element in the collection one step beyond where the iterator was positioned before next was called. 


Example 


In the following example, an iterator is used to iterate over HashSet and displays its elements. 


// HashSet-iterator1.jsl 
// An iterator method example 


import java.util.*; 


public class MyClass 


{ 


public static void main() 


{ 


} 
/* 


HashSet hSet = new HashSet(); 


// Add some elements to the HashSet: 
hSet.add("This"); 

hSet.add(" is"); 

hSet.add(" a"); 

hSet.add(" test."); 


// Retrieve an iterator to the hashset: 
Iterator iter = hSet.iterator(); 


// Extract elements from an iterator. 
// Note that the elements may not follow the order in which 
// they are added to HashSet. 
while(iter.hasNext()) 
{ 
System.out.print(iter.next()); 
iter.remove(); 


Output: 
isThis a test. 


*/ 


See Also 
Reference 


Iterator Interface 


Concepts 


Iterator Members 
java.util Package 
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Iterator.remove Method 


Removes the element from the collection that the iterator is currently pointing to. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract void remove(); 


Example 


In the following example, an iterator is used to iterate over HashSet and displays its elements. 


// HashSet-iterator1.jsl 
// An iterator method example 


import java.util.*; 


public class MyClass 


{ 
public static void main() 
{ 
HashSet hSet = new HashSet(); 
// Add some elements to the HashSet: 
hSet.add("This"); 
hSet.add(" is"); 
hSet.add(" a"); 
hSet.add(" test."); 
// Retrieve an iterator to the hashset: 
Iterator iter = hSet.iterator(); 
// Extract elements from an iterator. 
// Note that the elements may not follow the order in which 
// they are added to HashSet. 
while(iter.hasNext()) 
{ 
System.out.print(iter.next()); 
iter.remove(); 
} 
} 
} 
/ * 
Output: 
isThis a test. 
ef 
See Also 
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LinkedList Class 


A class that represents a dynamic collection of elements. Each element consists of a data field and a link field. The link field 
points to the data field of the next element. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public class java.util.LinkedList 


extends java.util.AbstractSequentialList 
implements java.util.List, java.lang.Cloneable, java.io.Serializable 








Inheritance Hierarchy 
java.lang.Object 
java.util AbstractCollection 
java.util. AbstractList 
java.util AbstractSequentialList 
java.util.LinkedList 


See Also 
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LinkedList Members 


A class that represents a dynamic collection of elements. Each element consists of a data field and a link field. The link field 
points to the data field of the next element. 


The following tables list the members exposed by the LinkedList type. 


Public Constructors 





LinkedList Overloaded. 


Public Fields 



























































Name Description 

modCount (inherited from AbstractList ) 

Public Methods 

Name Description 

add Overloaded. Overridden. 

addAll Overloaded. Overridden. 

addFirst Inserts an object as the first element into a LinkedList object. 

addLast Inserts an element as the last element into a LinkedList object. 

clear Overridden. Removes all the elements from a LinkedList object. 

contains Overridden. Checks if a LinkedList object contains a specific element. 
containsAll (inherited from AbstractCollection ) 

equals (inherited from AbstractList ) 

get Overridden. Retrieves the element at the specified index in a LinkedList object. 
getFirst Retrieves the first element in a LinkedList object. 

hashCode (inherited from AbstractList ) 

getLast Retrieves the last element in a LinkedList object. 

getClass (inherited from Object ) 

indexOf Overridden. Retrieves the index of a specified element in a LinkedList object. 
isEmpty (inherited from AbstractCollection ) 

iterator (inherited from AbstractSequentialList ) 

lastindexOf Overridden. Retrieves the last index at which the element was last stored in a LinkedList object. 











listlterator 


Overloaded. 





MemberwiseClone 


remove 


removeAll 


removeFirst 


Performs a shallow copy of the object. 


Overloaded. Overridden. 


(inherited from AbstractCollection ) 


Removes the first element from a LinkedList object. 




















removeLast Removes the last element from a LinkedList object. 

removeRange (inherited from AbstractList ) 

retainAll (inherited from AbstractCollection ) 

set Overridden. Sets a specific element at a specific index into a LinkedList object. 
size Overridden. Retrieves the number of elements in a LinkedList object. 

subList (inherited from AbstractList ) 

toArray Overloaded. Overridden. 

toString (inherited from AbstractCollection ) 





Name 


finalize 





See Also 
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LinkedList Class 
Concepts 
java.util Package 


Protected Methods 


Description 


(inherited from Object ) 
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LinkedList Fields 


Public Fields 





Name Description 





modCount (inherited from AbstractList ) 














See Also 
Reference 
LinkedList Class 
Concepts 
java.util Package 
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LinkedList Constructor 


Overload List 





Name Description 





LinkedList () Constructs a LinkedList object. 





LinkedList (Collection) Constructs a LinkedList object and initializes it with a collection. 











See Also 
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LinkedList Constructor () 


Constructs a LinkedList object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.util.LinkedList(); 


Example ——________________céct___§_~" 


// Create a LinkedList object: 
LinkedList lList = new LinkedList(); 











Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
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LinkedList Constructor (Collection) 


Constructs a LinkedList object and initializes it with a collection. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.LinkedList( 
java.util.Collection c); 


Parameters 
Cc 


The collection to initialize the LinkedList object. 
Example 


In this example, you create an ArrayList object and initialize it by adding two elements to it. And then, you create a LinkedList 
object and initialize it using the ArrayList object. When you display the two objects, you get two identical collections. 


// LList-ctor2.jsl 
// LinkedList.#ctor example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 
{ 
// Create an ArrayList object: 
ArrayList aList = new ArrayList(); 


// Add some elements to aList: 
aList.add("Craig"); 
aList.add("Sally"); 


// Create a LinkedList object and itialize it 
// from the aList collection: 
LinkedList lList = new LinkedList(aList) ; 


// Display both collections: 
System.out.println(aList) ; 
System.out.println(lList) ; 


} 


/* 

Output: 
[Craig, Sally] 
[Craig, Sally] 
*/ 


See Also 

Reference 
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LinkedList Methods 


Public Methods 



































Name Description 

add Overloaded. Overridden. 

addaAll Overloaded. Overridden. 

addFirst Inserts an object as the first element into a LinkedList object. 

addLast Inserts an element as the last element into a LinkedList object. 

clear Overridden. Removes all the elements from a LinkedList object. 

contains Overridden. Checks if a LinkedList object contains a specific element. 
containsAll (inherited from AbstractCollection ) 

equals (inherited from AbstractList ) 

get Overridden. Retrieves the element at the specified index in a LinkedList object. 
getFirst Retrieves the first element in a LinkedList object. 

hashCode (inherited from AbstractList ) 

getLast Retrieves the last element in a LinkedList object. 

getClass (inherited from Object ) 

indexOf Overridden. Retrieves the index of a specified element in a LinkedList object. 
isEmpty (inherited from AbstractCollection ) 

iterator (inherited from AbstractSequentialList ) 

lastindexOf Overridden. Retrieves the last index at which the element was last stored in a LinkedList object. 
listlterator Overloaded. 

MemberwiseClone |Performs a shallow copy of the object. 

remove Overloaded. Overridden. 

removeAll (inherited from AbstractCollection ) 

removeFirst Removes the first element from a LinkedList object. 

removeLast Removes the last element from a LinkedList object. 

removeRange (inherited from AbstractList ) 











retainAll (inherited from AbstractCollection ) 

















set Overridden. Sets a specific element at a specific index into a LinkedList object. 
size Overridden. Retrieves the number of elements in a LinkedList object. 

subList (inherited from AbstractList ) 

toArray Overloaded. Overridden. 

toString (inherited from AbstractCollection ) 





Protected Methods 
Name 





finalize (inherited from Object ) 











See Also 
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LinkedList.add Method 


Overload List 





Name Description 





LinkedList.add (Object) Inserts an element into a LinkedList object. 





LinkedList.add (int, Object) Inserts an element into a LinkedList object at a specified index. 
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LinkedList.add Method (Object) 


Inserts an element into a LinkedList object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean add( 
java.lang.Object e); 


Parameters 
e 


The element to be added to LinkedList. 
Return Value 
true if the element was inserted successfully; false otherwise. 
Example 


// LList-add1.jsl 
// LinkedList.add example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 

{ 
// Create a linked list object: 
LinkedList lList = new LinkedList(); 


// Add some elements: 
lList.add("Isabella Abolrous"); 
lList.add("Angelina Abolrous"); 


// Get and display the elements: 

System.out.println("The elements of the collection are:"); 

for (int i=@; i<lList.size(); i++) 
System.out.printin(lList.get(i)); 


} 


/* 

Output: 

The elements of the collection are: 
Isabella Abolrous 

Angelina Abolrous 


*/ 


See Also 

Reference 
LinkedList Class 
Concepts 

LinkedList Members 
java.util Package 


Visual J# Reference 


LinkedList.add Method (Int32, Object) 


Inserts an element into a LinkedList object at a specified index. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void add( 
int ix, 
java.lang.Object e); 


Parameters 
x 


The index at which the element is inserted into LinkedList. 


The element to be inserted into LinkedList. 
Example 


// LList-add2.jsl 
// LinkedList.add example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
sf 
// Create a linked list object: 
LinkedList lList = new LinkedList(); 
// Add some elements: 
lList.add("Isabella"); 
lList.add("Angelina") ; 
// Insert more elements: 
lList.add(1, "Bianca"); 
lList.add(3,"Sally"); 
// Get and display the elements: 
System.out.println("The elements of the collection are: "); 
for (int i=@; i<lList.size(); i++) 
System.out.printlin(i + " = " + lList.get(i)); 
} 
z 
/* 
Output: 
The elements of the collection are: 
@ = Isabella 
1 = Bianca 
2 = Angelina 
3 = Sally 
=f 
Remarks 


Throws IndexOutOfBoundsException if ix is negative, or greater than or equal to size. 


See Also 
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LinkedList.addAll Method 


Overload List 





Name Description 





LinkedList.addAll (Collection) Inserts all the elements from a collection into a LinkedList object. 





LinkedList.addAll (int, Collection) |Inserts all the elements from a collection into a LinkedList object starting at a specified index. 











See Also 
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LinkedList.addAll Method (Collection) 


Inserts all the elements from a collection into a LinkedList object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean addA1l1l( 
java.util.Collection c); 


Parameters 
c 
The name of the collection. 
Return Value 
true if the elements were inserted successfully; false otherwise. 
Example 


// LList-addAl11.jsl1 
// LinkedList.addAll example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create ArrayList and LinkedList objects: 
ArrayList aList = new ArrayList(); 
LinkedList lList = new LinkedList(); 
// Initialize aList: 
aList.add("Craig"); 
aList.add("Sally"); 
// Add all the elements of aList to lList: 
lList.addAll(aList); 
// Display lList: 
System.out.println(lList) ; 
} 
} 
/* 
Output: 
[Craig, Sally] 
nf 
See Also 
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Concepts 


LinkedList Members 
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LinkedList.addAll Method (Int32, Collection) 


Inserts all the elements from a collection into a LinkedList object starting at a specified index. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean addA1l1l( 
int ix, 
java.util.Collection c); 


Parameters 
x 


The index at which the insertion starts. 


The name of the collection. 
Return Value 
true if the elements were inserted successfully; false otherwise. 
Example 


// LList-addAl12.jsl1 
// LinkedList.addAll example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Create an ArrayList and a LinkedList objects: 
ArrayList aList = new ArrayList(); 
LinkedList lList = new LinkedList(); 
// Initialize aList: 
aList.add("Craig"); 
aList.add("Sally"); 
// Initialize lList: 
lList.add("Pille") ; 
lList.add( "Hazem" ) ; 
// Add all the elements of aList to lList starting at index 1: 
lList.addAl1(1, aList); 
// Display lList: 
System.out.println(lList) ; 
} 
} 
/* 
Output: 
[Pille, Craig, Sally, Hazem] 
*/ 
Remarks 


Throws IndexOutOfBoundsException if ix is negative, or greater than or equal to size. 


See Also 
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LinkedList.addFirst Method 


Inserts an object as the first element into a LinkedList object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void addFirst( 
java.lang.Object e); 


Parameters 
e 


The object to be inserted. 
Example 


In this example, you create a linked list object, add two elements (first and last) to it, and then you print the elements. 


// LinkedList-addFirst.jsl 
// LinkedList.addFirst example 


import java.util.*; 


public class MyClass 
{ 


public static void main(String[] args) 


{ 
LinkedList 11 = new LinkedList(); 


Integer x = new Integer(123); 
Double y = new Double(4.56); 


// Build the list with the first and last elements: 
ll.addFirst(x); 
ll.addLast(y); 


// Print the list: 
System.out.println("The list elements are: " + 11); 


} 


/* 

Output: 

The list elements are: [123, 4.56] 
we 
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LinkedList.addLast Method 


Inserts an element as the last element into a LinkedList object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void addLast( 
java.lang.Object e); 


Parameters 
e 


The element to be inserted. 
Example 
See the example under addFirst. 


See Also 
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LinkedList.clear Method 


Removes all the elements from a LinkedList object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void clear(); 


Example 


In this example, you create a linked list object, add two elements to it, and then clear the list. You also print the elements and 
the size of the list before and after clearing the list. 


// LinkedList-clear.jsl 
// LinkedList.clear example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 
{ 
LinkedList 11 = new LinkedList(); 
Integer x = new Integer(123); 
Double y = new Double(4.56); 


// Build the list with the first and last elements: 
ll.addFirst(x); 
ll.addLast(y); 


// Print the list: 

System.out.println("The list elements are: + 
ll.getFirst() + ", " + ll.getLast()); 

// Print the size: 

System.out.println("The size of the list is: 
+ ll.size()); 


// Clear the list: 

ll.clear(); 

// Print the new size: 

System.out.println("The size after clearing the list is: 
+ ll.size()); 


I 


/* 

Output: 

The list elements are: 123, 4.56 

The size of the list is: 2 

The size after clearing the list is: @ 


*/ 


See Also 
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LinkedList.clone Method 


Creates a shallow copy of a LinkedList object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





Return Value 
The clone object. 
Example 


In this example, you create a linked list object, add two elements to it, clone it, and then you display the clone. 


// LinkedList-clone.jsl 
// LinkedList.Clone example 


import java.util.*; 


public class MyClass 
{ 


public static void main(String[] args) 


{ 
LinkedList 11 = new LinkedList(); 


Integer x = new Integer(123); 
Double y = new Double(4.56); 


// Build the list with the first and last elements: 
ll.addFirst(x); 
ll.addLast(y); 


// Clone the list: 
Object cl = 11.clone(); 


// Print the list clone: 
System.out.println("The clone is: " + cl); 


} 


/* 

Output: 

The clone is: [123, 4.56] 
a A 





See Also 
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LinkedList.contains Method 


Checks if a LinkedList object contains a specific element. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean contains ( 
java.lang.Object e); 


Parameters 
e 
The element searched for. 
Return Value 
true if the element was found, false otherwise. 
Example 
In this example, you initialize a linked list with two elements, and then you test the list to see if one of the elements exits in it. 


// LList-contains1.jsl 
// LinkedList.contains example 


import java.util.*; 


public class MyClass 


4 
public static void main(String[] args) 
{ 
// Create a linked list object: 
LinkedList 1lList = new LinkedList(); 
// Add some elements: 
lList.add("Isabella"); 
lList.add( "Angelina" ) ; 
// Check if the element "Angelina" exists in the list: 
if(1lList.contains("Angelina") ) 
System.out.println("The element exists in the list."); 
} 
} 
/* 
Output: 
The element exists in the list. 
7 | 
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LinkedList.get Method 


Retrieves the element at the specified index in a LinkedList object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.lang.Object get( 
int ix); 





Parameters 
i 

The index of the retrieved element. 
Return Value 


The element at the specified index in the LinkedList object. 


Example 





// LList-get1.jsl 
// LinkedList.get example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a linked list object: 


LinkedList lList = new LinkedList(); 


// Add some elements: 
lList.add("Isabella"); 
lList.add( "Angelina" ) ; 


// Display the element #1: 
System.out.println("The element #1 is: " + lList.get(1)); 


} 


/* 
Output: 
The element #1 is: Angelina 


ay 











Remarks 
Throws IndexOutOfBoundsException if ix is negative, or greater than or equal to size. 


See Also 
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LinkedList Members 
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LinkedList.getFirst Method 


Retrieves the first element in a LinkedList object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.lang.Object getFirst(); 





Return Value 


The object stored in the first element. 


Example TE 








// LList-getFirst1.jsl 
// LinkedList.getFirst example 
import java.util.*; 
public class MyClass 
public static void main(String[] args) 
{ 
// Create a linked list object: 
LinkedList lList = new LinkedList(); 
// Add some elements: 
lList.add("Isabella"); 
lList.add( "Angelina" ) ; 
// Display the first element: 
System.out.println("The first element is: " + 
lList.getFirst()); 
} 
} 
/* 
Output: 
The first element is: Isabella 
my 
Remarks 


Throws NoSuchElementException if the list is null. 


See Also 

Reference 
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LinkedList.getLast Method 


Retrieves the last element in a LinkedList object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.lang.Object getLast(); 





Return Value 


The object stored in the last element. 


Example TE 








// LList-getLast1.jsl 
// LinkedList.getLast example 
import java.util.*; 
public class MyClass 
public static void main(String[] args) 
{ 
// Create a linked list object: 
LinkedList lList = new LinkedList(); 
// Add some elements: 
lList.add("Isabella"); 
lList.add("Angelina") ; 
// Display the first element: 
System.out.printlin("The last element is: " + 
lList.getLast()); 
} 
} 
/* 
Output: 
The last element is: Angelina 
aL 
Remarks 


Throws NoSuchElementException if the list is null. 


See Also 
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LinkedList.indexOf Method 


Retrieves the index of a specified element in a LinkedList object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public int indexOf( 
java.lang.Object e); 


Parameters 
e 
The element for which the index is retrieved, 
Return Value 
The index of the specified element. 
Example 
See the example under lastindexOf. 
Remarks 
Returns -1 if the list does not contain the specified element. 


See Also 
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LinkedList.lastIndexOf Method 


Retrieves the last index at which the element was last stored in a LinkedList object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public int lastIndexOf( 
java.lang.Object e); 


Parameters 
e 


The element for which the index is retrieved. 
Return Value 
The index at which the specified element was last stored in a LinkedList object. 
Example 


// LList-LindexOf.js1l 
// LinkedList.lastIndexOf example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
LinkedList 11 = new LinkedList(); 


Integer x = new Integer(123); 
Double y = new Double(4.56); 


// Add elements: 
ll.addLast(y); 
ll.addFirst(x); 
ll.addLast(y); 


// Print the indexes of y: 

System.out.printin("The index of y is: " + 
ll.indexOf(y) ); 

System.out.println("The last index of y is: " + 
1ll.lastIndexOf(y) ); 


} 


EF 

Output: 

The index of y is: 1 

The last index of y is: 2 
si 


Remarks 
Returns -1 if the list does not contain the specified element. 


See Also 
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Linked_List.listlterator Method 


Overload List 





Name 


Description 





LinkedList.listlterator () 





LinkedList.listlterator (int) 








Retrieves an iterator over a LinkedList object starting at a specified position. 





See Also 
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Linked _List.listIterator Method (Int32) 


Retrieves an iterator over a LinkedList object starting at a specified position. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.ListIterator listIterator( 
int ix); 


Parameters 
ix 

The initial position of the iterator. 
Return Value 
An iterator of the LinkedList object. 
Example 


// LList-lIter1.jsl 
// LinkedList.listIteratort example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a linked list object: 
LinkedList lList = new LinkedList(); 
// Add some elements: 
lList.add( "Hazem" ) ; 
lList.add("Sally"); 
lList.add("Sam") ; 
lList.add("Camelia"); 
// Get a list iterator: 
ListIterator li = lList.listIterator(); 
// Extract elements from the list using the list iterator. 
// Note that the elements may not follow the order in which they 
// are added to list. 
while(li.hasNext()) 
{ 
System.out.println(li.next()); 
li.remove(); 
} 
} 
} 
/* 
Output: 
Hazem 
Sally 
Sam 
Camelia 
#7 
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LinkedList.remove Method 


Overload List 





Name Description 





LinkedList.remove (int) Removes an element at a specified index from a LinkedList. 





LinkedList.remove (Object) Removes a specific element from a LinkedList object. 











See Also 
Reference 
LinkedList Class 
Concepts 

LinkedList Members 
java.util Package 


Visual J# Reference 


LinkedList.remove Method (Int32) 


Removes an element at a specified index from a LinkedList. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object remove( 
int ix); 


Parameters 
ix 
The index at which the element is removed. 
Return Value 
The element to be removed from the LinkedList object. 


Example 


// LList-rem1.jsl 
// LinkedList.remove example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 

{ 
// Create a linked list object: 
LinkedList lList = new LinkedList(); 


// Add some elements: 
lList.add("Isabella"); 
lList.add( "Angelina" ) ; 
lList.add("Pille") ; 
lList.add("Anabella"); 


// Display the elements: 

System.out.println("The old list:"); 

for (int i=@; i<lList.size(); i++) 
System.out.printlin(i + " = " + lList.get(i)); 


// Remove the element #3: 
System. out.println( 
"\nThe following element has been removed: 
+ lList.remove(3)); 


// Display the new elements: 

System.out.printin("\nThe new list:"); 

for (int i=@; i<lList.size(); i++) 
System.out.printlin(i + " = " + lList.get(i)); 


} 


/* 

Output: 

The old list: 
@ = Isabella 
= Angelina 
Pille 
Anabella 


1 
2 
3 


The following element has been removed: Anabella 


The new list: 











@ = Isabella 
1 = Angelina 
2 = Pille 
* 

Remarks 


Throws IndexOutOfBoundsException if ix is negative, or greater than or equal to the size of the target list. 


See Also 

Reference 
LinkedList Class 
Concepts 

LinkedList Members 
java.util Package 


Visual J# Reference 


LinkedList.remove Method (Object) 


Removes a specific element from a LinkedList object. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean remove( 
java.lang.Object e); 


Parameters 


e 


The element to be removed. 


Return Value 


true if the element was removed successfully; false otherwise. 


Example 


// LList-rem2.jsl1 
// LinkedList.remove example 


import java.util.*; 


public class MyClass 


public static void main(String[] args) 


{ 

} 
} 
/* 
Output: 


// Create a new linked list object: 
LinkedList lList = new LinkedList(); 


// Add some elements: 
lList.add("Isabella"); 
lList.add( "Angelina" ) ; 
lList.add("Pille") ; 

lList.add("Anabella") ; 


// Display the elements: 
System.out.print("The old list: "+ lList); 


// Remove the element #3: 
lList.remove("Anabella"); 
System.out.println( 
"\nThe element \"Anabella\" has been removed."); 


// Display the new elements: 
System.out.print("The new list: " + lList); 


The old list: [Isabella, Angelina, Pille, Anabella] 
The element "Anabella" has been removed. 
The new list: [Isabella, Angelina, Pille] 


*/ 


See Also 
Reference 


LinkedList Class 


Concepts 


LinkedList Members 


java.util Package 


Visual J# Reference 


LinkedList.removeFirst Method 


Removes the first element from a LinkedList object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object removeFirst(); 


Return Value 
The element to be removed from the LinkedList object. 
Example 


// LList-rem3.jsl 
// LinkedList.remove example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 

{ 
// Create a linked list object: 
LinkedList 1lList = new LinkedList(); 


// Add some elements: 
lList.add("Isabella"); 
lList.add( "Angelina" ) ; 
lList.add("Pille") ; 
lList.add("Anabella"); 


// Display the elements: 

System.out.println("The old list:"); 

for (int i=@; i<lList.size(); i++) 
System.out.printlin(i + " = " + lList.get(i)); 


// Remove the first element: 
System.out.println( 
"\nThe following element has been removed: 
+ lList.removeFirst()); 


// Display the new elements: 

System.out.printin("\nThe new list:"); 

for (int i=@; i<lList.size(); i++) 
System.out.println(i + " = " + lList.get(i)); 


The old list: 
@ = Isabella 
1 = Angelina 
2 = Pille 

3 = Anabella 


The following element has been removed: Isabella 


The new list: 
@ = Angelina 
1 = Pille 

2 = Anabella 


| 


Remarks 
Throws NoSuchElementException if the list is null. 


See Also 

Reference 
LinkedList Class 
Concepts 

LinkedList Members 
java.util Package 


Visual J# Reference 


LinkedList.removeLast Method 


Removes the last element from a LinkedList object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object removeLast(); 


Return Value 
The element to be removed from the LinkedList object. 
Example 


// LList-rem4.jsl 
// LinkedList.remove example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 

{ 
// Create a linked list object: 
LinkedList 1lList = new LinkedList(); 


// Add some elements: 
lList.add("Isabella"); 
lList.add( "Angelina" ) ; 
lList.add("Pille") ; 
lList.add("Anabella"); 


// Display the elements: 

System.out.println("The old list:"); 

for (int i=@; i<lList.size(); i++) 
System.out.println(i + " = " + lList.get(i)); 


// Remove the last element: 
System.out.println( 
"\nThe following element has been removed: 
+ lList.removeLast()); 


// Display the new elements: 

System.out.println("\nThe new list:"); 

for (int i=@; i<lList.size(); i++) 
System.out.printlin(i + " = " + lList.get(i)); 


, 


/* 

Output: 

The old list: 
@ = Isabella 
1 = Angelina 
2 = Pille 

3 = Anabella 


The following element has been removed: Anabella 


The new list: 
@ = Isabella 
1 = Angelina 
2 = Pille 


ef 





Remarks 
Throws NoSuchElementException if the list is null. 


See Also 

Reference 
LinkedList Class 
Concepts 

LinkedList Members 
java.util Package 


Visual J# Reference 


LinkedList.set Method 


Sets a specific element at a specific index into a LinkedList object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object set( 
int ix, 
java.lang.Object e); 


Parameters 
x 


The index of the element to be set. 


The element to be set. 
Return Value 
The element to be set into the LinkedList object. 
Example 


// LList-set1.jsl 
// LinkedList.set example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Create a linked list object: 
LinkedList lList = new LinkedList(); 
// Add some elements: 
lList.add("Isabella"); 
lList.add( "Angelina" ) ; 
lList.add("Pille") ; 
lList.add( "Hazem" ) ; 
// Display the elements: 
System.out.println("The old list:"); 
for (int i=@; i<lList.size(); i++) 
System.out.printin(i + "=" + lList.get(i)); 
// Set the element #3: 
System.out.println("\nThe following element has been set: " 
+ lList.set(3,"Anabella")); 
// Display the elements after changing #3: 
System.out.println("\nThe new list:"); 
for (int i=@; i<lList.size(); i++) 
System.out.printin(i + "=" + lList.get(i)); 
} 
} 
Pha 
Output: 
The old list: 
@=Isabella 


1=Angelina 


2=Pille 
3=Hazem 


The following element has been set: Hazem 


The new list: 
Q@=Isabella 
1=Angelina 
2=Pille 
3=Anabella 

ay 











Remarks 
Throws IndexOutOfBoundsException if ix is negative, or greater than or equal to the size of the target list. 


See Also 

Reference 
LinkedList Class 
Concepts 

LinkedList Members 
java.util Package 


Visual J# Reference 


LinkedList.size Method 


Retrieves the number of elements in a LinkedList object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public int size(); 





Return Value 


The number of elements in the LinkedList object. 


Example 


// LList-size1.jsl 
// LinkedList.size example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a linked list object: 


LinkedList 1lList = new LinkedList(); 


// Add some elements: 
lList.add("Isabella"); 
lList.add( "Angelina" ) ; 
lList.add("Pille") ; 
lList.add( "Hazem" ) ; 


// Display the size of the list: 
System.out.println("The size of the list is: " + lList.size()); 


} 


/* 

Output: 

The size of the list is: 4 
Wf 











See Also 

Reference 
LinkedList Class 
Concepts 

LinkedList Members 
java.util Package 


Visual J# Reference 


LinkedList.toArray Method 


Overload List 





Name Description 





LinkedList.toArray () Copies values of a LinkedList object to an array. 





LinkedList.toArray (Object[]) Copies the elements of a LinkedList object into specified array object. 











See Also 
Reference 
LinkedList Class 
Concepts 

LinkedList Members 
java.util Package 


Visual J# Reference 


LinkedList.toArray Method () 


Copies values of a LinkedList object to an array. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object[] toArray(); 


Return Value 
The array object. 
Example 


// LList-toArr1.jsl 
// LinkedList.toArray example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a linked list object: 
LinkedList 1lList = new LinkedList(); 
// Add some elements: 
lList.add("Isabella"); 
lList.add( "Angelina" ) ; 
lList.add("Pille") ; 
lList.add( "Hazem" ) ; 
// Create an array from the list: 
Object[] s = lList.toArray(); 
// Display the array elements: 
System.out.println("The array elements are:"); 
for (int i=@; i<lList.size(); i++) 
System.out.printlin(i + " = " + s[i]); 
} 
} 
/* 
Output: 
The array elements are: 
@ = Isabella 
1 = Angelina 
2 = Pille 
3 = Hazem 
mf 
See Also 
Reference 
LinkedList Class 
Concepts 


LinkedList Members 
java.util Package 


Visual J# Reference 


LinkedList.toArray Method (Object ]) 


Copies the elements of a LinkedList object into specified array object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object[] toArray( 
java.lang.Object[] arr); 


Parameters 
arr 
The array object that receives the elements of the LinkedList object. 
Return Value 
The array object that contains the LinkedList elements. 
Example 
In this example, you create an initialize a LinkedList collection, convert it to an array object "s," and then you copy this object to 


a new array object "s1." 


// LList-toArr2.jsl 
// LinkedList.toArray example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Create a linked list object: 
LinkedList lList = new LinkedList(); 
// Add some elements: 
lList.add("Isabella"); 
lList.add( "Angelina" ) ; 
lList.add("Pille") ; 
lList.add( "Hazem" ) ; 
// Create an array "s" from the list: 
Object[] s = lList.toArray(); 
// Copy "s" to another object array "si": 
Object[] s1 = lList.toArray(s); 
// Display the array objects: 
System.out.println("The array objects are:"); 
for (int i=@; i<lList.size(); i++) 
System.out.printin(i + " = " + s1[i]); 
} 
} 
/* 
Output: 
The array objects are: 
@ = Isabella 
1 = Angelina 
2 = Pille 
3 = Hazem 


*/ 


Remarks 
Throws NullPointerException if the specified array is null. 


See Also 

Reference 
LinkedList Class 
Concepts 

LinkedList Members 
java.util Package 


Visual J# Reference 


List Interface 


An interface that represents an ordered collection of elements. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public interface java.util.List 
extends java.util.Collection 





Remarks 
This interface is implemented by collection classes such as ArrayList and LinkedList. 


See Also 
Concepts 

List Members 
java.util Package 


Visual J# Reference 


List Members (J#) 


An interface that represents an ordered collection of elements. 


The following tables list the members exposed by the List type. 


Public Methods 


























Name Description 

add Overloaded. 

addAll Overloaded. 

clear Removes all the elements from a List object. 

contains Checks if a List object contains a specific element. 

containsAll |Checks if a List object contains all the elements of a collection. 

equals Checks if a List object is equal to a specific object. 

get Retrieves an element from a List at a specified index. 

hashCode _ {Retrieves the hash code of a List.object. 

indexOf Retrieves the index of a specific element in a List.object. 

isEmpty Checks if a java.util.List object is empty. 

iterator Provides an iterator to iterate over a List object. 

lastindexOf Retrieves the last index a specific element has possessed when it was last added to List object. 
listlterator |Overloaded. 

remove Overloaded. 

removeAll _ |Deletes all the elements from a List object that exist is a specified collection. 

retainAll Deletes the elements of the current List collection that do not exist in specified collection object. 
set Changes the contents of an existing element at the specified index in a List object. 

size Retrieves the number of elements in a List object. 

subList Creates a sub list from the elements that exist within a specified index range in a List object. 
toArray Overloaded. 

See Also 

Reference 

List Interface 

Concepts 


java.util Package 
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List Methods (J#) 


Public Methods 


























Name Description 

add Overloaded. 

addAll Overloaded. 

clear Removes all the elements from a List object. 

contains Checks if a List object contains a specific element. 

containsAll |Checks if a List object contains all the elements of a collection. 

equals Checks if a List object is equal to a specific object. 

get Retrieves an element from a List at a specified index. 

hashCode _ {Retrieves the hash code of a List.object. 

indexOf Retrieves the index of a specific element in a List.object. 

isEmpty Checks if a java.util.List object is empty. 

iterator Provides an iterator to iterate over a List object. 

lastindexOf Retrieves the last index a specific element has possessed when it was last added to List object. 
listlterator |Overloaded. 

remove Overloaded. 

removeAll _ |Deletes all the elements from a List object that exist is a specified collection. 

retainAll Deletes the elements of the current List collection that do not exist in specified collection object. 
set Changes the contents of an existing element at the specified index in a List object. 

size Retrieves the number of elements in a List object. 

subList Creates a sub list from the elements that exist within a specified index range in a List object. 
toArray Overloaded. 

See Also 

Reference 

List Interface 

Concepts 


java.util Package 





Visual J# Reference 


List.add Method 


Overload List 





Name Description 





List.add (Object) Inserts a specific element into a List.object. 





List.add (int, Object) Inserts a specific element at a specific index into a List object. 














See Also 
Reference 

List Interface 
Concepts 

List Members 
java.util Package 


Visual J# Reference 


List.add Method (Object) 


Inserts the specified element into a List object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean add( 
java.lang.Object e); 


Parameters 
e 
The element to be inserted into the List object. 
Return Value 
true if the element is inserted successfully; false otherwise. 
Example 
In this example, you create a linked list object, which implements the List interface through one of its super classes. Then you 


add some elements to the list and display them. 


// list-add1.jsl 
// List.add example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Create a linked list object (which implements the 
// List interface): 
LinkedList lList = new LinkedList(); 
// Add some elements: 
lList.add("My Node"); 
lList.add( "Your Node"); 
lList.add(null); 
lList.add(new Integer(55)); 
// Get and display the elements: 
for (int i=@; i<lList.size(); i++) 
System.out.println(lList.get(i)); 
} 
} 
/ * 
Output: 
My Node 
Your Node 
null 
55 
*/ 
See Also 
Reference 
List Interface 
Concepts 


List Members 
java.util Package 


Visual J# Reference 


List.add Method (Int32, Object) 


Inserts the specified element at the specified index into a List object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract void add( 
int ix, 
java.lang.Object e); 


Parameters 
ix 


The index at which the element is added. 


The element to be added to the List object. 
Example 


// list-add2.jsl 
// List.add example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
sf 
// Create a linked list object (which implements the 
// List interface): 
LinkedList lList = new LinkedList(); 
// Add some elements: 
lList.add("John") ; 
lList.add("Sam") ; 
// Insert more elements: 
lList.add(@,"Fred"); 
lList.add(1, "Michelle"); 
lList.add(3,"Virginia"); 
// Get and display the elements: 
for (int i=@; i<lList.size(); i++) 
System.out.printin(i + "=" + lList.get(i)); 
} 
} 
/* 
@=My Node 
@=Fred 
1=Michelle 
2=John 
3=Virginia 
4=Sam 
* 
Remarks 


Throws IndexOutOfBoundsException if ix is negative or greater than or equal to size. 


See Also 


Reference 

List Interface 
Concepts 

List Members 
java.util Package 


Visual J# Reference 


List.addAll Method 


Overload List 





Name Description 





List.addAll (Collection) Inserts all the elements from a collection into a List object. 





List.addAll (int, Collection) {Inserts all the elements from a collection into a List object starting at a specified index. 











See Also 
Reference 

List Interface 
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List Members 
java.util Package 
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List.addAll Method (Collection) 


Inserts all the elements from a Collection into a List object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean addA11( 
java.util.Collection c); 


Parameters 
c 
The Collection whose elements are inserted into the List object. 
Return Value 
true if the elements were inserted successfully; false otherwise. 
Example 
In this example, you declare an ArrayList, al, object and a LinkedList object, Il. You then add some elements to al and copy it to 


Il. When you display II, you get the same elements as those of al. 


// list-addAll1.jsl 
// List.addAll example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Create an ArrayList object and a LinkedList object: 
ArrayList al = new ArrayList(); 
LinkedList 11 = new LinkedList(); 
// Add some elements to al: 
al.add("My Node"); 
al.add("Your Node"); 
al.add(nul11); 
al.add(new Integer(55)); 
// Copy al to 11 and display 11: 
if(11.addAl1l(al)==true) 
System.out.println(11); 
} 
} 
/ * 
Output: 
[My Node, Your Node, null, 55] 
*/ 
See Also 
Reference 
List Interface 
Concepts 


List Members 
java.util Package 


Visual J# Reference 


List.addAll Method (Int32, Collection) 


Inserts all the elements from a collection into a List object starting at a specified index. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean addA11( 
int ix, 
java.util.Collection c); 


Parameters 
x 


The starting index at which the elements are inserted. 


The name of the collection. 
Return Value 
true if the elements are inserted successfully; false otherwise. 
Example 


In this example, you declare an ArrayList, al, object and a LinkedList object, Il. You the add some elements to both al and II. Then 
you copy al to Il starting art index 2. When you display Il, you see that it includes both elements of al and Il. 


// list-addA1l12.js1 
// List.addAll example 


import java.util.*; 


public class MyClass 
{ 
public static void main(String[] args) 
{ 
// Create an ArrayList object and a LinkedList object: 
ArrayList al = new ArrayList(); 
LinkedList 11 = new LinkedList(); 


// Add some elements to al: 
al.add("My Node"); 
al.add("Your Node"); 
al.add(nul11); 

al.add(new Integer(55)); 


// Add some elements to 11: 
ll.add("01"); 
ll.add("@2"); 
1ll.add("@3"); 
ll.add("04"); 


// Copy al to 11 starting at index 2: 
1l.addAl1(2,al); 


// Display al and 11: 


System.out.printin("al = " + al); 
System.out.printin("1l = " + 11); 


Output: 


al 
11 
* 


[My Node, Your Node, null, 55] 
[@1, @2, My Node, Your Node, null, 55, 03, 04] 





Remarks 
Throws IndexOutOfBoundsException if ix is negative, or greater than or equal to size. 


See Also 
Reference 

List Interface 
Concepts 

List Members 
java.util Package 


Visual J# Reference 


List.clear Method 


Removes all the elements from a List object. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract void clear(); 


Example 


// list- 


// List 


clear.jsl 
example 


import java.util.*; 


public class MyClass 


{ 


public static void main(String[] args) 


{ 


} 


/* 
Output: 


// Create a linked list object: 
LinkedList lList = new LinkedList(); 


// Add some elements: 
lList.add("100"); 
lList.add("200"); 
lList.add("300"); 
lList.add("400"); 


// Get and display the elements: 

System.out.println("The elements of the list are:"); 

for (int i=@; i<lList.size(); i++) 
System.out.println(lList.get(i)); 


// Print the size: 
System.out.println("The size of the list is: " + lList.size()); 


// Clear the list: 
lList.clear(); 
System.out.print("The list has been cleared. "); 


// Print the new size: 
System.out.println("The size is now: " + lList.size()); 


The elements of the list are: 


100 
200 
300 
400 


The size of the list is: 4 
The list has been cleared. The size is now: @ 


*/ 


See Also 
Reference 
List Interface 
Concepts 
List Members 


java.util Package 


Visual J# Reference 


List.contains Method 


Checks if a List object contains a specific element. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean contains( 
java.lang.Object e); 


Parameters 
e 
The element searched for in the List object. 
Return Value 
true if the element was found; false otherwise. 
Example 
In this example, you create and initialize a linked list object, and then you check to see if the list contains a specified element. 


// list-cont1.jsl 
// List.contains example 


import java.util.*; 


public class MyClass 


4 
public static void main(String[] args) 
{ 
// Create a linked list object: 
LinkedList lList = new LinkedList(); 
// Add some elements: 
lList.add("My Node"); 
lList.add( "Your Node"); 
lList.add(null1); 
lList.add(new Integer(55)); 
// Check if "My Node" is in the list: 
if(1lList.contains("My Node") ) 
System.out.print1ln( 
"The object \"My Node\" is in the list."); 
} 
} 
/ * 
Output: 
The object "My Node" is in the list. 
m/f 
See Also 
Reference 
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List.containsAll Method 


Checks if a List object contains all the elements of a collection. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean containsA11( 
java.util.Collection c); 


Parameters 
c 
The name of the collection. 
Return Value 
true if all the elements were found; false otherwise. 
Example 
In this example, you create a linked list object, IList, and add some elements to it. Then you create another linked list object, 


IList1, and copy IList to it. Testing IList1 to see if it contains all the elements of IList gives the result true. 


// list-contAll11.jsl 
// List.containsAll example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Create a linked list object: 
LinkedList 1lList = new LinkedList(); 
// Add some elements: 
lList.add("My Node"); 
lList.add( "Your Node"); 
lList.add(null1); 
lList.add(new Integer(55)); 
// Create a new list lList1: 
LinkedList 1lList1 = new LinkedList(); 
// Add all the elements of lList to lList1: 
lList1.addAl1l(1List); 
// Confirm that the elements of IList exist in IList1: 
if(1lList1.containsAll(1lList)) 
System.out.println( 
"All the elements exist in the new list."); 
ii 
} 
/ * 
Output: 
All the elements exist in the new list. 
=] 
See Also 
Reference 


List Interface 


Concepts 
List Members 
java.util Package 
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List.equals Method 


Checks if a List object is equal to the specified object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean equals( 
java.lang.Object c); 


Parameters 
c 
The object to compare to. 
Return Value 
true if the specified object is equal to this object; false otherwise. 
Example 
In this example, you create two linked list objects, add some elements to the first one, and copy it to the second one. Then you 


test the two objects for equality. 


// list-eq1.jsl 
// List.Equals example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Create a linked list object: 
LinkedList 1lList = new LinkedList(); 
// Add some elements: 
lList.add("My Node"); 
lList.add( "Your Node"); 
lList.add(null1); 
lList.add(new Integer(55)); 
// Create a new list lList1: 
LinkedList lList1 = new LinkedList(); 
// Add all the element of 1List to lList1: 
lList1.addAll(1lList); 
// Check if the two lists are identical: 
if(1lList1.Equals(1lList)) 
System.out.println("The two lists are the same."); 
} 
} 
/ * 
Output 
The two lists are the same. 
*/ 
See Also 
Reference 


List Interface 
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List Members 
java.util Package 
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List.get Method 


Retrieves an element from a List at a specified index. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public abstract java.lang.Object get( 
int ix); 





Parameters 
ix 
The index of the element to be read. 
Return Value 
The element to be retrieved from the List object. 
Example 
See the examples under clear and add. 
Remarks 
Throws IndexOutOfBoundsException if ix is negative, or greater than or equal to size. 


See Also 
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List. hashCode Method 


Retrieves the hash code of a List.object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract int hashCode(); 


Return Value 
An integer representing the hash code of the List object. 
Example 


In this example, you display the hash code of a linked list object after adding some elements to it. 


// list-getHash1.jsl 
// List.GetHashCode example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Create a linked list object: 
LinkedList lList = new LinkedList(); 
// Add some elements: 
lList.add(new Double(5.25)); 
lList.add(new Byte((byte)127)); 
lList.add(null1); 
lList.add(new Integer(55)); 
// Print the hash code: 
System.out.println("The hash code is: " + lList.GetHashCode()); 
} 
} 
/ * 
The hash code is: -1898639464 
of, 
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List.indexOf Method 


Retrieves the index of a specific element in a List.object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract int indexOFf( 
java.lang.Object e); 


Parameters 
e 
The elements for which the index is retrieved. 
Return Value 
The index of the element. 
Example 


// list-idxOf1.jsl 
// List.indexOf example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a linked list object: 
LinkedList lList = new LinkedList(); 
// Add some elements: 
lList.add("My node"); 
lList.add("Her node"); 
lList.add("Their node"); 
lList.add( "Your node"); 
// Print the index of "Your node": 
System.out.println("The index is: " + 
lList.indexOf("Your node")); 
} 
} 
/* 
The index is: 3 
ed 
Remarks 


If the element is not found it returns -1. 
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List.isEmpty Method 


Checks if a List object is empty. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean isEmpty(); 


Return Value 
true if the List object is empty; false otherwise. 
Example 


In this example, you create and initialize a linked list object, clear it, and then you check to see if the list is empty. 


// list-isEmp1.jsl 
// List.isEmpty example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Create a linked list object: 
LinkedList lList = new LinkedList(); 
// Add some elements: 
lList.add("My node"); 
lList.add("Her node"); 
lList.add("Their node"); 
lList.add("Your node"); 
// Clear the list: 
lList.clear(); 
// Check if the list is empty: 
if(1lList.isEmpty()) 
System.out.println("The list is now empty."); 
} 
} 
/ * 
The list is now empty. 
a A 
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List.iterator Method 


Provides an iterator to iterate over a List object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.util.Iterator iterator(); 


Return Value 

An iterator that can be used over the List object. 

Example 

In this example, you create an initialize a collection and then you retrieve an iterator to iterate over the collection and display its 


members. 


// list-iterator1.jsl 
// List.iterator example 


import java.util.*; 


public class MyClass 


{ 
public static void main() 
{ 
Collection hSet = new HashSet(); 
// Add some elements to the HashSet: 
hSet.add("1 "); 
hSet.add("2 "); 
hSet.add("3 "); 
hSet.add("4 "); 
// Retrieve an iterator to the hashset: 
Iterator iter = hSet.iterator(); 
// Extract elements from iterator. 
// Note that the elements may not follow the order in which they 
// are added to HashSet. 
while(iter.hasNext()) 
{ 
System.out.print(iter.next()); 
iter.remove(); 
} 
} 
} 
/ * 
Output: 
3142 
*/ 
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List.lastIndexOf Method 


Retrieves the last index of the specified element. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract int lastIndexOF ( 
java.lang.Object e); 


Parameters 
e 
The element whose last index is retrieved. 
Return Value 
The last index of the element. 
Example 


// list-lastidx1.jsl 
// List.lastIndexOf example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a linked list object: 
LinkedList lList = new LinkedList(); 
// Add some elements: 
lList.add("My node"); 
lList.add("Her node"); 
lList.add("Their node"); 
lList.add("Your node"); 
lList.add("Her node"); 
// Print the last index of "Her node": 
System.out.println("The lst index is: " + 
1lList.lastIndexOf("Her node")); 
} 
} 
/ * 
The lst index is: 4 
e/ 
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List.listlterator Method 


Overload List 





Name Description 





Listlistlterator () Provides an iterator to traverse the elements of a List object. 





Listlistlterator (int) Provides an iterator for a List object that starts at specific index position. 
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List.listlterator Method () 


Provides an iterator to traverse the elements of a List object. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.util.ListIterator listIterator(); 


Return Value 


An iterator that can be used to traverse the elements of the List object. 


Example 


// List-lIter1.jsl 
// List.listIteratort example 


import java.util.*; 


public class MyClass 


public static void main(String[] args) 


{ 
} 
} 
/* 
Output: 


// Create a linked list object: 
LinkedList lList = new LinkedList(); 


// Add some elements: 
lList.add("Isabella"); 
lList.add( "Angelina" ) ; 
lList.add("Jacqueline") ; 


// Get a list iterator: 
ListIterator iter = lList.listIterator(); 


// Extract elements from iterator: 
while (iter.hasNext()) 


{ 


} 
System.out.print1n(); 


System.out.print(iter.next() + " "); 


// Extract elements from iterator in reverse order: 
while (iter.hasPrevious()) 


{ 


} 
System.out.print1n(); 


System.out.print(iter.previous() + " "); 


Isabella Angelina Jacqueline 
Jacqueline Angelina Isabella 


*/ 
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List.listlterator Method (Int32) 


Provides an iterator for a List object that starts at specific index position. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.util.ListIterator listIterator( 
int ix); 


Parameters 
ix 
The starting position of the iterator. 
Return Value 
The List iterator. 
Example 


// List-lIter2.jsl 
// List.listIteratort example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a linked list object: 
LinkedList lList = new LinkedList(); 
// Add some elements: 
lList.add("Isabella"); 
lList.add( "Angelina" ) ; 
// Get a list iterator: 
ListIterator li = lList.listIterator(1); 
// Display the list iterator: 
System.out.printin("The list iterator is: " + li); 
} 
} 
/ * 
Output: 
The list iterator is: java.util.LinkedList$LinkIterator@33c@d9d 
7 
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List.remove Method 


Overload List 





Name 


Description 





List.remove (int) 


Deletes an element at a specific index from a List object. 





List.remove (Object) 








Deletes a specific element from a List object. 
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List.remove Method (Int32) 


Deletes an element at a specific index from a List object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.Object remove( 
int ix); 


Parameters 
ix 
The index of the element to be deleted. 
Return Value 
The deleted element. 
Example 
In this example, you create and initialize a linked list object, and then you remove the element at index #1. 


// list-remove1.jsl 
// List.remove example 


import java.util.*; 


public class MyClass 


4 
public static void main(String[] args) 
{ 
// Create a linked list object: 
LinkedList 1lList = new LinkedList(); 
// Add some elements: 
lList.add("My node"); 
lList.add("Her node"); 
lList.add("Their node"); 
lList.add("Your node"); 
// Remove the element at index 1: 
lList.remove(1); 
// Display the elements after the removal: 
System.out.println("The removed element is: " + 
lList.remove(1) ); 
} 
} 
/* 
The removed element is: Their node 
*/ 
Remarks 


Throws IndexOutOfBoundsException if ix is negative, or greater than or equal to size. 
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List.remove Method (Object) 


Deletes a specific element from a List object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean remove( 
java.lang.Object e); 


Parameters 
e 


The element to be deleted. 
Return Value 
true if the element was successfully deleted; false otherwise. 
Example 


In this example, you create and initialize a linked list object, and then you remove one element and display the list before and 
after the removal. 


// list-remove2.jsl 
// List.remove example 


import java.util.*; 


public class MyClass 
{ 
public static void main(String[] args) 
if 
// Create a linked list object: 
LinkedList 1lList = new LinkedList(); 


// Add some elements: 
lList.add("My node"); 
lList.add("Her node"); 
lList.add("Their node"); 
lList.add( "Your node"); 


// Display the elements before the removal: 
System.out.println("The elements are: " + lList); 


// Remove the element at index 2: 
lList.remove("Their node"); 


// Display the elements after the removal: 
System.out.println("The elements now are: " + lList); 


/* 

Output: 

The elements are: [My node, Her node, Their node, Your node] 
The elements now are: [My node, Her node, Your node] 


mh 
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List.removeAll Method 


Deletes all the elements from a List object that exist is a specified collection. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean removeA11( 
java.util.Collection c); 


Parameters 
c 
The collection of elements to be deleted from List. 
Return Value 
true if the list is modified after the call; false otherwise. 
Example 
In this example, you create and initialize two collections, aList and IList. Then you remove all the elements from IList that exist in 


aList. The output displays the contents of the two lists before and after the removal. 


// List-remA1.jsl 
// List.removeAll example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Create two collections: 
LinkedList lList = new LinkedList(); 
ArrayList aList = new ArrayList(); 
// Add some elements to lList: 
lList.add("Isabella"); 
lList.add( "Angelina" ) ; 
lList.add("Pille") ; 
lList.add( "Hazem" ) ; 
// Add some elements to aList: 
aList.add("Isabella") ; 
aList.add("Angelina") ; 
aList.add("Bianca") ; 
// Display the two lists (before): 
System.out.println("The linked list before: " + lList); 
System.out.printlin("The array list before: " + aList); 
// Remove aList members that exist in lList: 
lList.removeAll(aList); 
// Display the two lists (after): 
System.out.printlin("The linked list after: " + lList); 
System.out.printlin("The array list after: " + aList); 
} 
} 
LE 
Output: 


The linked list before: [Isabella, Angelina, Pille, Hazem] 


The array list before: [Isabella, Angelina, Bianca] 
The linked list after: [Pille, Hazem] 
The array list after: [Isabella, Angelina, Bianca] 


id 
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List.retainAll Method 


Deletes the elements of the current List collection that do not exist in specified collection object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean retainAl1l( 
java.util.Collection c); 


Parameters 
c 
The specified collection 
Return Value 
true if the list has changed after the call; false otherwise. 
Example 
In this example, you create and initialize two collections, aList and IList. Then you delete the elements of IList that do not exist in 


aList and display both collections before and after. 


// List-retA1.jsl 
// List.retainAll example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Create two collections: 
LinkedList lList = new LinkedList(); 
ArrayList aList = new ArrayList(); 
// Add some elements to lList: 
lList.add("Isabella"); 
lList.add( "Angelina" ) ; 
lList.add("Pille") ; 
lList.add( "Hazem" ) ; 
// Add some elements to aList: 
aList.add("Isabella") ; 
aList.add("Angelina") ; 
aList.add("Bianca") ; 
// Display the two collections before: 
System.out.println("The aList collection before: " + aList); 
System.out.println("The lList collection before: " + lList); 
// Delete the elements 1lList that are not in aList: 
lList.retainAll(aList); 
// Display the collection after: 
// Display the two collections before retaining all: 
System.out.println("The aList collection after: " + aList); 
System.out.println("The 1lList collection after: " + lList); 
} 
: 
/* 


Output: 


The aList collection before: [Isabella, Angelina, Bianca] 

The 1lList collection before: [Isabella, Angelina, Pille, Hazem] 
The aList collection after: [Isabella, Angelina, Bianca] 

The 1lList collection after: [Isabella, Angelina] 

a 
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List.set Method 


Inserts an element at the specified location. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.Object set( 
int ix, 
java.lang.Object e); 


Parameters 
ix 


The index of the element. 


The List element to be added. 
Return Value 
The new element in the List object. 
Example 


// list-set1.jsl 
// List.set example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Create a linked list object: 
LinkedList lList = new LinkedList(); 
// Add some elements: 
lList.add("My node"); 
lList.add("Her node"); 
lList.add("Their node"); 
lList.add("Your node"); 
// Display the elements: 
System.out.println("The old list:"); 
for (int i=@; i<lList.size(); i++) 
System.out.printin(i + "=" + lList.get(i)); 
// Set the element #2: 
System.out.println("\nThe following element has been set: " 
+ lList.set(2,"His node")); 
// Display the elements after changing #2: 
System.out.println("\nThe new list:"); 
for (int i=@; i<lList.size(); i++) 
System.out.printin(i + "=" + lList.get(i)); 
} 
} 
Le 
Output: 
The old list: 
@=My node 


1=Her node 


2=Their node 
3=Your node 


The following element has been set: Their node 


The new list: 
@=My node 
1=Her node 
2=His node 
3=Your node 


er 











Remarks 
Throws IndexOutOfBoundsException if ix is negative, or greater than or equal to size. 
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List.size Method 


Retrieves the number of elements in a List object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public abstract int size(); 





Return Value 

The number of elements in the List object. 
Example 

See the example under clear. 
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List.subList Method 


Creates a sub list from the elements that exist within a specified index range in a List object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.util.List subList( 
int fromIx, 
int toIx); 


Parameters 
fromlx 


The starting index of the range. 
tolx 
The ending index of the range. 
Return Value 
A list that contains the elements in the specified range. 
Example 


// list-sublist1.jsl 
// List.subList example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Create a linked list object: 
LinkedList lList = new LinkedList(); 
// Add some elements: 
lList.add("My node"); 
lList.add("Her node"); 
lList.add("Their node"); 
lList.add("Your node"); 
// Display the list: 
System.out.println("The original list:"); 
for (int i=@; i<lList.size(); i++) 
System.out.printin(i + "=" + lList.get(i)); 
// Create a sublist: 
List lList1 = lList.subList(2,4); 
// Display the sublist: 
System.out.println("\nThe sublist:"); 
for (int i=@; i<lList1.size(); i++) 
System.out.printin(i + "=" + LList1.get(i)); 
} 
} 
/* 
Output: 
The original list: 
@=My node 


1=Her node 
2=Their node 


3=Your node 


The sublist: 
@=Their node 
1=Your node 


*/ 





Remarks 
Throws IndexOutOfBoundsException if fromlx is negative, or tolx greater than size. 
Throws IllegalArgumentException if tolx is less than fromlx. 
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List.toArray Method 


Overload List 





Name Description 





List.toArray () Copies and returns a List elements into an array. 





List.toArray (Object[]) Copies and returns all the elements of a List object into a specific array object. 
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List.toArray Method () 


Copies and returns a List elements into an array. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.Object[] toArray(); 


Return Value 
The array object that contains the elements of the List object. 
Example 


In this example, you create and initialize a linked list object, and then you convert the list to an array and display the elements 
of the array. 


// list-toArri.jsl 
// List.toArray example 


import java.util.*; 


public class MyClass 
{ 
public static void main(String[] args) 
if 
// Create a linked list object: 
LinkedList lList = new LinkedList(); 


// Add some elements: 
lList.add("My node"); 
lList.add("Her node"); 
lList.add("Their node"); 
lList.add("Your node"); 


// Create an array from the list: 
Object[] s = lList.toArray(); 


// Display the array elements: 

System.out.println("The array elements are:"); 

for (int i=@; i<lList.size(); i++) 
System.out.println(i + "=" + s[i]); 


} 


/* 

Output: 

The array elements are: 
@=My node 

1=Her node 

2=Their node 

3=Your node 


a 
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List.toArray Method (Object ]) 


Copies and returns all the elements of a List object into a specific array object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.Object[] toArray( 
java.lang.Object[] arr); 


Parameters 
arr 

The array that receives the elements of the List object. 
Return Value 
The array object that contains the elements of the List object. 
Example 


In this example, you create and initialize a linked list object, and then you convert the list to an array "s". Then you copy "s" toa 
new array "s1" and display the elements of "s1." 


// list-toArr2.jsl 
// List.toArray example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Create a linked list object: 
LinkedList 1lList = new LinkedList(); 
// Add some elements: 
lList.add("My node"); 
lList.add("Her node"); 
lList.add("Their node"); 
lList.add( "Your node"); 
// Create an array from the list: 
String[] arr = new String[@]; 
// Copy 1lList to arr: 
arr = (String[])1lList.toArray(arr) ; 
// Display the new array elements: 
System.out.println("The array elements are:"); 
for (int i=@; i<arr.length; i++) 
System.out.printin(i + "=" + arr[i]); 
} 
} 
/* 
Output: 
The array elements are: 
@=My node 


1=Her node 
2=Their node 
3=Your node 


*/ 


Remarks 
If arr is not large enough to hold the List members it will be expanded. 
The type of List elements should match the type of the array elements. 
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Listlterator Interface 


An interface that implements the Iterator interface. It allows traversing the list and modifying it during iteration. It also obtains 
the current position of the iterator's cursor. The cursor position is between the elements of a collection. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public interface java.util.ListIterator 
extends java.util.Iterator 





Remarks 
This interface is not thread safe. If two threads modify the list concurrently, the user will get ConcurrentModificationException. 
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Listlterator Members 


An interface that implements the Iterator interface. It allows traversing the list and modifying it during iteration. It also obtains 
the current position of the iterator's cursor. The cursor position is between the elements of a collection. 


The following tables list the members exposed by the Listlterator type. 


Public Methods 


Name Description 
add Adds an object to Listlterator. 
hasNext Checks if there exists an element beyond the iterator position in a Listlterator object. 


hasPrevious |Checks if there exists an element before the iterator position in a Listlterator object. 











next Returns the next object beyond the iterator position in a Listlterator object and moves the iterator's position. 
nextIndex Returns the index of the next object in a Listlterator object. 
previous Returns the object before the iterator position in a Listlterator object and moves the iterator's position. 





previous|ndex |Returns the index of the previous object in a Listlterator object. 

















remove Removes the last element from a Listlterator object, which was called by next or previous. 
set Sets an element in a Listlterator collection. 
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Listlterator Methods 


Public Methods 











Name Description 
add Adds an object to Listlterator. 
hasNext Checks if there exists an element beyond the iterator position in a Listlterator object. 





hasPrevious |Checks if there exists an element before the iterator position in a Listlterator object. 








next Returns the next object beyond the iterator position in a Listlterator object and moves the iterator's position. 
nextIndex Returns the index of the next object in a Listlterator object. 
previous Returns the object before the iterator position in a Listlterator object and moves the iterator's position. 


previous|ndex |Returns the index of the previous object in a Listlterator object. 





remove Removes the last element from a Listlterator object, which was called by next or previous. 
set Sets an element in a Listlterator collection. 
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Listlterator.add Method 


Adds an object to Listlterator. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract void add( 
java.lang.Object e); 


Parameters 
e 
The object to be added to Listlterator. 
Example 
In this example, you create a Listlterator object before the second element in a collection, and add a new element at this 


position. 


// LList-Add1.jsl 
// ListIteratort.add example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a linked list object: 
LinkedList lList = new LinkedList(); 
// Add some elements: 
lList.add("Isabella"); 
lList.add( "Angelina" ) ; 
// Get a list iterator before index 1: 
ListIterator li = lList.listIterator(1); 
// Add a new element at index 1: 
li.add("Bianca"); 
// Display the collection: 
System.out.printin("The collection is: " + lList); 
} 
/ * 
Output: 
The collection is: [Isabella, Bianca, Angelina] 
*/ 
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Listlterator.hasNext Method 


Checks if there exists an element beyond the iterator position in a Listlterator object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean hasNext(); 


Return Value 
true if there is a next element; false otherwise. 
Example 


In this example, you create and initialize a Listlterator object before the second element in a collection, and then you display all 
elements next to the iterator's position. 


// LIter-hnext1.jsl 
// ListIteratort.hasNext example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Create a linked list object: 
LinkedList lList = new LinkedList(); 
// Add some elements: 
lList.add("Isabella"); 
lList.add( "Angelina" ) ; 
lList.add("Bianca"); 
// Get a list iterator before index 1: 
ListIterator li = lList.listIterator(1); 
// Display the next elements: 
while(li.hasNext()) 
System.out.println(li.next()); 
i; 
if 
/ * 
Output: 
Angelina 
Bianca 
*/ 
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Listlterator.hasPrevious Method 


Checks if there exists an element before the iterator position in a Listlterator object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean hasPrevious(); 


Return Value 

true if there is a previous element; false otherwise. 

Example 

In this example, you create a Listlterator object before the second element in a collection, and then you check to see if there is a 


previous element. 


// LIter-hPrev1.jsl 
// ListIteratort.hasPrevious example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Create a linked list object: 
LinkedList lList = new LinkedList(); 
// Add some elements: 
lList.add("Isabella"); 
lList.add( "Angelina" ) ; 
// Get a list iterator before index 1: 
ListIterator li = lList.listIterator(1); 
// Display if there is a previous element: 
System.out.println(li.hasPrevious()); 
} 
} 
/ * 
Output 
true 
a 
See Also 
Reference 
Listlterator Interface 
Concepts 


Listlterator Members 
java.util Package 


Visual J# Reference 


Listlterator.next Method 


Returns the next object beyond the iterator position in a Listlterator object and moves the iterator's position. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.Object next(); 


Return Value 

The next object beyond the iterator position in Listlterator. 

Example 

In this example, you create a Listlterator object before the second element in a collection, and then you display the element 


next to the iterator's position. 


// LIter-next1.jsl 
// ListIteratort.next example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Create a linked list object: 
LinkedList lList = new LinkedList(); 
// Add some elements: 
lList.add("Isabella"); 
lList.add( "Angelina" ) ; 
// Get a list iterator before index 1: 
ListIterator li = lList.listIterator(1); 
// Display the next element: 
System.out.println("The next element is: " + li.next()); 
} 
} 
/* 
Output: 
The next element is: Angelina 
if 
Remarks 


Throws NoSuchElementException if there is no next object or if the list is null. 


See Also 

Reference 
Listlterator Interface 
Concepts 

Listlterator Members 
java.util Package 


Visual J# Reference 


Listlterator.nextIndex Method 


Returns the index of the next object in a Listlterator object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract int nextIndex(); 


Return Value 

The index of the next object in the Listlterator object. 

Example 

In this example, you create a Listlterator object before the second element in a collection, and then you display the index of the 


element next to the iterator's position. 


// LIter-nxtix1.jsl 
// ListIteratort. nextIndex example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Create a linked list object: 
LinkedList lList = new LinkedList(); 
// Add some elements: 
lList.add("Isabella"); 
lList.add( "Angelina" ) ; 
// Get a list iterator before index 1: 
ListIterator li = lList.listIterator(1); 
// Display the next index: 
System.out.println("Next index: " + li.nextIndex()); 
} 
} 
/ * 
Output: 
Next index: 1 
*/ 
See Also 
Reference 
Listlterator Interface 
Concepts 


Listlterator Members 
java.util Package 


Visual J# Reference 


Listlterator.previous Method 


Returns the object before the iterator position in a Listlterator object and moves the iterator's position. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.Object previous(); 


Return Value 

The object before the iterator position in the Listlterator object. 

Example 

In this example, you create a Listlterator object before the second element in a collection, and then you display the element 


before the iterator's position. 


// LIter-previ.jsl 
// ListIteratort.previous example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Create a linked list object: 
LinkedList lList = new LinkedList(); 
// Add some elements: 
lList.add("Isabella"); 
lList.add( "Angelina" ) ; 
// Get a list iterator: 
ListIterator li = lList.listIterator(1); 
// Display the previous element: 
System.out.printin("The previous element is: " + 
li.previous()); 
} 
} 
/* 
Output: 
The previous element is: Isabella 
=) 
Remarks 


Throws NoSuchElementException if there is no previous object or if the list is null. 


See Also 

Reference 
Listlterator Interface 
Concepts 

Listlterator Members 
java.util Package 


Visual J# Reference 


Listlterator.previousIndex Method 


Returns the index of the previous object in a Listlterator object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract int previousIndex(); 


Return Value 

The index of the previous object in the Listlterator object. 

Example 

In this example, you create a Listlterator object before the second element in a collection, and then you display the index of the 


element before the iterator's position. 


// LIter-previx1.jsl 
// ListIteratort.previousIndex example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Create a linked list object: 
LinkedList lList = new LinkedList(); 
// Add some elements: 
lList.add("Isabella"); 
lList.add( "Angelina" ) ; 
// Get a list iterator: 
ListIterator li = lList.listIterator(1); 
// Display the previous index: 
System.out.println("Previous index: " + li.previousIndex()); 
} 
} 
/ * 
Output: 
Previous index: @ 
*/ 
See Also 
Reference 
Listlterator Interface 
Concepts 


Listlterator Members 
java.util Package 


Visual J# Reference 


Listlterator.remove Method 


Removes the last element from a Listlterator object, which was called by next or previous. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract void remove(); 


Example 


In this example, you construct a collection and create a Listlterator before position 0. A call to next, at this point, will return the 
first element in the collection. Then you remove the first element using remove, and display the new collection and the new 
next element. 


// Liter-rem1.jsl 
// ListIterator.remove example 


import java.util.*; 


public class MyClass 
if 
public static void main(String[] args) 
{ 
// Create a linked list object: 
LinkedList lList = new LinkedList(); 


// Add some elements: 
lList.add("Isabella"); 
lList.add( "Angelina" ) ; 
lList.add( "Bianca" ); 


// Get a list iterator before the starting index: 
ListIterator li = lList.listIterator(); 


// Display the list: 
System.out.println("The collection: " + lList); 


// Dispaly the next element: 
System.out.println("The next element: " + li.next()); 


// Remove the last called by next(): 
li.remove(); 


// Display the new list: 
System.out.println("The new collection: " + lList); 


// Display the new next element: 
System.out.println("The new next element: " + li.next()); 


} 


/* 

Output: 

The collection: [Isabella, Angelina, Bianca] 
The next element: Isabella 

The new collection: [Angelina, Bianca] 

The new next element: Angelina 


Remarks 


Throws IllegalStateException if no call to next or previous has been made. 


See Also 

Reference 
Listlterator Interface 
Concepts 

Listlterator Members 
java.util Package 


Visual J# Reference 


Listlterator.set Method 


Sets an element in a Listlterator collection. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract void set( 
java.lang.Object e); 


Parameters 
e 


The object to be set. 
Example 


In this example, you construct a collection and create a Listlterator before position 0. A call to next, at this point, will return the 
first element in the collection. Then you change the first element by using set, and display the new collection. 


// Liter-set1.jsl 
// ListIterator.set example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 
{ 
// Create a linked list object: 
LinkedList lList = new LinkedList(); 


// Add some elements: 
lList.add("Isabella"); 
lList.add( "Angelina" ) ; 
lList.add("Bianca"); 


// Get a list iterator before the starting index: 
ListIterator li = lList.listIterator(); 


// Display the list: 
System.out.println("The collection: " + lList); 


// Dispaly the next element: 
System.out.println("The next element: " + li.next()); 


// Change the last called by next(): 
li.set("Sally"); 


// Display the new list: 
System.out.println("The new collection: " + lList); 


} 


/* 

Output: 

The collection: [Isabella, Angelina, Bianca] 
The next element: Isabella 

The new collection: [Sally, Angelina, Bianca] 


af 


Remarks 


Throws IllegalStateException if no call to next or previous has been made. 


See Also 

Reference 
Listlterator Interface 
Concepts 

Listlterator Members 
java.util Package 


Visual J# Reference 


ListResourceBundle Class 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract class java.util.ListResourceBundle 
extends java.util.ResourceBundle 





Inheritance Hierarchy 

java.lang.Object 
java.util.ResourceBundle 
java.util.ListResourceBundle 


See Also 

Concepts 

ListResourceBundle Members 
java.util Package 


Visual J# Reference 


ListResourceBundle Members 


The following tables list the members exposed by the ListResourceBundle type. 


Public Constructors 
Name 


ListResourceBundle 


Public Fields 





Description 





Name Description 





parent (inherited from ResourceBundle) 





Public Methods 





Name 


Description 




















equals (inherited from Object ) 
getContents 

hashCode (inherited from Object ) 

getKeys Overridden. 

getObject (inherited from ResourceBundle) 
getString (inherited from ResourceBundle) 





getStringArray 


(inherited from ResourceBundle) 

















getClass (inherited from Object ) 
handleGetObject Overridden. 

clone (inherited from ResourceBundle) 
setParent (inherited from ResourceBundle) 
toString (inherited from ResourceBundle) 








Protected Methods 
Name 


finalize 








Description 


(inherited from Object ) 





See Also 

Reference 
ListResourceBundle Class 
Concepts 

java.util Package 





Visual J# Reference 


ListResourceBundle Fields 


Public Fields 

















Name Description 

parent (inherited from java.util.ResourceBundle) 
See Also 

Reference 

ListResourceBundle Class 

Concepts 


java.util Package 


Visual J# Reference 


ListResourceBundle Constructor 


Initializes a new instance of the ListResourceBundle Class . 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.util.ListResourceBundle(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
ListResourceBundle Class 
Concepts 

ListResourceBundle Members 
java.util Package 


Visual J# Reference 


ListResourceBundle Methods 


Public Methods 









































Name Description 

equals (inherited from Object ) 
getContents 

hashCode (inherited from Object ) 

getKeys Overridden. 

getObject (inherited from ResourceBundle) 
getString (inherited from ResourceBundle) 
getStringArray (inherited from ResourceBundle) 
getClass (inherited from Object ) 
handleGetObject Overridden. 

clone (inherited from ResourceBundle) 
setParent (inherited from ResourceBundle) 
toString (inherited from ResourceBundle) 
Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 

ListResourceBundle Class 

Concepts 


java.util Package 


Visual J# Reference 


ListResourceBundle.getContents Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


protected abstract [Ljava.lang.Object;[] getContents(); 


See Also 

Reference 
ListResourceBundle Class 
Concepts 

ListResourceBundle Members 
java.util Package 


Visual J# Reference 


ListResourceBundle.getKeys Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Enumeration getKeys(); 


See Also 

Reference 
ListResourceBundle Class 
Concepts 

ListResourceBundle Members 
java.util Package 


Visual J# Reference 


ListResourceBundle.handleGetObject Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final java.lang.Object handleGetObject( 
java.lang.String key); 


Parameters 


key 


See Also 

Reference 
ListResourceBundle Class 
Concepts 

ListResourceBundle Members 
java.util Package 


Visual J# Reference 


Locale Class (J#) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final class java.util.Locale 

extends java.lang.Object 

implements java.io.Serializable, java.lang.Cloneable, System.Runtime.Serialization.ISer 
ializable 





Inheritance Hierarchy 
java.lang.Object 
java.util.Locale 


See Also 
Concepts 
Locale Members 
java.util Package 





Visual J# Reference 


Locale Members (J#) 


The following tables list the members exposed by the Locale type. 


Public Constructors 
Name 


Locale 





Public Fields 





Name Description 





CANADA 





CANADA_FRENCH 


CHINA 


CHINESE 


ENGLISH 


FRANCE 


FRENCH 


GERMAN 


GERMANY 


ITALIAN 


ITALY 


JAPAN 


JAPANESE 


KOREA 


KOREAN 


PRC 


SIMPLIFIED_CHINESE 





TAIWAN 





TRADITIONAL_CHINESE 





UK 





US 











Public Methods 






































Name Description 
equals Overridden. 
getCountry 

getDefault 

getDisplayCountry Overloaded. 
getDisplayLanguage Overloaded. 
getDisplayName Overloaded. 
getDisplayVariant Overloaded. 
hashCode Overridden. 
getISO3Country 

getISO3Language 

getLanguage 

GetObjectData 

getClass (inherited from Object ) 
getVariant 

MemberwiseClone Performs a shallow copy of the object. 
setDefault 

toString Overridden. 
See Also 

Reference 

Locale Class 

Concepts 


java.util Package 





Visual J# Reference 


Locale Fields 


Public Fields 





Name Description 





CANADA 





CANADA_FRENCH 





CHINA 





CHINESE 





ENGLISH 


FRANCE 


FRENCH 


GERMAN 


GERMANY 


ITALIAN 


ITALY 


JAPAN 


JAPANESE 


KOREA 


KOREAN 


PRC 


SIMPLIFIED_CHINESE 


TAIWAN 


TRADITIONAL_CHINESE 


UK 





US 











See Also 
Reference 
Locale Class 
Concepts 
java.util Package 


Visual J# Reference 


Locale.CANADA Field 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final java.util.Locale CANADA; 





See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.CANADA_FRENCH Field 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final java.util.Locale CANADA_FRENCH; 


See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.CHINA Field 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final java.util.Locale CHINA; 





See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.CHINESE Field 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final java.util.Locale CHINESE; 


See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.ENGLISH Field 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final java.util.Locale ENGLISH; 





See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.FRANCE Field 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final java.util.Locale FRANCE; 





See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.FRENCH Field 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final java.util.Locale FRENCH; 





See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.GERMAN Field 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final java.util.Locale GERMAN; 


See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.GERMANY Field 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final java.util.Locale GERMANY; 


See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.ITALIAN Field 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final java.util.Locale ITALIAN; 





See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.ITALY Field 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final java.util.Locale ITALY; 





See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale. JAPAN Field 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final java.util.Locale JAPAN; 





See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale. JAPANESE Field 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final java.util.Locale JAPANESE; 


See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.KOREA Field 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final java.util.Locale KOREA; 





See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.KOREAN Field 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final java.util.Locale KOREAN; 





See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.PRC Field 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final java.util.Locale PRC; 





See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.SIMPLIFIED_CHINESE Field 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final java.util.Locale SIMPLIFIED CHINESE; 


See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale. TAIWAN Field 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final java.util.Locale TAIWAN; 





See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale. TRADITIONAL_CHINESE Field 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static final java.util.Locale TRADITIONAL_CHINESE; 


See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.UK Field 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final java.util.Locale UK; 





See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.US Field 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public static final java.util.Locale US; 





See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale Constructor 


Overload List 





Name Description 





Locale (SerializationInfo, StreamingContext) 





Locale (String, String) 





Locale (String, String, String) 














See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale Constructor (SerializationInfo, StreamingContext) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


protected java.util.Locale( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


context 


See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale Constructor (String, String) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Locale( 
java.lang.String languageCode, 
java.lang.String ctryRgnCode) ; 


Parameters 


languageCode 
ctryRgnCode 


See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale Constructor (String, String, String) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Locale( 
java.lang.String languageCode, 
java.lang.String ctryRgnCode, 
java.lang.String variantCode) ; 


Parameters 


languageCode 
ctryRgnCode 
variantCode 


See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale Methods 


Public Methods 























Name Description 
equals Overridden. 
getCountry 

getDefault 

getDisplayCountry Overloaded. 
getDisplayLanguage Overloaded. 
getDisplayName Overloaded. 
getDisplayVariant Overloaded. 
hashCode Overridden. 
getISO3 Country 

getISO3Language 

getLanguage 

GetObjectData 

getClass (inherited from Object ) 
getVariant 

MemberwiseClone Performs a shallow copy of the object. 
setDefault 

toString Overridden. 
See Also 

Reference 

Locale Class 

Concepts 


java.util Package 





Visual J# Reference 


Locale.clone Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.equals Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean equals( 


java.lang.Object obj); 





Parameters 


obj 


See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.getCountry Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getCountry(); 


See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.getDefault Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static java.util.Locale getDefault(); 


See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.getDisplayCountry Method 


Overload List 





Name Description 





Locale.getDisplayCountry () 





Locale.getDisplayCountry (Locale) 











See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.getDisplayCountry Method () 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final java.lang.String getDisplayCountry(); 


See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.getDisplayCountry Method (Locale) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getDisplayCountry( 
java.util.Locale inLocale); 


Parameters 
inLocale 


See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.getDisplayLanguage Method 


Overload List 





Name Description 





Locale.getDisplayLanguage () 





Locale.getDisplayLanguage (Locale) 











See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.getDisplayLanguage Method () 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final java.lang.String getDisplayLanguage(); 


See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.getDisplayLanguage Method (Locale) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getDisplayLanguage( 
java.util.Locale inLocale); 


Parameters 
inLocale 


See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.getDisplayName Method 


Overload List 





Name 


Description 





Locale.getDisplayName () 





Locale.getDisplayName (Locale) 











See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 





Visual J# Reference 


Locale.getDisplayName Method () 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final java.lang.String getDisplayName(); 


See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.getDisplayName Method (Locale) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getDisplayName( 
java.util.Locale inLocale); 


Parameters 
inLocale 


See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.getDisplayVariant Method 


Overload List 





Name 


Description 





Locale.getDisplayVariant () 





Locale.getDisplayVariant (Locale) 











See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 





Visual J# Reference 


Locale.getDisplayVariant Method () 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final java.lang.String getDisplayVariant(); 


See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.getDisplayVariant Method (Locale) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getDisplayVariant( 
java.util.Locale inLocale); 


Parameters 
inLocale 


See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.hashCode Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized int hashCode(); 


See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.getISO3Country Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getISO3Country() throws java.util.MissingResourceException; 


See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 
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Locale.getISO3Language Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getISO3Language() throws java.util.MissingResourceException; 


See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 
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Locale.getLanguage Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getLanguage(); 


See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.GetObjectData Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void GetObjectData( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


context 


See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 
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Locale.getVariant Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getVariant(); 


See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 


Visual J# Reference 


Locale.setDefault Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static synchronized void setDefault( 
java.util.Locale inLocale); 


Parameters 
inLocale 


See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 
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Locale.toString Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final java.lang.String toString(); 


See Also 
Reference 
Locale Class 
Concepts 

Locale Members 
java.util Package 
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Map Interface 


An interface that provides a Map object for key entries and their corresponding values. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public interface java.util.Map 





See Also 
Concepts 

Map Members 
java.util Package 
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Map Members (J#) 


An interface that provides a Map object for key entries and their corresponding values. 


The following tables list the members exposed by the Map type. 


Public Methods 





Name 


Description 





clear 


Removes the elements from a Map object. 





containsKey 


Checks for a specific key in a Map object. 





containsValue 


Checks for a specific value in a Map object. 





entrySet 


equals 


get 


hashCode 


isEmpty 


keySet 


put 


putAll 


remove 


size 


values 





See Also 
Reference 

Map Interface 
Concepts 
java.util Package 





Retrieves the set of mappings contained in an entrySet object. 

Checks if a specified element in a Map object is equal to a specified object. 
Retrieves an element from a Map object. 

Retrieves the hash code for a Map object. 

Checks if a Map object is empty. 

Retrieves the key values of the keys in a Map object. 

Adds an element at a specific key entry to a Map object. 

Copies all the elements from a specified map to the current Map object. 
Deletes an element associated with a specific key from a Map object. 
Retrieves the number of the key-value mappings of a Map object. 


Retrieves the collection of values in a Map object. 





Visual J# Reference 


Map Methods 


Public Methods 


























Name Description 

clear Removes the elements from a Map object. 

containsKey Checks for a specific key in a Map object. 

containsValue Checks for a specific value in a Map object. 

entrySet Retrieves the set of mappings contained in an entrySet object. 

equals Checks if a specified element in a Map object is equal to a specified object. 
get Retrieves an element from a Map object. 

hashCode Retrieves the hash code for a Map object. 

isEmpty Checks if a Map object is empty. 

keySet Retrieves the key values of the keys in a Map object. 

put Adds an element at a specific key entry to a Map object. 

putAll Copies all the elements from a specified map to the current Map object. 
remove Deletes an element associated with a specific key from a Map object. 
size Retrieves the number of the key-value mappings of a Map object. 
values Retrieves the collection of values in a Map object. 

See Also 

Reference 

Map Interface 

Concepts 


java.util Package 
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Map.clear Method 


Removes the elements from a Map object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public abstract void clear(); 





Example 


In the following example, you create and initialize a HashMap object, which implements Map, and then you remove all the 
elements and display the values. The result is an empty set. 








// Map-cleari1.jsl 
// Map.clear example 
import java.util.*; 
public class MyClass 
public static void main(String[] args) 
{ 
// Create a HashMap object (Implements Map): 
HashMap hm = new HashMap(); 
// Add some elements: 
hm. put("4","Eve Kennedy"); 
hm.put("1","Isabella Abolrous"); 
hm.put("2","Emma Esteban"); 
// Clear the elements: 
hm.clear(); 
// Display the values: 
System.out.println("The values are: " + hm.values()); 
} 
} 
/* 
The values are: [] 
m/f 
See Also 
Reference 
Map Interface 
Concepts 
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java.util Package 
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Map.containsKey Method 


Checks for a specific key in a Map object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean containsKey( 
java.lang.Object k); 


Parameters 
k 
The key to search for in the Map object. 
Return Value 
true if the key exists; false otherwise. 
Example 
In the following example, you create and initialize a HashMap object, which implements Map, and then you check for the key 


"3" The result is false because this key is not in the object. 


// Map-conkey1.jsl 
// Map.containsKey example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Create a HashMap object (Implements Map): 
HashMap hm = new HashMap(); 
// Add some elements: 
hm. put("4","Eve Kennedy") ; 
hm.put("1","Isabella Abolrous"); 
hm.put("2","Emma Esteban"); 
// Check for a specific key: 
System.out.printin(hm.containsKey("3")); 
} 
H 
/* 
false 
*/ 
See Also 
Reference 
Map Interface 
Concepts 


Map Members 
java.util Package 
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Map.containsValue Method 


Checks for a specific value in a Map object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean containsValue( 
java.lang.Object v); 


Parameters 
V 
The value to search for in the Map object. 
Return Value 
true if the value exists; false otherwise. 
Example 
In the following example, you create and initialize a HashMap object, which implements Map, and then you check for the value 


“Eve Kennedy.” The result is true. 


// Map-conValue1.jsl 
// Map.containsValue example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Create a HashMap object (Implements Map): 
HashMap hm = new HashMap(); 
// Add some elements: 
hm. put("4","Eve Kennedy") ; 
hm.put("1","Isabella Abolrous"); 
hm.put("2","Emma Esteban"); 
// Check for a specific value: 
System. out.println(hm.containsValue("Eve Kennedy")); 
} 
H 
/* 
true 
*/ 
See Also 
Reference 
Map Interface 
Concepts 


Map Members 
java.util Package 
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Map.entrySet Method 


Retrieves the set of mappings contained in an entrySet object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.util.Set entrySet(); 


Return Value 
The set of mappings in the entrySet object. 
Example 


In this example, you create and initialize a TreeMap object, which implements Map, and then you display the set of mappings in 
the object. 


// Map-entrysm1.jsl 
// Map.entrySet example 


import java.util.*; 


public class MyClass 
{ 
public static void main(String[] args) 
if 
// Create a TreeMap object (implements Map): 
TreeMap tm = new TreeMap(); 


// Add some elements: 
tm.put("1","Sally Abolrous"); 
tm.put("3", "Craig Combel"); 
tm.put("5","Pille Mandla"); 


// Display the entry set of the object: 
System.out.println("The entry set is:\n" + tm.entrySet()); 


/* 

Output: 

The entry set is: 

[[1, Sally Abolrous], [3, Craig Combel], [5, Pille Mandla]] 
oh 


See Also 
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Map Interface 
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Map Members 
java.util Package 


Visual J# Reference 


Map.equals Method 


Checks if a specified element in a Map object is equal to a specified object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean equals( 
java.lang.Object c); 


Parameters 
Cc 


The element to compare to. 
Return Value 
true if the compared elements are the same; false otherwise. 


See Also 
Reference 

Map Interface 
Concepts 

Map Members 
java.util Package 
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Map.get Method 


Retrieves an element from a Map object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.Object get( 
java.lang.Object k); 


Parameters 
k 
The key of the element to be retrieved from the Map object. 
Return Value 
The object to be retrieved from the Map object. 
Example 
In this example, you create and initialize a TreeMap object, which implements Map, and then you display the element 


associated with the key "2." 


// Map-get1.jsl 
// Map.get example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Create a TreeMap object (implements Map): 
TreeMap tm = new TreeMap(); 
// Add some elements: 
tm.put("1", "Sally Abolrous"); 
tm.put("2","Craig Combel"); 
// Display the element that corresponds to the key #2: 
System.out.println("The element #2 is: " + tm.get("2")); 
} 
H 
/* 
Output: 
The element #2 is: Craig Combel 
*/ 
See Also 
Reference 
Map Interface 
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Map Members 
java.util Package 
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Map.hashCode Method 


Retrieves the hash code for a Map object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract int hashCode(); 


Return Value 

An integer that represents the hash code of the Map object. 

Example 

In the following example, you create and initialize a Hashtable object, which implements Map, and then you display the hash 


code of the object. 


// Map-hashcode1.jsl 
// Map.GetHashCode example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Create a Hashtable object (implements Map): 
Hashtable ht = new Hashtable(); 
// Add some elements: 
ht.put("1","Eve Kennedy") ; 
ht.put("2","Audrey Esteban"); 
ht.put("5","Emma Esteban"); 
// Display the hash code: 
System.out.println("The hash code is: " + ht.GetHashCode()); 
} 
} 
/* 
The hash code is: 1334170275 
*/ 
See Also 
Reference 
Map Interface 
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java.util Package 
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Map.isEmpty Method 


Checks if a Map object is empty. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean isEmpty(); 


Return Value 
true if the Map object is empty; false otherwise. 
Example 
In this example, you create and initialize a TreeMap object, and then you check if the object is empty. You clear the object and 
check again. The test in the latter case returns true. 
Code// Map-isEmpty1.jsl 
// Map.isEmpty example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Create a TreeMap object: 
TreeMap tm = new TreeMap(); 
// Add some elements: 
tm.put("3", "Sally Abolrous"); 
tm.put("2","Craig Combel"); 
tm.put("5","Pille Mandla"); 
// Check if the object is empty: 
System.out.println(tm.isEmpty()); 
// Clear the object: 
tm.clear(); 
// Check if the object is empty: 
System.out.println(tm.isEmpty()); 
} 
} 
/* 
Output 
false 
true 
*/ 
See Also 
Reference 
Map Interface 
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Map Members 
java.util Package 
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Map.keySet Method 


Retrieves the key values of the keys in a Map object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.util.Set keySet(); 


Return Value 

The set of the key entries in the Map object. 

Example 

In the following example, you create and initialize a Hashtable object, which implements Map, and then you display the keys 


stored in the object. 


// Map-keyset1.jsl 
// Map.keySet example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Create a Hashtable object (implements Map): 
Hashtable ht = new Hashtable(); 
// Add some elements: 
ht.put("1","Eve Kennedy"); 
ht.put("2","Audrey Esteban"); 
ht.put("5","Emma Esteban"); 
// Display the keys: 
System.out.println("The keys are: " + ht.keySet()); 
} 
} 
/* 
The keys are: [1, 2, 5] 
*/ 
See Also 
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Map.put Method 


Adds an element at a specific key entry to a Map object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.Object put( 
java.lang.Object k, 
java.lang.Object v); 


Parameters 
k 


The key entry at which the element is added. 


The element to be added. 
Return Value 
The element to be added to Map. 
Example 


In the following example, you create and initialize a HashMap object, which implements Map, and then you display the values 
stored in the object. 


// Map-put1.jsl 
// Map.put example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
iJ 
// Create a HashMap object (Implements Map): 
HashMap hm = new HashMap(); 
// Add some elements: 
hm.put("4","Eve Kennedy") ; 
hm.put("1","Isabella Abolrous"); 
hm.put("2","Emma Esteban"); 
// Display the values: 
System.out.println("The values are: " + hm.values()); 
} 
} 
/* 
The values are: [Isabella Abolrous, Emma Esteban, Eve Kennedy] 
arf 
See Also 
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java.util Package 


Visual J# Reference 


Map.putAll Method 


Copies all the elements from a specified map to the current Map object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract void putA1l1l( 
java.util.Map m); 


Parameters 
m 


The specified Map. 
Example 


In this example, you create and initialize a TreeMap object, and then you copy it to a HashMap object. Both objects implement 
the Map interface. 


// Map-putAll1.jsl 
// Map.putAll example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 
{ 
// Create a TreeMap object: 
TreeMap tm = new TreeMap(); 
// Create a HashMap object: 
HashMap ht = new HashMap(); 


// Add some elements to tm: 
tm.put( "1", "Sally Abolrous"); 
tm.put("2","Craig Combel"); 


// Copy tm to ht: 
ht.putAl1l(tm) ; 


// Display the element #2 in both objects: 

System.out.println("The element #2 in tm is: 
+ tm.get("2")); 

System.out.println("The element #2 in ht is: 
+ ht.get("2")); 


} 


/* 

Output: 

The element #2 in tm is: Craig Combel 
The element #2 in ht is: Craig Combel 
ar 


See Also 
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Map Members 
java.util Package 
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Map.remove Method 


Deletes an element associated with a specific key from a Map object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.Object remove( 
java.lang.Object k); 


Parameters 


k 
The key associated with the element to be removed from the Map object. 
Return Value 
The removed object. 
Example 
Description 


In this example, you create and initialize a TreeMap object, which implements Map, and then you remove one element from the 
object. 


// Map-rem1.jsl 
// Map.remove example 


import java.util.*; 


public class MyClass 
{ 


public static void main(String[] args) 


{ 
// Create a TreeMap object (implements Map): 
TreeMap tm = new TreeMap(); 


// Add some elements: 
tm.put("3","Sally Abolrous"); 
tm.put("2","Craig Combel"); 
tm.put("5","Pille Mandla"); 


// Remove an object: 
System.out.printlin("The following object has been removed: " + 
tm.remove("5")); 


I 


/* 
Output: 
The following object has been removed: Pille Mandla 


y 


See Also 
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Map.size Method 


Retrieves the number of the key-value mappings of a Map object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public abstract int size(); 





Return Value 
An integer that represents the number of key-value mappings of the Map object. 
Example 


In this example, you create and initialize a TreeMap object, which implements Map, and then you display the number of the 
key-value mappings of the object. 





// Map-size1.jsl 
// Map.size example 


import java.util.*; 


public class MyClass 
{ 
public static void main(String[] args) 
if 
// Create a TreeMap object: 
TreeMap tm = new TreeMap(); 


// Add some elements: 
tm.put("1", "Sally Abolrous"); 
tm.put("2","Craig Combel"); 
tm.put("3","Pille Mandla"); 


// Display the size of the TreeMap: 


System.out.println("The size is: " + tm.size()); 


/* 
Output: 
The size is: 3 


a 





See Also 
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java.util Package 





Visual J# Reference 


Map.values Method 


Retrieves the collection of values in a Map object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public abstract java.util.Collection values(); 





Return Value 

The collection of values in the Map object. 
Example 

See the example on put. 


See Also 
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Map.Entry Interface 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public interface java.util.Map.Entry 





See Also 

Concepts 

Map.Entry Members 
java.util Package 
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Map.Entry Members 


The following tables list the members exposed by the Map.Entry type. 


Public Methods 
Name Description 


equals 
hashCode 
getKey 


getValue 





setValue 











See Also 
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Map.Entry Methods 


Public Methods 
Name 





Description 





equals 





hashCode 





getKey 





getValue 





setValue 











See Also 
Reference 
Map.Entry Interface 
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java.util Package 
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Map.Entry.equals Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean equals( 
java.lang.Object e); 





Parameters 
e 


See Also 

Reference 
Map.Entry Interface 
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Map.Entry.hashCode Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract int hashCode(); 


See Also 

Reference 
Map.Entry Interface 
Concepts 

Map.Entry Members 
java.util Package 
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Map.Entry.getKey Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.Object getKey(); 


See Also 

Reference 
Map.Entry Interface 
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Map.Entry Members 
java.util Package 
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Map.Entry.getValue Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.Object getValue(); 


See Also 

Reference 
Map.Entry Interface 
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Map.Entry.setValue Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.Object setValue( 
java.lang.Object newVal); 


Parameters 
newVal 


See Also 
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MissingResourceException Class 


An exception thrown to indicate that a resource is missing. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public class java.util.MissingResourceException 
extends java. lang.RuntimeException 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.lang.RuntimeException 
java.util.MissingResourceException 


See Also 
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MissingResourceException Members 


An exception thrown to indicate that a resource is missing. 


The following tables list the members exposed by the MissingResourceException type. 


Public Constructors 





Name 


Description 





MissingResourceException 


Overloaded. Constructs a MissingResourceException object. 








Name 


HelpLink 


Public Properties (see also Protected Properties 





Description 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Name 


HResult 


Public Methods 


Protected Properties 


Description 


(inherited from Exception ) 








Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





getClassName 


Retrieves the class name of the missing resource that led to MissingResourceException. 





hashCode 


(inherited from Object ) 





getKey 


Retrieves the key of the missing resource that led to MissingResourceException. 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 





(inherited from Throwable ) 
(inherited from Throwable ) 
Overridden. Retrieves the data required to serialize a MissingResourceException object. 


(inherited from Object ) 








clone (inherited from Throwable ) 





printStackTrace Overloaded. (inherited from Throwable ) 


toString (inherited from Throwable ) 








Protected Methods 























Name Description 

finalize (inherited from Object ) 
See Also 

Reference 

MissingResourceException Class 
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MissingResourceException Constructor 


Constructs a MissingResourceException object. 


Overload List 
Name Description 


MissingResourceException (SerializationInfo, StreamingContext)|Constructs a MissingResourceException object during serializ 
ation. 





MissingResourceException (String, Exception) Constructs a MissingResourceException object with a specific 
text message and inner exception. 


MissingResourceException (String, String, String) Constructs a MissingResourceException object with specific in 
formation about the missing resource. 


MissingResourceException (String, String, String, Exception) Constructs a MissingResourceException object with specific in 
formation about the missing resource.. 














See Also 
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MissingResourceException Constructor (SerializationInfo, 
StreamingContext) 


Constructs a MissingResourceException object during serialization. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


protected java.util.MissingResourceException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information required for serializing an object. 
context 
The source or destination for the serialization. 


See Also 

Reference 
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MissingResourceException Constructor (String, Exception) 


Constructs a MissingResourceException object with a specific text message and inner exception. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.MissingResourceException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


The string that contains the message text. 
inner 
The inner exception that led to MissingResourceException. 


See Also 

Reference 
MissingResourceException Class 
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MissingResourceException Constructor (String, String, String) 


Constructs a MissingResourceException object with specific information about the missing resource. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.MissingResourceException( 
java.lang.String msg, 
java.lang.String className, 
java.lang.String key); 


Parameters 
msg 


The string that contains the message text. 
className 

The name of the resource class. 
key 

The key of the missing resource. 


See Also 

Reference 
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MissingResourceException Constructor (String, String, String, 
Exception) 


Constructs a MissingResourceException object with specific information about the missing resource.. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.MissingResourceException( 
java.lang.String msg, 
java.lang.String className, 
java.lang.String key, 
System.Exception inner); 


Parameters 
msg 
The string that contains the message text. 
className 
The name of the resource class. 
key 
The key of the missing resource. 
inner 
The inner exception that led to MissingResourceException. 


See Also 

Reference 
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MissingResourceException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





getClassName 


Retrieves the class name of the missing resource that led to MissingResourceException. 





hashCode 


getKey 


getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 


Protected Methods 


(inherited from Object ) 

Retrieves the key of the missing resource that led to MissingResourceException. 
(inherited from Throwable ) 

(inherited from Throwable ) 

Overridden. Retrieves the data required to serialize a MissingResourceException object. 
(inherited from Object ) 

(inherited from Throwable ) 

Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 
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Concepts 
java.util Package 





Visual J# Reference 


MissingResourceException.getClassName Method 


Retrieves the class name of the missing resource that led to MissingResourceException. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getClassName(); 


Return Value 
The class name of the missing resource. 


See Also 

Reference 
MissingResourceException Class 
Concepts 

MissingResourceException Members 
java.util Package 


Visual J# Reference 


MissingResourceException.getKey Method 


Retrieves the key of the missing resource that led to MissingResourceException. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getKey(); 


Return Value 
The key string of the missing resource. 


See Also 

Reference 
MissingResourceException Class 
Concepts 

MissingResourceException Members 
java.util Package 
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MissingResourceException.GetObjectData Method 


Retrieves the data required to serialize a MissingResourceException object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void GetObjectData( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information required for serializing the object. 
context 
The source or destination for the serialization. 


See Also 

Reference 
MissingResourceException Class 
Concepts 

MissingResourceException Members 
java.util Package 


Visual J# Reference 


MissingResourceException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 


MissingResourceException Class 


Concepts 
java.util Package 
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NoSuchElementException Class 


The exception that is thrown when attempting to access an element in a collection that does not exist. This exception is 
frequently thrown when attempting to perform an operation on an empty collection or when attempting to access past the end 
of the collection. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public class java.util.NoSuchElementException 
extends java.lang.RuntimeException 








Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.lang.RuntimeException 
java.util.NoSuchElementException 


See Also 

Concepts 

NoSuchElementException Members 
java.util Package 
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NoSuchElementException Members 


The exception that is thrown when attempting to access an element in a collection that does not exist. This exception is 
frequently thrown when attempting to perform an operation on an empty collection or when attempting to access past the end 


of the collection. 


The following tables list the members exposed by the NoSuchElementException type. 


Public Constructors 





Name 


Description 





NoSuchElementException 


Overloaded. Initializes a new instance of a NoSuchElementException object. 








Name 


Public Properties (see also Protected Properties 





Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 





Protected Properties 
Name 


HResult 


Public Methods 





Description 


(inherited from Exception ) 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


(inherited from Throwable ) 





getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 





(inherited from Throwable ) 
(inherited from Throwable ) 
(inherited from Object ) 

(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 








toString (inherited from Throwable ) 


Protected Methods 





Name Description 





finalize (inherited from Object ) 














See Also 

Reference 
NoSuchElementException Class 
Concepts 

java.util Package 
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NoSuchElementException Constructor 


Initializes a new instance of a NoSuchElementException object. 


Overload List 


Name Description 
NoSuchElementException () Initializes a new instance of a NoSuchElementException object. 
NoSuchElementException (String) Initializes a new instance of a NoSuchElementException object 


with the given message. 





NoSuchElementException (SerializationInfo, StreamingContext)|Initializes a new instance of a NoSuchElementException object 
during deserialization. 


NoSuchElementException (String, Exception) Initializes a new instance of a NoSuchElementException object 
with the given message and inner exception. 





See Also 

Reference 
NoSuchElementException Class 
Concepts 

NoSuchElementException Members 
java.util Package 
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NoSuchElementException Constructor () 


Initializes a new instance of a NoSuchElementException object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.NoSuchElementException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
NoSuchElementException Class 
Concepts 

NoSuchElementException Members 
java.util Package 
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NoSuchElementException Constructor (String) 


Initializes a new instance of a NoSuchElementException object with the given message. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.NoSuchElementException( 
java.lang.String s); 


Parameters 
Ss 


A message describing the exceptional condition. 


See Also 

Reference 
NoSuchElementException Class 
Concepts 

NoSuchElementException Members 
java.util Package 
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NoSuchElementException Constructor (SerializationInfo, 
StreamingContext) 


Initializes a new instance of a NoSuchElementException object during deserialization. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


protected java.util.NoSuchElementException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 

Reference 
NoSuchElementException Class 
Concepts 

NoSuchElementException Members 
java.util Package 
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NoSuchElementException Constructor (String, Exception) 


Initializes a new instance of a NoSuchElementException object with the given message and inner exception. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.NoSuchElementException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
Ss 


A message describing the exceptional condition. 
inner 
An inner exception that led to the NoSuchElementException object being thrown. 


See Also 

Reference 
NoSuchElementException Class 
Concepts 

NoSuchElementException Members 
java.util Package 
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NoSuchElementException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 

Reference 


NoSuchElementException Class 


Concepts 
java.util Package 
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NoSuchElementException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 


NoSuchElementException Class 


Concepts 
java.util Package 
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Observable Class 


Represents the observable object, which usually contains data. It can have one or more observers. An Observer object is an 
instance of a class that implements the Observer interface. When the data on the observable object changes, the observers can 
be notified through the update method, which passes the necessary information to the notifyObservers method. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public class java.util.Observable 
extends java.lang.Object 


Example 


The following example demonstrates the use of most of the methods on the Observable and Observer class. It creates a linked 


list on the observable object and the changes are sent to the observer object. 


// Observer-Observable general example 


import java.util.*; 


class MyClass implements Observer 


public void update(Observable o, Object arg) 


Object ob = (LinkedList)arg; 
System.out.println("The list contains: 


+ ob); 


public static void main(String[] args) 


{ 
} 
{ 
} 
} 


MyClass mc = new MyClass(); 

YourClass yc = new YourClass(); 

yc.addObserver (mc) ; 

System.out.println("Number of observers: " + 
yc.countObservers()); 


// Start watching: 
yc.Watch(); 


class YourClass extends Observable 


1 


void Watch() 


{ 


// Declare a linked list: 
LinkedList lList = new LinkedList(); 
lList.add("Sam") ; 


// Pass the info the observer: 
setChanged(); 
notifyObservers(lList); 


// Check for a change: 
System.out.println("Observable changed?: " + hasChanged()); 


// Add nother element: 
lList.add("Pam") ; 


// Send the new linked list information: 
setChanged(); 
notifyObservers(lList); 


} 
} 
/* 
Output: 


*/ 





Inheritance Hi 


// Set the new change: 
setChanged(); 


// Check for a change: 
System.out.println("Observable changed?: " + hasChanged()); 


Number of observers: 1 

The list contains: [Sam] 
Observable changed?: false 
The list contains: [Sam, Pam] 
Observable changed?: true 


erarchy 


java.lang.Object 


java.util.Observable 


See Also 
Concepts 


Observable Members 
java.util Package 
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Observable Members 


Represents the observable object, which usually contains data. It can have one or more observers. An Observer object is an 
instance of a class that implements the Observer interface. When the data on the observable object changes, the observers can 
be notified through the update method, which passes the necessary information to the notifyObservers method. 


The following tables list the members exposed by the Observable type. 


Public Constructors 





Name Description 





Observable Constructs a new Observable object. 





Public Methods 
Name Description 





addObserver [Adds an observer to the Observable object, if it is not already in the list. 





Causes the method hasChanged to return false, either because the current Observable object has not change 
d anymore or because the observer has been already notified of the last change. 


clearChanged 


countObservers 


deleteObserver 


deleteObservers 


Returns the number of observers for the current Observable object. 
Deletes a specific observer from the list of observers for the current Observable object. 


Deletes all the observers for the current Observable object. 


equals (inherited from Object) 
hashCode (inherited from Object) 
getClass (inherited from Object) 
hasChanged Checks if the current Observable object has changed. 


notifyObservers |Overloaded. 





setChanged Sets the status of the current Observable object as "changed." This will cause the hasChanged method to retu 
rn true. 
toString Overridden. Returns the string representation of the current Observable object. 








Protected Methods 
Name 





Description 


finalize (inherited from Object ) 





MemberwiseClone Performs a shallow copy of the object. 











See Also 
Reference 
Observable Class 
Concepts 
java.util Package 
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Observable Constructor 


Constructs a new Observable object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.util.Observable(); 





Example 

See the example on Observable. 

Remarks 

The default constructor initializes any fields to their default values. 


See Also 

Reference 
Observable Class 
Concepts 

Observable Members 
java.util Package 
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Observable Methods 


Public Methods 





Name 


Description 





addObserver 


Adds an observer to the Observable object, if it is not already in the list. 





clearChanged 


countObservers 


deleteObserver 


deleteObservers 


Causes the method hasChanged to return false, either because the current Observable object has not change 
d anymore or because the observer has been already notified of the last change. 


Returns the number of observers for the current Observable object. 
Deletes a specific observer from the list of observers for the current Observable object. 


Deletes all the observers for the current Observable object. 














equals (inherited from Object ) 
hashCode (inherited from Object ) 
getClass (inherited from Object ) 
hasChanged Checks if the current Observable object has changed. 





notifyObservers 


Overloaded. 





setChanged 


toString 


Sets the status of the current Observable object as "changed." This will cause the hasChanged method to retu 
rn true. 


Overridden. Returns the string representation of the current Observable object. 





Protected Methods 





Name 


Description 





finalize 


(inherited from Object ) 








MemberwiseClone 


Performs a shallow copy of the object. 





See Also 
Reference 


Observable Class 


Concepts 
java.util Package 
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Observable.addObserver Method 


Adds an observer to the Observable object, if it is not already in the list. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public synchronized void addObserver( 
java.util.Observer 0); 





Parameters 
O 


The Observer object to be added. 


Example 





See the example on Observable. 








See Also 

Reference 
Observable Class 
Concepts 

Observable Members 
java.util Package 
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Observable.clearChanged Method 


Causes the method hasChanged to return false, either because the current Observable object has not changed anymore or 
because the observer has been already notified of the last change. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


protected synchronized void clearChanged(); 


See Also 

Reference 
Observable Class 
Concepts 

Observable Members 
java.util Package 
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Observable.countObservers Method 


Returns the number of observers for the current Observable object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public synchronized int countObservers(); 





Return Value 
The number of observers for the current Observable object. 


Example 





See the example on Observable. 





See Also 

Reference 
Observable Class 
Concepts 

Observable Members 
java.util Package 
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Observable.deleteObserver Method 


Deletes a specific observer from the list of observers for the current Observable object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized void deleteObserver( 
java.util.Observer 0); 


Parameters 
oO 


The Observer object to be deleted. 


See Also 

Reference 
Observable Class 
Concepts 

Observable Members 
java.util Package 
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Observable.deleteObservers Method 


Deletes all the observers for the current Observable object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized void deleteObservers(); 


See Also 

Reference 
Observable Class 
Concepts 

Observable Members 
java.util Package 
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Observable.hasChanged Method 


Checks if the current Observable object has changed. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public synchronized boolean hasChanged(); 





Return Value 
true if the object has changed; false otherwise. 


Example 





See the example on Observable. 





See Also 

Reference 
Observable Class 
Concepts 

Observable Members 
java.util Package 
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Observable.notifyObservers Method 


Overload List 
Name Description 








Observable.notifyObservers () Notifies all the observers of the current Observable object if a change has occurred to thi 














See Also 

Reference 
Observable Class 
Concepts 

Observable Members 
java.util Package 
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Observable.notifyObservers Method () 


Notifies all the observers of the current Observable object if a change has occurred to this object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public void notifyObservers(); 


Example Ce 


See the example on Observable. 








See Also 

Reference 
Observable Class 
Concepts 

Observable Members 
java.util Package 
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Observable.notifyObservers Method (Object) 


Notifies all the observers of the current Observable object if a change has occurred to this object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void notifyObservers( 
java.lang.Object arg); 


Parameters 
arg 


An argument describing the change to be notified. 
Example 


See the example on Observable. 


See Also 

Reference 
Observable Class 
Concepts 

Observable Members 
java.util Package 
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Observable.setChanged Method 


Sets the status of the current Observable object as "changed." This will cause the hasChanged method to return true. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





protected synchronized void setChanged(); 


Example —_, 


See the example on Observable. 








See Also 

Reference 
Observable Class 
Concepts 

Observable Members 
java.util Package 
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Observer Interface 


An interface that enables the implementing class to be notified of any changes in the observable objects. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public interface java.util.Observer 


Example 


The following example demonstrates the use of most of the methods on the Observable and Observer class. It creates a linked 
list on the observable object and the changes are sent to the observer object. 


// Observer-Observable general example 
import java.util.*; 


class MyClass implements Observer 


{ 
public void update(Observable o, Object arg) 
{ 
Object ob = (LinkedList)arg; 
System.out.println("The list contains: " + ob); 
} 
public static void main(String[] args) 
{ 
MyClass mc = new MyClass(); 
YourClass yc = new YourClass(); 
yc.addObserver (mc) ; 
System.out.printin("Number of observers: " + 
yc.countObservers()); 
// Start watching: 
yc.Watch(); 
} 
} 


class YourClass extends Observable 
{ 
void Watch() 
{ 
// Declare a linked list: 
LinkedList lList = new LinkedList(); 
lList.add("Sam") ; 


// Pass the info the observer: 
setChanged(); 
notifyObservers(lList); 


// Check for a change: 
System.out.println("Observable changed?: " + hasChanged()); 


// Add nother element: 
lList.add("Pam") ; 


// Send the new linked list information: 
setChanged(); 
notifyObservers(lList); 


// Set the new change: 
setChanged(); 


// Check for a change: 
System.out.println("Observable changed?: " + hasChanged()); 


} 
} 
/* 
Output: 


Number of observers: 1 

The list contains: [Sam] 
Observable changed?: false 
The list contains: [Sam, Pam] 
Observable changed?: true 

=/ 











See Also 

Concepts 

Observer Members 
java.util Package 
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Observer Members 


An interface that enables the implementing class to be notified of any changes in the observable objects. 


The following tables list the members exposed by the Observer type. 


Public Methods 

















Name Description 

update Called to update the Observer on a change in the observable object. 
See Also 

Reference 

Observer Interface 

Concepts 


java.util Package 
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Observer Methods 


Public Methods 

















Name Description 

update Called to update the Observer on a change in the observable object. 
See Also 

Reference 

Observer Interface 

Concepts 


java.util Package 
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Observer.update Method 


Called to update the Observer on a change in the observable object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public abstract void update( 
java.util.Observable o, 
java.lang.Object arg); 





Parameters 
O 


The observable object. 
arg 


A parameter passed to the notifyObservers method on the Observable object. 


Example 


See the example on Observer. 





See Also 

Reference 
Observer Interface 
Concepts 

Observer Members 
java.util Package 


Visual J# Reference 


Properties Class 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public class Properties extends Hashtable 





Inheritance Hierarchy 
java.lang.Object 
java.util.Dictionary 
java.util.Hashtable 
java.util.Properties 
java.security.Provider 


See Also 

Concepts 

Properties Members 
java.util Package 
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Properties Members 


The following tables list the members exposed by the Properties type. 


Public Constructors 
Name 


Properties 





Public Fields 





Name Description 





defaults 








Public Methods 











Name Description 
clear Clears a Hashtable object. (inherited from Hashtable) 
contains Checks for a specific element in a Hashtable object. (inherited from Hashtable) 





containsKey Checks for a specific key in a Hashtable object. (inherited from Hashtable) 





containsValue |Checks for a specific value in a Hashtable object. (inherited from Hashtable) 

















elements Returns an enumeration that contains the values in a Hashtable object. (inherited from Hashtable) 
entrySet Retrieves the set of mappings contained in a Hashtable object. (inherited from Hashtable) 

equals Overridden. 

get Retrieves an element associated with a specified key in a Hashtable object. (inherited from Hashtable) 
hashCode Returns the hash code of a Hashtable object. (inherited from Hashtable) 





getProperty Overloaded. 

















getClass (inherited from Object ) 

isEmpty Checks if a Hashtable object is empty. (inherited from Hashtable) 

keys Returns an enumeration of the keys in a Hashtable object. (inherited from Hashtable) 
keySet Returns the key set in a Hashtable object. (inherited from Hashtable) 

list Overloaded. 

load 

propertyNames 


put Adds an element at a specific key entry to a Hashtable object. (inherited from Hashtable) 


























putAll Copies all the elements from a specified map to the current Hashtable object. (inherited from Hashtable) 
rehash Rehashes the content of the Hashtable into a larger table. (inherited from Hashtable) 
remove Removes a key/element pair from a Hashtable object. (inherited from Hashtable) 

save Obsolete. 

setProperty 

size Returns the size (number of buckets) of a Hashtable object. (inherited from Hashtable) 
store 

toString Generates the string representation of a Hashtable object. (inherited from Hashtable) 
values Returns the set of elements in a Hashtable object. (inherited from Hashtable) 
Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 

Properties Class 

Concepts 


java.util Package 
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Properties Fields 


Public Fields 





Name Description 





defaults 














See Also 
Reference 
Properties Class 
Concepts 
java.util Package 
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Properties.defaults Field 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





protected java.util.Properties defaults; 





See Also 

Reference 
Properties Class 
Concepts 

Properties Members 
java.util Package 
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Properties Constructor 


Overload List 





Name Description 





Properties () 





Properties (Properties) 











See Also 
Reference 
Properties Class 
Concepts 

Properties Members 
java.util Package 
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Properties Constructor () 


Initializes a new instance of the Properties Class . 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.util.Properties(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
Properties Class 
Concepts 

Properties Members 
java.util Package 
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Properties Constructor (Properties) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Properties ( 
java.util.Properties defaults); 


Parameters 
defaults 


See Also 

Reference 
Properties Class 
Concepts 

Properties Members 
java.util Package 
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Properties Methods 


Public Methods 



































Name Description 

clear Clears a Hashtable object. (inherited from Hashtable ) 

contains Checks for a specific element in a Hashtable object. (inherited from Hashtable ) 

containsKey Checks for a specific key in a Hashtable object. (inherited from Hashtable ) 

containsValue Checks for a specific value in a Hashtable object. (inherited from Hashtable ) 

elements Returns an enumeration that contains the values in a Hashtable object. (inherited from Hashtable ) 
entrySet Retrieves the set of mappings contained in a Hashtable object. (inherited from Hashtable ) 

equals Overridden. 

get Retrieves an element associated with a specified key in a Hashtable object. (inherited from Hashtable ) 
hashCode Returns the hash code of a Hashtable object. (inherited from Hashtable ) 

getProperty Overloaded. 

getClass (inherited from Object ) 

isEmpty Checks if a Hashtable object is empty. (inherited from Hashtable ) 

keys Returns an enumeration of the keys in a Hashtable object. (inherited from Hashtable ) 

keySet Returns the key set in a Hashtable object. (inherited from Hashtable ) 

list Overloaded. 

load 

propertyNames 

put Adds an element at a specific key entry to a Hashtable object. (inherited from Hashtable ) 

putAll Copies all the elements from a specified map to the current Hashtable object. (inherited from Hashtable ) 
rehash Rehashes the content of the Hashtable into a larger table. (inherited from Hashtable ) 

remove Removes a key/element pair from a Hashtable object. (inherited from Hashtable ) 

save Obsolete. 

setProperty 

size Returns the size (number of buckets) of a Hashtable object. (inherited from Hashtable ) 











store 





toString Generates the string representation of a Hashtable object. (inherited from Hashtable ) 





values Returns the set of elements in a Hashtable object. (inherited from Hashtable ) 





Protected Methods 
Name 


finalize (inherited from Object ) 








See Also 
Reference 
Properties Class 
Concepts 
java.util Package 
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Properties.equals Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean equals( 


java.lang.Object obj); 





Parameters 


obj 


See Also 

Reference 
Properties Class 
Concepts 

Properties Members 
java.util Package 
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Properties.getProperty Method 


Overload List 





Name Description 





Properties.getProperty (String) 





Properties.getProperty (String, String) 











See Also 
Reference 
Properties Class 
Concepts 

Properties Members 
java.util Package 
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Properties.getProperty Method (String) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getProperty( 
java.lang.String key); 


Parameters 


key 


See Also 

Reference 
Properties Class 
Concepts 

Properties Members 
java.util Package 


Visual J# Reference 


Properties.getProperty Method (String, String) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String getProperty( 
java.lang.String key, 
java.lang.String defaultValue) ; 


Parameters 


key 
defaultValue 


See Also 

Reference 
Properties Class 
Concepts 

Properties Members 
java.util Package 
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Properties.list Method 


Overload List 





Name 


Description 





Properties.list (PrintStream) 





Properties.list (PrintWriter) 











See Also 
Reference 
Properties Class 
Concepts 

Properties Members 
java.util Package 
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Properties.list Method (PrintStream) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void list( 
java.io.PrintStream out); 


Parameters 
out 


See Also 

Reference 
Properties Class 
Concepts 

Properties Members 
java.util Package 
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Properties.list Method (PrintWriter) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void list( 
java.io.Printwriter out); 


Parameters 
out 


See Also 

Reference 
Properties Class 
Concepts 

Properties Members 
java.util Package 
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Properties.load Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized void load( 
java.io.InputStream pin) throws java.io. IOException; 


Parameters 


pin 


See Also 

Reference 
Properties Class 
Concepts 

Properties Members 
java.util Package 


Visual J# Reference 


Properties.propertyNames Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Enumeration propertyNames(); 


See Also 

Reference 
Properties Class 
Concepts 

Properties Members 
java.util Package 
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Properties.save Method 


NOTE: This Method is now obsolete. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized void save( 
java.io.OutputStream pout, 
java.lang.String header); 


Parameters 
pout 


header 


See Also 

Reference 
Properties Class 
Concepts 

Properties Members 
java.util Package 
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Properties.setProperty Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object setProperty( 
java.lang.String key, 
java.lang.String val); 


Parameters 


key 
val 


See Also 

Reference 
Properties Class 
Concepts 

Properties Members 
java.util Package 
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Properties.store Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized void store( 
java.io.OutputStream pout, 
java.lang.String header) throws java.io. IOException; 


Parameters 
pout 


header 


See Also 

Reference 
Properties Class 
Concepts 

Properties Members 
java.util Package 
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PropertyResourceBundle Class 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public class java.util.PropertyResourceBundle 
extends java.util.ResourceBundle 


Inheritance Hierarchy 

java.lang.Object 
java.util.ResourceBundle 
java.util.PropertyResourceBundle 


See Also 

Concepts 

PropertyResourceBundle Members 
java.util Package 
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PropertyResourceBundle Members 


The following tables list the members exposed by the PropertyResourceBundle type. 


Public Constructors 
Name 


PropertyResourceBundle 





Public Fields 





Name Description 





parent (inherited from ResourceBundle) 





Public Methods 






































Name Description 

equals (inherited from Object ) 

hashCode (inherited from Object ) 

getKeys Overridden. 

getObject (inherited from ResourceBundle) 
getString (inherited from ResourceBundle) 
getStringArray (inherited from ResourceBundle) 
getClass (inherited from Object ) 
handleGetObject Overridden. 

clone (inherited from ResourceBundle) 
setParent (inherited from ResourceBundle) 
toString (inherited from ResourceBundle) 








Protected Methods 


Name Description 


finalize (inherited from Object ) 








See Also 

Reference 
PropertyResourceBundle Class 
Concepts 

java.util Package 
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PropertyResourceBundle Fields 


Public Fields 

















Name Description 

parent (inherited from ResourceBundle) 
See Also 

Reference 

PropertyResourceBundle Class 

Concepts 


java.util Package 


Visual J# Reference 


PropertyResourceBundle Constructor 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.PropertyResourceBundle( 
java.io.InputStream stream) throws java.io. IOException; 


Parameters 
stream 


See Also 

Reference 
PropertyResourceBundle Class 
Concepts 

PropertyResourceBundle Members 
java.util Package 
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PropertyResourceBundle Methods 


Public Methods 















































Name Description 

equals (inherited from Object ) 

hashCode (inherited from Object ) 

getKeys Overridden. 

getObject (inherited from ResourceBundle) 
getString (inherited from ResourceBundle) 
getStringArray (inherited from ResourceBundle) 
getClass (inherited from Object ) 
handleGetObject Overridden. 

clone (inherited from ResourceBundle) 
setParent (inherited from ResourceBundle) 
toString (inherited from ResourceBundle) 
Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 

PropertyResourceBundle Class 

Concepts 


java.util Package 
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PropertyResourceBundle.getKeys Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Enumeration getKeys(); 


See Also 

Reference 
PropertyResourceBundle Class 
Concepts 

PropertyResourceBundle Members 
java.util Package 
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PropertyResourceBundle.handleGetObject Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final java.lang.Object handleGetObject( 
java.lang.String key); 


Parameters 


key 


See Also 

Reference 
PropertyResourceBundle Class 
Concepts 

PropertyResourceBundle Members 
java.util Package 
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Random Class 


Contains methods to obtain various sorts of random data, such as integers, floats, and other primitives. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public class java.util.Random 
extends java.lang.Object 
implements java.io.Serializable, System.Runtime.Serialization.ISerializable 


Example 

The following example shows how to generate random values of type boolean, byte[], double, float, Gaussian, int, and long. 
// random_overview.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
// Get the current time. 
Date date = new Date(); 
long time = date.getTime(); 
Random r = new Random(); 
// Initialize the random number generator using the 
// time from above. 
r.setSeed(time) ; 
// Generate various types of random data. 
System.out.println("boolean: " + r.nextBoolean()); 
byte[] bytes = new byte[5]; 
r.nextBytes (bytes); 
System.out.print("byte[]: "); 
for (int j = @; j < bytes.length; j++) 
{ 
System.out.print(bytes[j] + " "); 
} 
System.out.println(); 
System.out.println("double: " + r.nextDouble()); 
System.out.printin("float: " + r.nextFloat()); 
System.out.println("Gaussian: " + r.nextGaussian()); 
System.out.printin("int: " + r.nextInt()); 
System.out.printin("long: " + r.nextLong()); 
} 
} 
/* 
Output: 


boolean: false 

byte[]: 10@ 127 2@ 91 39 
double: 0.506746074738395 
float: @.174197257 

Gaussian: -1.1872467339778563 
int: -722563198 

long: -4822180756670951982 

= 


Inheritance Hierarchy 
java.lang.Object 
java.util.Random 
java.security.SecureRandom 


See Also 

Concepts 

Random Members 
java.util Package 
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Random Members 


Contains methods to obtain various sorts of random data, such as integers, floats, and other primitives. 


The following tables list the members exposed by the Random type. 


Public Constructors 





Name 


Description 





Random 





Overloaded. Initializes a new instance of a Random object. 





Public Methods 

















Name Description 

equals (inherited from Object ) 

hashCode (inherited from Object ) 

GetObjectData Serializes the members of a Random object. 

getClass (inherited from Object ) 

next Generates a random integer containing the number of bits specified. 





nextBoolean 


Generates a random boolean value. 











nextBytes Generates a random array of signed bytes. 
nextDouble Generates a random double value between 0 and 1. 
nextFloat Generates a random float value between 0 and 1. 





nextGaussian 


Generates a random Gaussian value. 














nextint Overloaded. Generates a random int value. 

nextLong Generates a random long value. 

setSeed Sets the seed used to initialize the random number generator. 
toString Overridden. Displays a human readable summary of a Random object. 





Name 


finalize 


Protected Methods 





Description 


(inherited from Object ) 








MemberwiseClone 


Performs a shallow copy of the object. 





See Also 
Reference 
Random Class 
Concepts 


java.util Package 





Visual J# Reference 


Random Constructor 


Initializes a new instance of a Random object. 


Overload List 





Name Description 

Random () Initializes a new instance of a Random object. 

Random (long) Initializes a new instance of a Random object with the given seed. 
Random (SerializationInfo, StreamingContext) Initializes a new instance of a Random object during deserialization. 
See Also 

Reference 

Random Class 

Concepts 


Random Members 
java.util Package 





Visual J# Reference 


Random Constructor () 


Initializes a new instance of a Random object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.util.Random(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 
Reference 
Random Class 
Concepts 

Random Members 
java.util Package 
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Random Constructor (Int64) 


Initializes a new instance of a Random object with the given seed. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Random( 
long seed); 


Parameters 
seed 


The seed used to initialize the random number generator. 


See Also 
Reference 
Random Class 
Concepts 

Random Members 
java.util Package 
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Random Constructor (SerializationInfo, StreamingContext) 


Initializes a new instance of a Random object during deserialization. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


protected java.util.Random( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


The information needed to serialize an object. 
context 
The source or destination for the serialization stream. 


See Also 
Reference 
Random Class 
Concepts 

Random Members 
java.util Package 
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Random Methods 


Public Methods 




















nextBoolean 


nextGaussian 


Name Description 

equals (inherited from Object ) 

hashCode (inherited from Object ) 

GetObjectData Serializes the members of a Random object. 

getClass (inherited from Object ) 

next Generates a random integer containing the number of bits specified. 


Generates a random boolean value. 


nextBytes Generates a random array of signed bytes. 
nextDouble Generates a random double value between 0 and 1. 
nextFloat Generates a random float value between 0 and 1. 


Generates a random Gaussian value. 


nextint Overloaded. Generates a random int value. 

nextLong Generates a random long value. 

setSeed Sets the seed used to initialize the random number generator. 
toString Overridden. Displays a human readable summary of a Random object. 


Protected Methods 





Name 


Description 





finalize 


(inherited from Object ) 








MemberwiseClone 


Performs a shallow copy of the object. 





See Also 
Reference 
Random Class 
Concepts 


java.util Package 
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Random.GetObjectData Method 


Serializes the members of a Random object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void GetObjectData( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


Contains all the information used to serialize an object. 
context 
Specifies the source or destination for the serialization process. 


See Also 
Reference 
Random Class 
Concepts 

Random Members 
java.util Package 
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Random.next Method 


Generates a random integer containing the number of bits specified. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


protected synchronized int next( 
int bits); 


Parameters 
bits 


The length of the integer to be generated in bits. This value must be greater than or equal to 1 and less than or equal to 32. 
Return Value 
A random integer between 0 and 2“bits -1. 


See Also 
Reference 
Random Class 
Concepts 

Random Members 
java.util Package 
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Random.nextBoolean Method 


Generates a random boolean value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean nextBoolean(); 


Return Value 

A random boolean value (either true or false). 

Example 

The following example prints out 10 random boolean values. 
// random_nextboolean.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
// Get the current time. 
Date date = new Date(); 
long time = date.getTime(); 
// Initialize the random number generator using the 
// time from above. 
Random r = new Random(time) ; 
// Generate 18 random Boolean values. 
for (int i = @; i < 10; i++) 
{ 
System.out.println(r.nextBoolean()); 
ie 
} 
i; 
/ * 
Output: 
false 
true 
true 
true 
false 
false 
true 
false 
true 
true 
a4 
See Also 
Reference 
Random Class 
Concepts 


Random Members 
java.util Package 
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Random.nextBytes Method 


Generates a random array of signed bytes. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void nextBytes( 
byte[] bytes); 


Parameters 


bytes 
The array to be populated with random signed bytes. 
Example 


The following example prints out 10 random arrays of byte values. 


// random_nextbytes.jsl 
import java.util.*; 
public class Program 


public static void main(String[] args) 
{ 

// Get the current time. 

Date date = new Date(); 

long time = date.getTime(); 


// Initialize the random number generator using the 
// time from above. 
Random r = new Random(time) ; 


// Generate 1@ random arrays of 5 bytes. 
byte[] bytes = new byte[5]; 
for (int i = 0; i < 10; i++) 
{ 
r.nextBytes (bytes); 
for (int j = 0; j < bytes.length; j++) 
{ 


System.out.print(bytes[j] + " "); 


} 
System.out.println(); 


} 


/* 

Output: 

70 -21 72 -85 78 
111 57 -82 -78 -87 
99 -104 -5 -62 81 
59 61 75 38 -30 
-14 45 -46 -36 -39 
83 -11 -80 123 33 
4 -5@ -122 -121 -128 
-65 66 -32 76 -93 
48 -5 40 69 -15 
-80 6 -26 -25 51 

ad | 


See Also 
Reference 
Random Class 
Concepts 

Random Members 
java.util Package 
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Random.nextDouble Method 


Generates a random double value between 0 and 1. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public double nextDouble(); 


Return Value 
A random double value between 0 and 1. 
Example 


The following example prints out 10 random double values. 


// random_nextdouble.jsl 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Get the current time. 
Date date = new Date(); 
long time = date.getTime(); 


// Initialize the random number generator using the 
// time from above. 
Random r = new Random(time) ; 


// Generate 18 random doubles. 
for (int i = @; i < 10; i++) 


{ 
} 


System.out.println(r.nextDouble()); 


} 


/* 

Output: 
@.4198760781716504 
-47874095431748742 
-95940806165933323 
.20391668127336116 
-53872371526715213 
.57789881865073889 
-36308423397158118 
- 30986392774496274 
-815240298456572 

. 29822636217031273 
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See Also 
Reference 
Random Class 
Concepts 

Random Members 
java.util Package 
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Random.nextFloat Method 


Generates a random float value between 0 and 1. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public float nextFloat(); 


Return Value 
A random float value between 0 and 1. 
Example 


The following example prints out 10 random float values. 


// random_nextfloat.js1 
import java.util.*; 


public class Program 


{ 


public static void main(String[] args) 


A 


// Get the current time. 
Date date = new Date(); 
long time = date.getTime(); 


// Initialize the random number generator using the 
// time from above. 
Random r = new Random(time) ; 


// Generate 10 random floats. 
for (int i = @; i < 10; i++) 


{ 
} 


System.out.printin(r.nextFloat()); 


} 


/* 

Output: 
@.6807229 

. 271337152 
- 0456498861 
424616158 
145857215 
. 313717842 
. 793788552 
- 0299280882 
.9014773 

. 9284169316 
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See Also 
Reference 
Random Class 
Concepts 

Random Members 
java.util Package 
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Random.nextGaussian Method 


Generates a random Gaussian value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized double nextGaussian(); 


Return Value 
A random Gaussian value. 
Example 


The following example prints out 10 random Gaussian values. 


// random_nextgaussian.jsl 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Get the current time. 
Date date = new Date(); 
long time = date.getTime(); 


// Initialize the random number generator using the 
// time from above. 
Random r = new Random(time) ; 


// Generate 1@ random Gaussian values. 
for (int i = @; i < 10; i++) 


{ 
} 


System.out.println(r.nextGaussian()); 


} 


/* 

Output: 
@.14357387227838234 
-@.046254647058384474 
1.8878794717808312 
-@.453012430053396 
-1.3389395194956137 
-1.5308781476352151 
-1.4203675170816268 
-1.9396826969279308 
@.55111333173309363 
@.9477179313359444 
*/ 


Remarks 


The nextGaussian method generates Gaussian numbers with a mean of 0.0 and a standard deviation of 1.0. The algorithm is 
based on the polar form of the Box-Muller Transformation applied to uniformly distributed random numbers. 


See Also 
Reference 
Random Class 


Concepts 
Random Members 
java.util Package 
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Random.nextint Method 


Generates a random int value. 


Overload List 


Random.nextint () Generates a random int value. 





Random.nextint (int) Generates a random int value between 0 and n. 


See Also 
Reference 
Random Class 
Concepts 

Random Members 
java.util Package 
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Random.nextint Method () 


Generates a random int value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public int nextInt(); 


Return Value 
A random int value. 
Example 


The following example prints out 10 random int values. 
// random_nextint.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
// Get the current time. 
Date date = new Date(); 
long time = date.getTime(); 
// Initialize the random number generator using the 
// time from above. 
Random r = new Random(time) ; 
// Generate 18 random ints. 
for (int i = @; i < 10; i++) 
{ 
System.out.println(r.nextInt()); 
ie 
} 
i; 
/* 
Output: 
-694884771 
-599535625 
1085797709 
-713459955 
-634827481 
-1861079132 
-972042854 
-1974631783 
-1800648982 
-195619644 
*/ 
See Also 
Reference 
Random Class 
Concepts 


Random Members 
java.util Package 
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Random.nextint Method (Int32) 


Generates a random int value between 0 and n. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public int nextInt( 
int n); 


Parameters 
n 
The maximum value for the int to be generated. This value must be between 0 and java.lang.Integer.MAX_INTEGER. 
Return Value 
A random int value between 0 and n. 
Example 


The following example prints out 10 random int values less than 1,000,000. 
// random_nextint_2.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
// Get the current time. 
Date date = new Date(); 
long time = date.getTime(); 
// Initialize the random number generator using the 
// time from above. 
Random r = new Random(time) ; 
// Generate 180 random ints less than 1,000,000. 
for (int i = @; i < 10; i++) 
{ 
System.out.println(r.nextInt (1000008) ) ; 
} 
} 
} 
/* 
Output: 
285684 
798051 
635022 
148892 
525169 
461856 
908004 
282498 
834215 
987625 
vf 
See Also 


Reference 


Random Class 
Concepts 

Random Members 
java.util Package 
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Random.nextLong Method 


Generates a random long value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public long nextLong(); 


Return Value 
A random long value. 
Example 


The following example prints out 10 random long values. 


// random_nextlong.jsl 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Get the current time. 
Date date = new Date(); 
long time = date.getTime(); 


// Initialize the random number generator using the 
// time from above. 
Random r = new Random(time) ; 


// Generate 1@ random longs. 
for (int i = @; i < 10; i++) 


{ 
} 


System.out.println(r.nextLong()); 


} 


/* 

Output: 
2768182117229783821 
3837250559113071772 
-8017095318783076180 
-8447983171381820751 
-1501838064363879837 
787972653359279082 
-4721216399848929119 
1444225638129320913 
6145099151853620487 
4389531239905850113 
*/ 


See Also 
Reference 
Random Class 
Concepts 

Random Members 
java.util Package 
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Random.setSeed Method 


Sets the seed used to initialize the random number generator. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized void setSeed( 
long seed); 


Parameters 
seed 


The seed used to initialize the random number generator. 
Example 
The following example shows how to initialize the random number generator using the current time. 
// random_setseed.jsl 
import java.util.*; 
public class Program 


public static void main(String[] args) 


{ 
// Get the current time. 
Date date = new Date(); 
long time = date.getTime(); 
Random r = new Random(); 
// Initialize the random number generator using the 
// time from above. 
r.setSeed(time) ; 
} 
} 
See Also 
Reference 
Random Class 
Concepts 


Random Members 
java.util Package 
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Set Interface 


Provides a set of objects that implements the Collection interface. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public interface java.util.Set 
extends java.util.Collection 





Remarks 
This interface is implemented by collection classes such as HashSet, TreeSet. 


See Also 
Concepts 

Set Members 
java.util Package 
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Set Members (J#) 


Provides a set of objects that implements the Collection interface. 


The following tables list the members exposed by the Set type. 


Public Methods 

















Name Description 

add Adds the given element to a Set and returns false if the object can not be added. 
addaAll Adds all elements from given collection into a Set. 

clear Removes all the elements from a Set object. 

contains Checks if a Set object contains a specific element. 


containsAll —|Checks if a Set object contains all the elements in a specified collection. 
equals Checks for equality between a specified element and the current element in a Set object. 


hashCode Retrieves the hash code for a Set object. 








isEmpty Checks if a Set object is empty. 

iterator Provides an iterator over a Set object. 

remove Deletes an element from a Set object. 

removeAll Deletes all elements of a specified collection from a Set object. 
retainAll Deletes all elements of the Set that are not contained in specified collection. 
size Retrieves the number of elements in a Set. 

toArray Overloaded. Converts the Set object to an array. 

See Also 

Reference 

Set Interface 

Concepts 


java.util Package 
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Set Methods 


Public Methods 


























Name Description 

add Adds the given element to a Set and returns false if the object can not be added. 
addAll Adds all elements from given collection into a Set. 

clear Removes all the elements from a Set object. 

contains Checks if a Set object contains a specific element. 

containsAll —|Checks if a Set object contains all the elements in a specified collection. 

equals Checks for equality between a specified element and the current element in a Set object. 
hashCode Retrieves the hash code for a Set object. 

isEmpty Checks if a Set object is empty. 

iterator Provides an iterator over a Set object. 

remove Deletes an element from a Set object. 

removeAll Deletes all elements of a specified collection from a Set object. 

retainAll Deletes all elements of the Set that are not contained in specified collection. 
size Retrieves the number of elements in a Set. 

toArray Overloaded. Converts the Set object to an array. 

See Also 

Reference 

Set Interface 

Concepts 


java.util Package 
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Set.add Method 


Adds the given element to a Set and returns false if the object can not be added. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean add( 


java.lang.Object e); 
| 


Parameters 
e 


The object to be added to the Set. 
Return Value 
true if the object was successfully added; false otherwise. 
Example 
In this example, you create a HashSet object, which implements the Set interface. Then you add some elements to the set and 


display it. 


// Set-add1.jsl 
// Set.add example 
import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
ii 
// Create a HashSet object: 
Set hs = new HashSet(); 
Integer x = new Integer(22); 
Double y = new Double(2.45); 
// Add some elements to the HashSet object: 
System.out.printin(hs.add(x) + ", " + hs.add(y)); 
// Display the HashSet object: 
System.out.println(hs) ; 
} 
Hy 
/* 
Output 
true, true 
[2.45,22] 
ah 
Remarks 


Throws UnSupportedOperationException if this method is not supported by the implementing class of this interface. 


See Also 
Reference 

Set Interface 
Concepts 

Set Members 
java.util Package 
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Set.addAll Method 


Adds all elements from given collection into a Set. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean addA11( 
java.util.Collection c); 


Parameters 
c 
The name of the collection. 
Return Value 
true if the elements were inserted successfully; false otherwise. 
Example 
In this example, you declare a HashSet object, hs, object and a LinkedList object, Il. You then add some elements to II and copy 


it to hs. When you display hs, you get the same elements as those of Il. 


// Set-addA1.jsl 
// Set.addAll example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Create a HashSet and LinkedList objects: 
Set hs = new HashSet(); 
LinkedList 11 = new LinkedList(); 
// Add some elements to hs: 
ll.add("My Node"); 
ll.add( "Your Node"); 
ll.add(null); 
ll.add(new Integer(55)); 
// Copy 11 to hs and display hs: 
if(hs.addAl1(11)==true) 
System.out.println(hs) ; 
} 
} 
/* 
Output: 
[null, My Node, 55, Your Node] 
*/ 
Remarks 


Throws UnsupportedOperationException if this method is not supported by the implementing class of this interface. 


See Also 
Reference 

Set Interface 
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Set Members 
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Set.clear Method 


Removes all the elements from a Set object 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public abstract void clear(); 





Example 


In this example, you create a hash set, add some elements to it and then clear it. You display the set before and after clearing. 














// Set-clear.jsl 
// Set.clear example 
import java.util.*; 
public class MyClass 
{ 
public static void main(String[] args) 
{ 
// Create a HashSet object: 
Set hs = new HashSet(); 
Integer x = new Integer(22); 
Double y = new Double(2.45); 
// Add some elements: 
hs.add(x); 
hs.add(y); 
// Display the HashSet object: 
System.out.println(hs) ; 
// Clear the HashSet: 
hs.clear(); 
// Display the HashSet object after clearing: 
System.out.println(hs) ; 
} 
} 
/* 
Output 
[22, 2.45] 
[] 
m/f 
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Set.contains Method 


Checks if a Set object contains a specific element. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean contains( 
java.lang.Object e); 


Parameters 
e 
The element checked for. 
Return Value 
true if the object exists in Set; false otherwise. 
Example 
In this example, you create and initialize a hash set object, and then you check to see if the set contains a specified element. 


// Set-con1.jsl 
// Set.contains example 


import java.util.*; 


public class MyClass 


4 
public static void main(String[] args) 
{ 
// Create a HashSet object: 
Set hs = new HashSet(); 
// Add some elements: 
hs.add("My Node"); 
hs.add("Your Node"); 
hs.add(nul11); 
hs.add(new Integer(55)); 
// Check if "My Node" is in the list: 
if(hs.contains("My Node") ) 
System.out.println( 
"The object \"My Node\" is in the list."); 
} 
} 
/ * 
Output: 
The object "My Node" is in the list. 
m/f 
See Also 
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Set.containsAll Method 


Checks if a Set object contains all the elements in a specified collection. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean containsA11( 
java.util.Collection c); 


Parameters 
Cc 


The name of the collection. 
Return Value 
true if the elements were found in the Set object; false otherwise. 
Example 


In this example, you create a linked list object and add some elements to it. Then you create a hash set object and copy the 
linked list object to it. Testing the hash set object to see if it contains all the elements of the linked list gives the result true. 


// Set-contAll.jsl 
// Set.containsAll example 


import java.util.*; 


public class MyClass 
{ 
public static void main(String[] args) 
if 
// Create a linked list object: 
LinkedList lList = new LinkedList(); 


// Add some elements: 
lList.add("Sam") ; 
lList.add("Michelle"); 
lList.add("Jim"); 
lList.add("Virginia"); 


// Create a HashSet object: 
Set hs = new HashSet(); 


// Copy 1List elements to hs: 
hs.addAll(1List); 


// Check if has contains all the lelemnts of lList: 
if(hs.containsAll(1lList)) 

System.out.println("The two objects are identical."); 
System.out.println("hs = " + hs); 


} 


/* 

Output: 

The two objects are identical. 

hs = [Michelle, Jim, Sam, Virginia] 


*/ 


See Also 
Reference 
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java.util Package 


Visual J# Reference 


Set.equals Method 


Checks for equality between a specified element and the current element in a Set object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean equals( 
java.lang.Object e); 


Parameters 
e 
The element compared with. 
Return Value 
true if the two elements are identical; false otherwise. 
Example 
In this example, you create two hash set objects, add some elements to the first one, and copy it to the second one. Then you 


test the two objects for equality. 


// Set-eqi.jsl 
// Set.Equals example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Create two HashSet objects: 
Set hs1 = new HashSet(); 
Set hs2 = new HashSet(); 
// Add some elements: 
hs1.add("Sam"); 
hs1.add("Michelle") ; 
hs1.add("Jim"); 
hs1.add("Virginia") ; 
// Add all the element of hs1 to hs11: 
hs2.addAll(hs1) ; 
// Check if the two objects are identical: 
if(hs1.Equals(hs2)) 
System.out.println("The two objects are the same."); 
} 
} 
/ * 
Output: 
The two objects are the same. 
af 
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Set.hashCode Method 


Retrieves the hash code for a Set object. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract int hashCode(); 


Return Value 


The integer that represents the hash code of the Set object. 


Example 


In this example, you display the hash code of a hash set object after adding some elements to it. 


// Set-getHash1.jsl 
// Set.GetHashCode example 


import java.util.*; 


public class MyClass 


static void main(String[] args) 


Create a HashSet object: 


Set hs = new HashSet(); 


Add some elements: 
add(new Double(5.25)); 


.add(new Byte((byte)127)); 
.add(null); 


add(new Integer(55)); 


Print the hash code: 


System.out.printin("The hash code is: " + hs.GetHashCode()); 


The hash code is: 1075118262 


{ 
public 
{ 
// 
// 
hs. 
hs 
hs 
hs. 
// 
} 
} 
/* 
* 
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Set.isEmpty Method 


Checks if a Set object is empty. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean isEmpty(); 


Return Value 
true if the Set object was empty; false otherwise. 
Example 


In this example, you create and initialize a hash set object, clear it, and then you check to see if the set is empty. 


// Set-isEmp1.jsl 
// Set.isEmpty example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Create a HashSet object: 
Set hs = new HashSet(); 
// Add some elements: 
hs.add( "Hazem" ) ; 
hs.add("Sally"); 
hs.add("Pille"); 
hs.add("Craig") ; 
// Clear the list: 
hs.clear(); 
// Check if the list is empty: 
if(hs.isEmpty()) 
System.out.println("The list is now empty."); 
// Display the empty set: 
System.out.printlin("hs = " + hs); 
} 
} 
/ * 
The list is now empty. 
hs = [] 
wr 
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Set.iterator Method 


Provides an iterator over a Set object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.util.Iterator iterator(); 


Return Value 

The provided iterator over the Set object. 

Example 

In this example, you create an initialize a hash set object and then you retrieve an iterator to iterate over the set and display its 


members. 


// Set-iterator1.jsl 
// Set.iterator example 


import java.util.*; 


public class MyClass 


{ 
public static void main() 
1 
// Create a HashSet object: 
Set hs = new HashSet(); 
// Add some elements: 
hs.add("1 "); 
hs.add("2 "); 
hs.add("3 "); 
hs.add("4 "); 
// Retrieve an iterator to the hashset: 
Iterator iter = hs.iterator(); 
// Extract elements from iterator. 
// Note that the elements may not follow the order in which they 
// are added to HashSet. 
while(iter.hasNext()) 
{ 
System.out.print(iter.next()); 
iter.remove(); 
} 
} 
} 
/ * 
Output: 
3142 
wi A 
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Set.remove Method 


Deletes an element from a Set object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean remove( 
java.lang.Object e); 


Parameters 
e 


The element to be removed from the Set object. 
Return Value 
true if the element was successfully removed; false otherwise. 
Example 


In this example, you create and initialize a hash set object, then you remove one element and display the set before and after 
the removal. 


// Set-rem1.jsl 
// Set.remove example 


import java.util.*; 


public class MyClass 
{ 
public static void main(String[] args) 
if 
// Create a HashSet object: 
Set hs = new HashSet(); 


// Add some elements: 
hs.add("Sam") ; 
hs.add("Michelle"); 
hs.add("Jim") ; 
hs.add("Virginia"); 


// Display the set: 
System.out.printlin("hs (before) = " + hs); 


// Remove an element: 
hs.remove("Sam") ; 


// Display the set again: 
System.out.println("hs (after) = " + hs); 


} 


/* 

Output: 

hs (before) = [Michelle, Jim, Sam, Virginia] 
hs (after) = [Michelle, Jim, Virginia] 

*/ 


See Also 
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Set.removeAll Method 


Deletes all elements of a specified collection from a Set object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean removeA11( 
java.util.Collection c); 


Parameters 
c 
The name of the collection. 
Return Value 
true if the elements were removed successfully; false otherwise. 
Example 
In this example, you create and initialize two collections, a linked list (Il) and a hash set (hs). Then you remove all the elements 


from hs that exist in Il. The output displays the new contents of hs. 


// Set-remA1.js1 
// Set.removeAll example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Create a linked list object: 
LinkedList 11 = new LinkedList(); 
// Create a HashSet object: 
Set hs = new HashSet(); 
// Add some elements to hs: 
hs.add("Isabella"); 
hs.add("Angelina"); 
hs.add("Pille"); 
hs.add("Hazem") ; 
// Add some elements to 11: 
ll.add("Isabella"); 
ll.add("Angelina"); 
// Remove 11 members: 
hs.removeAl1(11); 
// Display hs: 
System.out.println("The collection is: " + hs); 
} 
} 
/* 
Output: 
The collection is: [Pille, Hazem] 
ay 
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Set.retainAll Method 


Deletes all elements of the Set that are not contained in specified collection. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean retainAl1l( 
java.util.Collection c); 


Parameters 
c 
The name of the collection. 
Return Value 
true if the elements were deleted successfully; false otherwise. 
Example 
In this example, you create and initialize two collections, a linked list (II) and a hash set (hs). Then you retain all the elements of 


ll into hs. The output displays the contents of both collections. 


// Set-retA1.jsl 
// Set.retainAll example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Create a linked list object: 
LinkedList 11 = new LinkedList(); 
// Create a HashSet object: 
Set hs = new HashSet(); 
// Add some elements to hs: 
hs.add("Isabella"); 
hs.add("Angelina"); 
hs.add("Pille"); 
hs.add("Hazem") ; 
// Add some elements to 11: 
ll.add("Isabella"); 
ll.add("Angelina"); 
// Retain elements from 11 into hs: 
hs.retainAll1(11); 
// Display hs: 
System.out.println("hs contains: " + hs); 
System.out.println("11 contains: " + 11); 
} 
} 
/* 
Output: 


hs contains: [Isabella, Angelina] 
ll contains: [Isabella, Angelina] 


*/ 


See Also 
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Set.size Method 


Retrieves the number of elements in a Set. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract int size(); 


Return Value 
An integer that represents the number of elements in the Set object. 
Example 


In this example, you create and initialize a hash set object, then you clear the elements and display the size before and after the 
clearing. 


// Set-size.jsl 
// Set.size example 


import java.util.*; 


public class MyClass 
{ 
public static void main(String[] args) 
if 
// Create a HashSet object: 
Set hs = new HashSet(); 


// Add some elements: 
hs.add("100") ; 
hs.add("200") ; 
hs.add("300"); 
hs.add("4@0") ; 


// Get and display the elements: 
System.out.print("The elements of the set are: "); 
System.out.println(hs) ; 


// Print the size: 
System.out.println("The size of the set is: 


+ hs.size()); 


// Clear the set: 
hs.clear(); 
System.out.print("The set has been cleared. "); 


// Print the new size: 
System.out.println("The size is now: 


+ hs.size()); 


} 


/* 

Output: 

The elements of the set are: [100, 300, 200, 400] 
The size of the set is: 4 

The set has been cleared. The size is now: @ 


a 
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Set.toArray Method 


Converts the Set object to an array. 


Overload List 


() Converts the Set object to an array. 





Set.toArray (Object[]) Fills the specified array with the elements of Set object. 


See Also 
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Set.toArray Method () 


Converts the Set object to an array. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.Object[] toArray(); 


Return Value 
The array object that contains the elements of the Set object. 
Example 


In this example, you create and initialize a hash set object, and then you convert the set to an array and display the elements of 
the array. 


// Set-toArri.jsl 
// Set.toArray example 


import java.util.*; 


public class MyClass 
{ 
public static void main(String[] args) 
if 
// Create a linked list object: 
LinkedList hs = new LinkedList(); 


// Add some elements: 
hs.add("Sarah") ; 
hs.add("Isabella"); 
hs.add("Angelina"); 
hs.add("Bianca"); 


// Create an array from the list: 
Object[] s = hs.toArray(); 


// Display the array elements: 

System.out.println("The array elements are:"); 

for (int i=@; i<hs.size(); i++) 
System.out.printlin("Element #" + i+ " = " + s[i]); 


} 


/* 

Output: 

The array elements are: 
Element #@ = Sarah 
Element #1 = Isabella 
Element #2 = Angelina 
Element #3 = Bianca 


*/ 
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Set.toArray Method (Object[]) 


Fills the specified array with the elements of Set object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.Object[] toArray( 
java.lang.Object[] arr); 


Parameters 
arr 


The name of the target array. 
Return Value 
The array object that contains the elements of the Set object. 


Example 


In this example, you create and initialize a hash set object, and then you convert the set to an array "s". Then you copy "s" toa 
new array "s1" and display the elements of "s1." 


// Set-toArr2.jsl 
// Set.toArray example 


import java.util.*; 


public class MyClass 
{ 
public static void main(String[] args) 
if 
// Create a linked list object: 
LinkedList hs = new LinkedList(); 


// Add some elements: 
hs.add("Sarah") ; 
hs.add("Isabella"); 
hs.add("Angelina"); 
hs.add("Bianca"); 


// Create an array from the list: 
Object[] s = hs.toArray(); 


// Copy "s" to another object array "si": 
Object[] s1 = hs.toArray(s); 


// Display the elements of the new array: 

System.out.println("The array elements are:"); 

for (int i=@; i<hs.size(); i++) 
System.out.printlin("Element #" + i+ " = " + s1[i]); 


} 


/* 

Output: 

The array elements are: 
Element #@ = Sarah 
Element #1 = Isabella 
Element #2 = Angelina 
Element #3 = Bianca 


ny 





Remarks 
The element at the end of the data (at the index Set.size()) is set to null if the given array has more elements than size of Set. 


Copies only the elements that array can store if the array is smaller than size of Set. 
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SimpleTimeZone Class 


Represents a specialization of the TimeZone class containing methods useful for calculations involving time zones, such as 
offsets from UTC and determining whether daylight savings time is in effect. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public class java.util.SimpleTimeZone 
extends java.util.TimeZone 


Example 


The following example demonstrates the getRawOffset, inDaylightTime, setEndRule, setStartRule, and setStartYear methods of 
the SimpleTimeZone class. 


// simpletimezone_overview.jsl 
import java.util.*; 


public class Program 


if 
public static void main(String[] args) 
{ 

// Create our own time zone named XYZ with an offset of 

// 10@ milliseconds from GMT. Set the daylight savings 

// time period from the first Sunday in April to the last 

// Sunday in October. 

SimpleTimeZone xyz = new SimpleTimeZone(100, "XYZ", 
Calendar.APRIL, 1, Calendar.SUNDAY, 2, 
Calendar.OCTOBER, -1, Calendar.SUNDAY, 2); 

TimeZone. setDefault (xyz) ; 

// Change the daylight savings time rules effective in the 

// year 2005. 

xyz.setStartYear(105) ; 

// Change the starting time for daylight savings time to 

// the first Sunday in July at 2:02 AM. 

xyz.setStartRule(Calendar.JULY, 1, Calendar.SUNDAY, 2); 

// Change the ending time for daylight savings time to 

// the last Sunday in July at 2:00 AM. 

xyz.setEndRule(Calendar.JULY, -1, Calendar.SUNDAY, 2); 

// Determine if a few dates are in daylight savings time. 

Date d1 = new Date(105, Calendar.APRIL, 15, 00, 00, 00); 

Date d2 = new Date(105, Calendar.JULY, 15, 00, 00, 00); 

Date d3 = new Date(105, Calendar.DECEMBER, 31, 00, 00, 00); 

boolean isD1InDaylight = xyz.inDaylightTime(d1); 

boolean isD2InDaylight = xyz.inDaylightTime(d2); 

boolean isD3InDaylight = xyz.inDaylightTime(d3); 

System.out.println("d1 is in DST? " + isD1InDaylight) ; 

System.out.println("d2 is in DST? " + isD2InDaylight) ; 

System.out.println("d3 is in DST? " + isD3InDaylight) ; 

// Display the raw offset for this time zone. 

int offset = xyz.getRawOffset(); 

System.out.printlin("raw offset: " + offset); 

} 


/* 

Output: 

di is in DST? false 
d2 is in DST? true 
d3 is in DST? false 
raw offset: 100 

*/ 





Inheritance Hierarchy 
java.lang.Object 
java.util. TimeZone 
java.util. SimpleTimeZone 
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SimpleTimeZone Members 


Represents a specialization of the TimeZone class containing methods useful for calculations involving time zones, such as 
offsets from UTC and determining whether daylight savings time is in effect. 


The following tables list the members exposed by the SimpleTimeZone type. 


Public Constructors 





Overloaded. Initializes a new instance of a SimpleTimeZone object. 


Public Methods 








Name Description 

equals Overridden. Determines whether two SimpleTimeZone objects are equal. 

hashCode Overridden. Generates a hash value representing the contents of the object. 

getID Gets the ID of the current time zone. (inherited from TimeZone) 

getOffset Overridden. Gets the offset of the time zone from UTC of the given date, including any effects of daylight savi 
ngs time. 





getRawOffset |Overridden. Gets the offset of the time zone from UTC, ignoring daylight savings time. 





getClass (inherited from Object ) 





inDaylightTime |Overridden. Determines whether daylight savings time is in effect on the given date. 











clone Creates a new instance of a SimpleTimeZone object that is a shallow copy of the current object. 
setEndRule Sets the rule for when daylight savings time comes to an end. 
setID Sets the ID used to represent the current time zone. (inherited from TimeZone) 





setRawOffset |Overridden. Sets the offset of the time zone from UTC, ignoring daylight savings time. 











setStartRule Sets the rule for when daylight savings time begins. 
setStartYear Sets the year when the rules governing this time zone begin. 
toString Displays a human-readable representation of a TimeZone object. (inherited from TimeZone) 





useDaylightTime|Overridden. Determines whether the current time zone uses daylight savings time. 


Protected Methods 




















Name Description 

finalize (inherited from Object ) 
See Also 
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SimpleTimeZone Constructor 


Initializes a new instance of a SimpleTimeZone object. 


Overload List 
Name Description 


SimpleTimeZone (int, String) Initializes a new instance of a SimpleTimeZone object with the given 
raw offset from UTC and ID. 





SimpleTimeZone (int, String, int, int, int, int, int, int, int, int)|Initializes a new instance of a SimpleTimeZone object with the given 
raw offset from UTC, ID, and start and end values for daylight saving 
s time. 
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SimpleTimeZone Constructor (Int32, String) 


Initializes a new instance of a SimpleTimeZone object with the given raw offset from UTC and ID. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.SimpleTimeZone( 
int rawOffset, 
java.lang.String ID); 


Parameters 
rawOffset 


The offset, represented in milliseconds, of the time zone from UTC, ignoring daylight savings time. Areas east of UTC have 
positive offsets, while areas west of UTC have negative offsets. 


ID 
The ID used to represent this time zone. 
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SimpleTimeZone Constructor (Int32, String, Int32, Int32, Int32, 
Int32, Int32, Int32, Int32, Int32) 


Initializes a new instance of a SimpleTimeZone object with the given raw offset from UTC, ID, and start and end values for 
daylight savings time. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.SimpleTimeZone( 
int rawOffset, 
java.lang.String ID, 
int startMonth, 
int startDayOfWeekInMonth, 
int startDayOfWeek, 
int startTime, 
int endMonth, 
int endDayOfWeekInMonth, 
int endDayOfWeek, 
int endTime) ; 


Parameters 
rawOffset 


The offset, represented in milliseconds, of the time zone from UTC, ignoring daylight savings time. Areas east of UTC have 
positive offsets, while areas west of UTC have negative offsets. 


ID 

The ID used to represent this time zone. 
startMonth 

The month when daylight savings time begins, such as APRIL. 
startDayOfWeekinMonth 


The day of the week in the month when daylight savings time begins, such as 4 to represent the fourth Sunday of the month. 
Use -1 to mean the last day of the week in the month. 


startDayOfWeek 
The day when daylight savings time begins, such as SUNDAY. 
startTime 
The time when daylight savings time begins, in hours. For example, use 2 to represent 2:00 AM. 
endMonth 
The month when daylight savings time ends, such as OCTOBER. 
endDayOfWeekInMonth 


The day of the week in the month when daylight savings time ends, such as 4 to represent the fourth Sunday of the month. 
Use -1 to mean the last day of the week in the month. 


endDayOfWeek 
The day when daylight savings time ends, such as SUNDAY. 
endTime 
The time when daylight savings time ends, in hours. For example, use 2 to represent 2:00 AM. 
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SimpleTimeZone Methods 


Public Methods 

















getRawOffset 


Name Description 

equals Overridden. Determines whether two SimpleTimeZone objects are equal. 

hashCode Overridden. Generates a hash value representing the contents of the object. 

getID Gets the ID of the current time zone. (inherited from TimeZone ) 

getOffset Overridden. Gets the offset of the time zone from UTC of the given date, including any effects of daylight savi 





ngs time. 


Overridden. Gets the offset of the time zone from UTC, ignoring daylight savings time. 





getClass 


(inherited from Object ) 





inDaylightTime 


Overridden. Determines whether daylight savings time is in effect on the given date. 














clone Creates a new instance of a SimpleTimeZone object that is a shallow copy of the current object. 
setEndRule Sets the rule for when daylight savings time comes to an end. 

setID Sets the ID used to represent the current time zone. (inherited from TimeZone ) 

setRawOffset |Overridden. Sets the offset of the time zone from UTC, ignoring daylight savings time. 





setStartRule 


Sets the rule for when daylight savings time begins. 





setStartY ear 


Sets the year when the rules governing this time zone begin. 





toString 


Displays a human-readable representation of a TimeZone object. (inherited from TimeZone ) 





useDaylightTime|Overridden. Determines whether the current time zone uses daylight savings time. 





Name 


finalize 
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SimpleTimeZone.clone Method 


Creates a new instance of a SimpleTimeZone object that is a shallow copy of the current object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object clone(); 


Return Value 
A new instance of a SimpleTimeZone object that is a shallow copy of the current object. 
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SimpleTimeZone.equals Method 


Determines whether two SimpleTimeZone objects are equal. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean equals( 
java.lang.Object obj); 


Parameters 


obj 

A SimpleTimeZone object to compare with the SimpleTimeZone object calling this method. 
Return Value 
true if the two SimpleTimeZone objects are equal; false otherwise. 


See Also 

Reference 
SimpleTimeZone Class 
Concepts 

SimpleTimeZone Members 
java.util Package 
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SimpleTimeZone.hashCode Method 


Generates a hash value representing the contents of the object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized int hashCode(); 


Return Value 
A hash value representing the contents of the object. 


See Also 

Reference 
SimpleTimeZone Class 
Concepts 

SimpleTimeZone Members 
java.util Package 
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SimpleTimeZone.getOffset Method 


Gets the offset of the time zone from UTC of the given date, including any effects of daylight savings time. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public int getOffset( 
int era, 
int year, 
int month, 
int day, 
int dayOfWeek, 
int milliSeconds) ; 


Parameters 
era 


The era of the date being used to calculate the offset. For the Gregorian calendar system, the value will be one of BC or AD. 
year 

The year of the date being used to calculate the offset. This value is the current year - 1900. 
month 


The month of the date being used to calculate the offset. This value is one of the month constants in the Calendar class, such 
as JANUARY. 


day 
The day of the month for the date being used to calculate the offset. 
dayOfWeek 


The day of the week for the date being used to calculate the offset. This value is one of the day constants in the Calendar 
class, such as SUNDAY. 


milliSeconds 
The time, in milliseconds, for the date being used to calculate the offset. 
Return Value 


The offset, represented in milliseconds, of the time zone from UTC, including any effects of daylight savings time. Areas east of 
UTC will get a positive return value, while areas west of UTC will get a negative return value. 


Example 


The following example shows the offset for the default time zone for both January 1, 2005 and July 1, 2005. In areas where 
daylight savings time is observed, the two offsets will be different. 


// simpletimezone_getoffset.jsl 
import java.util.*; 


public class Program 
{ 


public static void main(String[] args) 


1 
TimeZone def = SimpleTimeZone.getDefault() ; 


// Saturday, January 1, 2005 at midnight. 
int offset1 = def.getOffset( 
GregorianCalendar.AD, 
105, 


Calendar. JANUARY, 
1, 
Calendar.SATURDAY, 
@); 
System.out.println("January 1 offset: " + offset1); 


// Friday, July 1, 2005 at midnight. 
int offset2 = def.getOffset( 
GregorianCalendar.AD, 


105, 
Calendar.JULY, 
1, 
Calendar.FRIDAY, 
@); 
System.out.printlin("July 1 offset: " + offset2); 
} 
} 
/* 
Output: 


January 1 offset: -288@0000 
July 1 offset: -2520000e0 
*/ 





See Also 

Reference 
SimpleTimeZone Class 
Concepts 

SimpleTimeZone Members 
java.util Package 
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SimpleTimeZone.getRawOffset Method 


Gets the offset of the time zone from UTC, ignoring daylight savings time. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public int getRawOffset(); 


Return Value 


The offset, represented in milliseconds, of the time zone from UTC, ignoring daylight savings time. Areas east of UTC will get a 
positive return value, while areas west of UTC will get a negative return value. 


Example 


The following example shows how to get the raw offset for the default time zone. Daylight savings time does not factor into the 
raw offset. 


// simpletimezone_getrawoffset.jsl 
import java.util.*; 


public class Program 


1 
public static void main(String[] args) 
1 
TimeZone def = SimpleTimeZone.getDefault(); 
int offset = def.getRawOffset(); 
System.out.println("Raw offset: " + offset); 
} 
} 
/* 
Output: 
Raw offset: -28800000 
uf 
See Also 
Reference 
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SimpleTimeZone.inDaylightTime Method 


Determines whether daylight savings time is in effect on the given date. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean inDaylightTime( 
java.util.Date date); 


Parameters 
date 

The Date object used to determine if daylight savings time is in effect. 
Return Value 
true if daylight savings time is in effect on the given date; false otherwise. 
Example 


The following example shows how to determine if a Date is in daylight savings time. 
// simpletimezone_indaylighttime.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
TimeZone def = SimpleTimeZone.getDefault(); 
// Saturday, January 1, 2005 at midnight. 
Date d1 = new Date( 
105, 
Calendar. JANUARY, 
1, 
ee, 
ee, 
80); 
boolean isInDaylight = def.inDaylightTime(d1); 
System.out.println("January 1 in DST? " + isInDaylight) ; 
// Friday, July 1, 2005 at midnight. 
Date d2 = new Date( 
105, 
Calendar.JULY, 
1, 
ee, 
ee, 
80); 
isInDaylight = def.inDaylightTime(d2); 
System.out.println("July 1 in DST? " + isInDaylight) ; 
} 
} 
/* 
Output: 


January 1 in DST? false 
July 1 in DST? true 
*/ 


See Also 

Reference 
SimpleTimeZone Class 
Concepts 

SimpleTimeZone Members 
java.util Package 


Visual J# Reference 


SimpleTimeZone.setEndRule Method 


Sets the rule for when daylight savings time comes to an end. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void setEndRule( 
int month, 
int dayOfWeekInMonth, 
int dayOfwWeek, 
int time); 


Parameters 
month 


The month when daylight savings time ends, such as OCTOBER. 
dayOfWeekInMonth 


The day of the week in the month when daylight savings time ends, such as 4 to represent the fourth Sunday of the month. 
Use -1 to mean the last day of the week in the month. 


dayOfWeek 

The day when daylight savings time ends, such as SUNDAY. 
time 

The time when daylight savings time ends, in hours. For example, use 2 to represent 2:00 AM. 
Example 


The following example changes the end rule for a made-up time zone to the last Sunday in July at 2:00 AM. 


// simpletimezone_setendrule.jsl 
import java.util.*; 


public class Program 


{ 


public static void main(String[] args) 
si 

// Create our own time zone named XYZ with an offset of 

// 10@ milliseconds from GMT. Set the daylight savings 

// time period from the first Sunday in April to the last 

// Sunday in October. 

SimpleTimeZone xyz = new SimpleTimeZone(100, "XYZ", 
Calendar.APRIL, 1, Calendar.SUNDAY, 2, 
Calendar.OCTOBER, -1, Calendar.SUNDAY, 2); 

TimeZone. setDefault (xyz) ; 


// Change the starting time for daylight savings time to 
// the first Sunday in July at 2:00 AM. 
xyz.setStartRule(Calendar.JULY, 1, Calendar.SUNDAY, 2); 


// Change the ending time for daylight savings time to 
// the last Sunday in July at 2:00 AM. 
xyz.setEndRule(Calendar.JULY, -1, Calendar.SUNDAY, 2); 


// Determine if a few dates are in daylight savings time. 
Date d1 = new Date(105, Calendar.JULY, 3, 01, 00, 00); 
Date d2 = new Date(105, Calendar.JULY, 3, 03, 00, 00); 
Date d3 = new Date(105, Calendar.DECEMBER, 31, 900, 00, 00); 


boolean isD1InDaylight 
boolean isD2InDaylight 
boolean isD3InDaylight 


System.out.printin("d1 
System.out.println("d2 
System.out.println("d3 


} 
} 
/* 
Output: 


di is in DST? false 
d2 is in DST? true 
d3 is in DST? false 
*/ 





See Also 

Reference 
SimpleTimeZone Class 
Concepts 

SimpleTimeZone Members 
java.util Package 


.inDaylightTime(d1) ; 
.inDaylightTime(d2) ; 
.inDaylightTime(d3); 


DST? " + isD1InDaylight) ; 
DST? " + isD2InDaylight) ; 
DST? " + isD3InDaylight) ; 
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SimpleTimeZone.setRawOffset Method 


Sets the offset of the time zone from UTC, ignoring daylight savings time. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void setRawOffset( 
int offsetMillis); 


Parameters 
offsetMillis 


The offset, represented in milliseconds, of the time zone from UTC, ignoring daylight savings time. Areas east of UTC have 
positive offsets, while areas west of UTC have negative offsets. 


Example 

The following example changes the raw offset for a made-up time zone to 200 milliseconds off GMT. 
// simpletimezone_setrawoffset.jsl 
import java.util.*; 


public class Program 


+ 
public static void main(String[] args) 
{ 

// Create our own time zone named XYZ with an offset of 

// 10@ milliseconds from GMT. Set the daylight savings 

// time period from the first Sunday in April to the last 

// Sunday in October. 

SimpleTimeZone xyz = new SimpleTimeZone(100, "XYZ", 
Calendar.APRIL, 1, Calendar.SUNDAY, 2, 
Calendar.OCTOBER, -1, Calendar.SUNDAY, 2); 

TimeZone. setDefault (xyz) ; 

// Change the offset to 200 milliseconds. 

xyz.setRawO0ffset (200) ; 

System.out.printlin("raw offset: " + xyz.getRawOffset()); 

} 

} 

/* 

Output: 

raw offset: 200 

* 
See Also 
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Concepts 
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java.util Package 
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SimpleTimeZone.setStartRule Method 


Sets the rule for when daylight savings time begins. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void setStartRule( 
int month, 
int dayOfWeekInMonth, 
int dayOfwWeek, 
int time); 


Parameters 
month 


The month when daylight savings time begins, such as APRIL. 
dayOfWeekInMonth 


The day of the week in the month when daylight savings time begins, such as 4 to represent the fourth Sunday of the month. 
Use -1 to mean the last day of the week in the month. 


dayOfWeek 

The day when daylight savings time begins, such as SUNDAY. 
time 

The time when daylight savings time begins, in hours. For example, use 2 to represent 2:00 AM. 
Example 


The following example changes the start rule for a made-up time zone to the first Sunday in July at 2:00 AM. 


// simpletimezone_setstartrule.jsl 
import java.util.*; 


public class Program 


{ 


public static void main(String[] args) 
si 

// Create our own time zone named XYZ with an offset of 

// 10@ milliseconds from GMT. Set the daylight savings 

// time period from the first Sunday in April to the last 

// Sunday in October. 

SimpleTimeZone xyz = new SimpleTimeZone(100, "XYZ", 
Calendar.APRIL, 1, Calendar.SUNDAY, 2, 
Calendar.OCTOBER, -1, Calendar.SUNDAY, 2); 

TimeZone. setDefault (xyz) ; 


// Change the starting time for daylight savings time to 
// the first Sunday in July at 2:00 AM. 
xyz.setStartRule(Calendar.JULY, 1, Calendar.SUNDAY, 2); 


// Change the ending time for daylight savings time to 
// the last Sunday in July at 2:00 AM. 
xyz.setEndRule(Calendar.JULY, -1, Calendar.SUNDAY, 2); 


// Determine if a few dates are in daylight savings time. 
Date d1 = new Date(105, Calendar.JULY, 3, 01, 00, 00); 
Date d2 = new Date(105, Calendar.JULY, 3, 03, 00, 00); 
Date d3 = new Date(105, Calendar.DECEMBER, 31, 900, 00, 00); 


boolean isD1InDaylight 
boolean isD2InDaylight 
boolean isD3InDaylight 


System.out.printin("d1 
System.out.println("d2 
System.out.println("d3 


} 
} 
/* 
Output: 


di is in DST? false 
d2 is in DST? true 
d3 is in DST? false 
*/ 





See Also 

Reference 
SimpleTimeZone Class 
Concepts 

SimpleTimeZone Members 
java.util Package 


.inDaylightTime(d1) ; 
.inDaylightTime(d2) ; 
.inDaylightTime(d3); 


DST? " + isD1InDaylight) ; 
DST? " + isD2InDaylight) ; 
DST? " + isD3InDaylight) ; 
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SimpleTimeZone.setStartYear Method 


Sets the year when the rules governing this time zone begin. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void setStartYear( 
int startYear); 


Parameters 
startYear 


The year when the rules governing this time zone begin. This value is the current year - 1900 
Example 


The following example changes the daylight savings time rules for a made-up time zone starting in the year 2005. 


// simpletimezone_setstartyear.jsl 
import java.util.*; 


public class Program 


{ 


public static void main(String[] args) 
{ 

// Create our own time zone named XYZ with an offset of 

// 10@ milliseconds from GMT. Set the daylight savings 

// time period from the first Sunday in April to the last 

// Sunday in October. 

SimpleTimeZone xyz = new SimpleTimeZone(100, "XYZ", 
Calendar.APRIL, 1, Calendar.SUNDAY, 2, 
Calendar.OCTOBER, -1, Calendar.SUNDAY, 2); 

TimeZone. setDefault (xyz) ; 


// Change the daylight savings time rules effective in the 
// year 2005. 
xyz.setStartYear(105) ; 


// Change the starting time for daylight savings time to 
// the first Sunday in July at 2:@@ AM. 
xyz.setStartRule(Calendar.JULY, 1, Calendar.SUNDAY, 2); 


// Change the ending time for daylight savings time to 
// the last Sunday in July at 2:00 AM. 
xyz.setEndRule(Calendar.JULY, -1, Calendar.SUNDAY, 2); 


// Determine if a few dates are in daylight savings time. 
Date d1 new Date(105, Calendar.APRIL, 15, 00, 00, 0); 
Date d2 new Date(105, Calendar.JULY, 15, 00, 00, 00); 
Date d3 new Date(105, Calendar.DECEMBER, 31, 00, 00, 00); 


boolean isD1InDaylight = xyz.inDaylightTime(d1) ; 
boolean isD2InDaylight = xyz.inDaylightTime(d2); 
boolean isD3InDaylight = xyz.inDaylightTime(d3); 


System.out.printin("d1 is in DST? " + isD1InDaylight) ; 


System.out.printin("d2 is in DST? " + isD2InDaylight) ; 
System.out.println("d3 is in DST? " + isD3InDaylight) ; 


/* 


Output: 

di is in DST? false 
d2 is in DST? true 
d3 is in DST? false 
Vf 





See Also 
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SimpleTimeZone.useDaylightTime Method 


Determines whether the current time zone uses daylight savings time. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean useDaylightTime(); 


Return Value 

true if the current time zone uses daylight savings time; false otherwise. 

Example 

The following example determines whether a given time zone uses daylight savings time. 
// simpletimezone_usedaylighttime.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
TimeZone tz = TimeZone.getDefault(); 
String name = tz.getID(); 
System.out.println(name + " uses DST? " + 
tz.useDaylightTime()); 
} 
} 
/* 
Output: 
PST uses DST? true 
aw 
See Also 
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SortedMap Interface 


Represents a specialization of a Map object containing elements sorted by their key. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public interface java.util.SortedMap 
extends java.util.Map 


Example 


The following example demonstrates the firstKey, lastkey, headMap, and tailMap methods of the SortedMap class. 


// sortedmap_overview. jsl 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Create a TreeMap object: 
TreeMap tm = new TreeMap(); 


// Add some elements: 
tm.put("3", "Sally Abolrous"); 
tm.put("2", "Craig Combel"); 
tm.put("5", "Pille Mandla"); 


// Display the lowest key: 
System.out.println("The lowest key value is: " + 
tm. firstKey()); 


// Display the highest key: 
System.out.println("The highest key value is: " + 
tm.lastKey()); 


// Display the headMap: 
System.out.println("The head map is:\n" + tm.headMap("5")); 


// Display the tailMap: 
System.out.printin("The tail map is:\n" + tm.tailMap("3")); 


} 


/* 

Output: 

The lowest key value is: 2 

The highest key value is: 5 

The head map is: 

{2=Craig Combel, 3=Sally Abolrous} 
The tail map is: 

{3=Sally Abolrous, 5=Pille Mandla} 
4 


See Also 
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SortedMap Members 
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SortedMap Members 


Represents a specialization of a Map object containing elements sorted by their key. 


The following tables list the members exposed by the SortedMap type. 


Public Methods 





Name Description 





comparator|Gets the Comparator object that is used to sort the elements in the map. 





firstKey Returns the first key in the map. 





headMap__|Returns a SortedMap object containing all the elements in this sorted map from the first element up to but not inc 
luding the specified element. 





lastKey Returns the last key in the map. 





subMap _ jReturns a SortedMap object containing all the elements in this sorted map with keys between the two specified el 
ements. 


tailMap Returns a SortedMap object containing all the elements in this sorted map from the specified element to the last e 














lement. 
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SortedMap Methods 


Public Methods 
Name Description 








comparator|Gets the Comparator object that is used to sort the elements in the map. 





firstKey Returns the first key in the map. 





headMap__|Returns a SortedMap object containing all the elements in this sorted map from the first element up to but not inc 
luding the specified element. 


lastKey Returns the last key in the map. 


subMap  |jReturns a SortedMap object containing all the elements in this sorted map with keys between the two specified el 
ements. 


tailMap Returns a SortedMap object containing all the elements in this sorted map from the specified element to the last e 
lement. 











See Also 
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SortedMap.comparator Method 


Gets the Comparator object that is used to sort the elements in the map. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.util.Comparator comparator(); 


Return Value 
The Comparator object that is used to sort the elements in the map. 


See Also 

Reference 
SortedMap Interface 
Concepts 

SortedMap Members 
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SortedMap.firstKey Method 


Returns the first key in the map. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public abstract java.lang.Object firstKey(); 





Return Value 
The first key in the map. 


Example 


The following example displays the first key in the SortedMap object. 








// sortedmap_firstkey.jsl 
import java.util.*; 
public class Program 
{ 
public static void main(String[] args) 
if 
// Create a TreeMap object: 
TreeMap tm = new TreeMap(); 
// Add some elements: 
tm.put("3", "Sally Abolrous"); 
tm.put("2", "Craig Combel"); 
tm.put("5", "Pille Mandla"); 
// Display the lowest key: 
System.out.println("The lowest key value is: " 
tm. firstKey()); 
} 
} 
/* 
Output: 
The lowest key value is: 2 
oy: 
See Also 
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SortedMap.headMap Method 


Returns a SortedMap object containing all the elements in this sorted map from the first element up to but not including the 
specified element. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.util.SortedMap headMap( 
java.lang.Object toV); 


Parameters 
toV 


The element to compare with the elements in the SortedMap object. All elements with keys less than this element will be 
inserted into the returned map. 


Return Value 


A new instance of a SortedMap object containing all the elements in this sorted map with keys less than the given parameter 
toV. 


Example 


The following example displays a map of all elements in the SortedMap less than "5". 


// sortedmap_headmap.js1l 
import java.util.*; 


public class Program 


af 
public static void main(String[] args) 
1 
// Create a TreeMap object: 
TreeMap tm = new TreeMap(); 


// Add some elements: 
tm.put("1", "Sally Abolrous"); 
tm.put("3", "Craig Combel"); 
tm.put("5", "Pille Mandla"); 


// Display the headMap: 
System.out.println("The head map is:\n" + tm.headMap("5")); 


} 


/* 

Output: 

The head map is: 

{1=Sally Abolrous, 3=Craig Combel} 
*/ 


See Also 

Reference 
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SortedMap.lastKey Method 


Returns the last key in the map. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.lang.Object lastKey(); 


Return Value 
The last key in the map. 
Example 


The following example displays the last key in the SortedMap object. 
// sortedmap_lastkey.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a TreeMap object: 
TreeMap tm = new TreeMap(); 
// Add some elements: 
tm.put("3", "Sally Abolrous"); 
tm.put("2", "Craig Combel"); 
tm.put("5", "Pille Mandla"); 
// Display the highest key: 
System.out.println("The highest key value is: 
tm.lastKey()); 
} 
} 
/* 
Output: 
The highest key value is: 5 
of: 
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SortedMap.subMap Method 


Returns a SortedMap object containing all the elements in this sorted map with keys between the two specified elements. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.util.SortedMap subMap( 
java.lang.Object fromv, 
java.lang.Object toV); 


Parameters 
fromV 


The element representing the first element to be inserted into the returned SortedMap object. All elements with keys greater 
than or equal to this element and less than or equal to toV will be inserted into the returned map. 


toV 


The element to compare with the elements in the SortedMap object. All elements with keys less than this element and 
greater than or equal to fromV will be inserted into the returned map. 


Return Value 


A new instance of a SortedMap object containing all the elements in this sorted map with keys greater than or equal to the 
given parameter fromV and less than the given parameter toV. 


Example 

The following example displays a map of all elements in the SortedMap in the range of [1, 3). 
// sortedmap_submap.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
// Create a TreeMap object: 
TreeMap tm = new TreeMap(); 
// Add some elements: 
tm.put("1", "Sally Abolrous"); 
tm.put("2", "Craig Combel"); 
tm.put("3", "Pille Mandla"); 
// Display the SortedMap: 
System.out.printin(tm.subMap("1", "3")); 
} 
} 
/ * 
Output: 
{1=Sally Abolrous, 2=Craig Combel} 
*/ 
See Also 
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SortedMap.tailMap Method 


Returns a SortedMap object containing all the elements in this sorted map from the specified element to the last element. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.util.SortedMap tailMap( 
java.lang.Object fromv); 


Parameters 
fromV 


The element representing the first element to be inserted into the returned SortedMap object. All elements with keys greater 
than or equal to this element will be inserted into the returned map. 


Return Value 


A new instance of a SortedMap object containing all the elements in this sorted map with keys greater than or equal to the 
given parameter fromV. 


Example 


The following example displays a map of all elements in the SortedMap greater than or equal to "2". 


// sortedmap_tailmap.jsl 
import java.util.*; 


public class Program 


{ 


public static void main(String[] args) 
1 
// Create a TreeMap object: 
TreeMap tm = new TreeMap(); 


// Add some elements: 
tm.put("1", "Sally Abolrous"); 
tm.put("2", "Craig Combel"); 
tm.put("3", "Pille Mandla"); 


// Display the tailMap: 
System.out.println("The tail map is:\n" + tm.tailMap("2")); 


} 


/* 

Output: 

The tail map is: 

{2=Craig Combel, 3=Pille Mandla} 
*/ 


See Also 
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SortedSet Interface 


Represents a specialization of a Set object containing sorted elements. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public interface java.util.SortedSet 
extends java.util.Set 


Example 


The following example demonstrates the first, last, headSet, and tailSet methods of the SortedSet interface. 


// sortedset_overview. jsl 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Create a new TreeSet object: 
TreeSet ts = new TreeSet(); 


// Add some elements: 

ts.add(new Integer(5)); 
ts.add(new Integer(4)); 
ts.add(new Integer(9)); 


// Display the first and the last: 
System.out.println("The first element: " + ts.first()); 
System.out.println("The last element: " + ts.last()); 


// Display the headSet and the tailSet: 
System.out.println("The headSet: " + ts.headSet(ts.last())); 
System.out.printin("The tailSet: " + ts.tailSet(ts.last())); 


r 


[* 

Output: 

The first element: 4 
The last element: 9 
The headSet: [4, 5] 
The tailSet: [9] 

*/ 


See Also 
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SortedSet Members 


Represents a specialization of a Set object containing sorted elements. 


The following tables list the members exposed by the SortedSet type. 


Public Methods 





Name Description 





comparator|Gets the Comparator object that is used to sort the elements in the set. 





first Returns the first element in the set. 





headSet __|Returns a SortedSet object containing all the elements in this sorted set from the first element up to but not includ 
ing the specified element. 

















last Returns the last element in the set. 

subSet Returns a SortedSet object containing all the elements in this sorted set between the two specified elements. 

tailSet Returns a SortedSet object containing all the elements in this sorted set from the specified element to the last ele 
ment. 

See Also 

Reference 

SortedSet Interface 

Concepts 


java.util Package 





Visual J# Reference 


SortedSet Methods 


Public Methods 
Name Description 








comparator|Gets the Comparator object that is used to sort the elements in the set. 





first Returns the first element in the set. 





headSet __|Returns a SortedSet object containing all the elements in this sorted set from the first element up to but not includ 
ing the specified element. 











last Returns the last element in the set. 

subSet Returns a SortedSet object containing all the elements in this sorted set between the two specified elements. 

tailSet Returns a SortedSet object containing all the elements in this sorted set from the specified element to the last ele 
ment. 

See Also 

Reference 

SortedSet Interface 

Concepts 


java.util Package 
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SortedSet.comparator Method 


Gets the Comparator object that is used to sort the elements in the set. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.util.Comparator comparator(); 


Return Value 
The Comparator object that is used to sort the elements in the set. 


See Also 

Reference 
SortedSet Interface 
Concepts 

SortedSet Members 
java.util Package 
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SortedSet.first Method 


Returns the first element in the set. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public abstract java.lang.Object first(); 





Return Value 
The first element in the set. 
Example 


The following example displays the first element in a SortedSet object. 


// sortedset_first.jsl 
import java.util.*; 


public class Program 


{ 


public static void main(String[] args) 
if 
// Create a new TreeSet object: 
TreeSet ts = new TreeSet(); 


// Add some elements: 

ts.add(new Integer(5)); 
ts.add(new Integer(4)); 
ts.add(new Integer(9)); 


// Display the first and the last: 
System.out.println("The first element: " + ts.first()); 
System.out.println("The last element: " + ts.last()); 


} 


/* 

Output: 

The first element: 4 
The last element: 9 
Vf 








See Also 

Reference 
SortedSet Interface 
Concepts 

SortedSet Members 
java.util Package 
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SortedSet.headSet Method 


Returns a SortedSet object containing all the elements in this sorted set from the first element up to but not including the 
specified element. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.util.SortedSet headSet( 
java.lang.Object toV); 


Parameters 
toV 


The element to compare with the elements in the SortedSet object. All elements less than this element will be inserted into 
the returned set. 


Return Value 
A new instance of a SortedSet object containing all the elements in this sorted set less than the given parameter toV. 
Example 


The following example demonstrates how to create a set containing all elements in the set up to but not including the last 
element. 


// sortedset_headset.jsl 
import java.util.*; 


public class Program 
af 
public static void main(String[] args) 
1 
// Create a new TreeSet object: 
TreeSet ts = new TreeSet(); 


// Add some elements: 

ts.add(new Integer(5)); 
ts.add(new Integer(4)); 
ts.add(new Integer(9)); 


// Display the headSet and the tailSet: 
System.out.println("The headSet: " + ts.headSet(ts.last())); 
System.out.println("The tailSet: " + ts.tailSet(ts.last())); 


} 


LE 

Output: 

The headSet: [4, 5] 
The tailSet: [9] 

"7 


See Also 

Reference 
SortedSet Interface 
Concepts 

SortedSet Members 
java.util Package 


Visual J# Reference 


SortedSet.last Method 


Returns the last element in the set. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public abstract java.lang.Object last(); 





Return Value 
The last element in the set. 
Example 


The following example displays the last element in a SortedSet object. 


// sortedset_last.jsl 
import java.util.*; 


public class Program 


{ 


public static void main(String[] args) 
if 
// Create a new TreeSet object: 
TreeSet ts = new TreeSet(); 


// Add some elements: 

ts.add(new Integer(5)); 
ts.add(new Integer(4)); 
ts.add(new Integer(9)); 


// Display the first and the last: 
System.out.println("The first element: " + ts.first()); 
System.out.println("The last element: " + ts.last()); 


} 


/* 

Output: 

The first element: 4 
The last element: 9 
Vf 








See Also 

Reference 
SortedSet Interface 
Concepts 

SortedSet Members 
java.util Package 
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SortedSet.subSet Method 


Returns a SortedSet object containing all the elements in this sorted set between the two specified elements. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.util.SortedSet subSet( 
java.lang.Object fronv, 
java.lang.Object toV); 


Parameters 
fronV 


The element representing the first element to be inserted into the returned SortedSet object. All elements greater than or 
equal to this element and less than or equal to toV will be inserted into the returned set. 


toV 


The element to compare with the elements in the SortedSet object. All elements less than this element and greater than or 
equal to fromV will be inserted into the returned set. 


Return Value 


A new instance of a SortedSet object containing all the elements in this sorted set greater than or equal to the given parameter 
fromV and less than the given parameter toV. 


Example 


The following example demonstrates how to create a sub set of a SortedSet object. 


// sortedset_subset.jsl 
import java.util.*; 


public class Program 


{ 


public static void main(String[] args) 
{ 
// Create a new TreeSet object: 
TreeSet ts = new TreeSet(); 


// Declare some Double objects: 
Double x = new Double(5.1); 
Double y = new Double(7.3); 
Double z = new Double(9.2); 


// Add some elements: 
ts.add(x); 
ts.add(y); 
ts.add(z); 


System.out.println("The TreeSet elements are: + 


"x=" + xX 4+ ", y=" + yt ", Z=" + Z)5 


// Display the subsets between two different elements: 

System.out.println("The subset from x to z is: " + 
ts.subSet(x, z)); 

System.out.println("The subset from x to y is: " + 


ts.subSet(x, y)); 


/* 


Output: 

The TreeSet elements are: x=5.1, y=7.3, z=9.2 
The subset from x to z is: [5.1, 7.3] 

The subset from x to y is: [5.1] 

=) 





See Also 
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SortedSet.tailSet Method 


Returns a SortedSet object containing all the elements in this sorted set from the specified element to the last element. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract java.util.SortedSet tailSet( 
java.lang.Object fromv); 


Parameters 
fromV 


The element representing the first element to be inserted into the returned SortedSet object. All elements greater than or 
equal to this element will be inserted into the returned set. 


Return Value 


A new instance of a SortedSet object containing all the elements in this sorted set greater than or equal to the given parameter 
fromv. 


Example 


The following example demonstrates how to create a set containing all elements from the specified element until the end of 
the set. 


// sortedset_tailset.jsl 
import java.util.*; 


public class Program 
af 
public static void main(String[] args) 
1 
// Create a new TreeSet object: 
TreeSet ts = new TreeSet(); 


// Add some elements: 

ts.add(new Integer(5)); 
ts.add(new Integer(4)); 
ts.add(new Integer(9)); 


// Display the headSet and the tailSet: 
System.out.println("The headSet: " + ts.headSet(ts.last())); 
System.out.println("The tailSet: " + ts.tailSet(ts.last())); 


} 


LE 

Output: 

The headSet: [4, 5] 
The tailSet: [9] 
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See Also 
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Stack Class (J#) 


Represents a collection of objects that are accessed in a last-in, first out fashion. Elements are pushed onto the top of the stack, 
and the last element pushed on is the first element to be popped off. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public class java.util.Stack 
extends java.util.Vector 


Example 


The following example demonstrates the empty, peek, peekTop, pop, push, and search methods of the Stack class. 


// stack_overview.jsl 
import java.util.*; 
public class Program 


public static void main(String[] args) 
{ 
// Create a Stack and populate it with a few elements. 
Stack stk = new Stack(); 
stk. push("A"); 
stk.push("B"); 
stk. push("C"); 


// Determine if the stack is empty. 
if (!stk.empty()) 


// Take a look at the top element. 
System.out.println("The top element on the Stack is " + 
stk. peek()); 


} 


// Pop off the top element. 
Object top = stk.pop(); 
System.out.println("The element 


+ top.toString() + 
was removed from the Stack. The new top element is " + 
stk. peekTop()); 


// Search for a few elements. 
String search1l = new String("A"); 
String search2 = new String("C"); 


int searchiPos = stk.search(search1) ; 
if (searchiPos > @) 


{ 
System.out.println(search1 + " is at position " + 
searchiPos + " in the Stack."); 
} 
else 
{ 
System.out.println(search1 + " is not on the Stack."); 
} 


int search2Pos = stk.search(search2); 
if (search2Pos > @) 


{ 


System.out.println(search2 + " is at position " + 
search2Pos + " in the Stack."); 


} 


else 
{ 
System.out.println(search2 + " is not on the Stack."); 
} 
} 

} 
/* 
Output: 


The top element on the Stack is C 

The element C was removed from the Stack. The new top element is B 
A is at position 2 in the Stack. 

C is not on the Stack. 

*/ 











Inheritance Hierarchy 
java.lang.Object 
java.util AbstractCollection 
java.util. AbstractList 
java.util. Vector 
java.util. Stack 


See Also 
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java.util Package 


Visual J# Reference 


Stack Members (J#) 


Represents a collection of objects that are accessed in a last-in, first out fashion. Elements are pushed onto the top of the stack, 
and the last element pushed on is the first element to be popped off. 


The following tables list the members exposed by the Stack type. 


Public Constructors 


Name Description, 


Stock ities a new instance of a Stack object. 


Public Fields 








Name Description 





capacitylncrement |A value representing the size to increase the vector once its capacity is reached.(inherited from Vector) 


elementCount The number of elements currently stored in the vector.(inherited from Vector) 
elementData An internal static array containing the elements of the vector.(inherited from Vector) 
modCount (inherited from AbstractList ) 





Public Methods 














Name Description 

add Overloaded. Adds an element to the vector. (inherited from Vector) 

addAll Overloaded. Adds multiple elements to the vector at one time. (inherited from Vector) 

addElement Adds an element to the end of the vector. The vector is automatically grown if there is insufficient room to 


add the element. (inherited from Vector) 











capacity Returns the number of elements capable of being stored in the vector. (inherited from Vector) 

clear Removes all elements from the vector. (inherited from Vector) 

contains Determines whether the vector contains a given element. (inherited from Vector) 

containsAll Determines whether all the elements in the given collection are contained in the vector. (inherited from 
Vector) 

copylnto Copies all the elements in the vector into an array. (inherited from Vector) 

elementAt Returns the element at the specified index. The element is not removed from the vector. (inherited from 
Vector) 

elements Returns an Enumeration object that can be used to efficiently traverse the elements in the vector. (inherite 


d from Vector) 


empty Determines whether the stack is empty or if it contains elements. 


ensureCapacity Determines whether the vector can hold the given number of elements. If it cannot, a new vector is created 
that is large enough to store the desired number of elements and the contents of the old vector are copied 
into the newly created vector. (inherited from Vector) 











equals 


Determines whether two vectors are equal. Two vectors are considered equal if they contain exactly the sa 
me elements. (inherited from Vector) 





firstElement 


get 


hashCode 


getClass 


indexOf 


insertElementAt 


isEmpty 


iterator 


lastElement 


lastIndexOf 


listlterator 


peek 


peekTop 


pop 


push 


remove 


removeAll 


Returns the first element in the vector. The element is not removed from the vector. (inherited from Vector 


) 


Returns the element at a given index. The element is not removed from the vector. (inherited from Vector) 


Provides a hash value representing this vector. (inherited from Vector) 


(inherited from Object ) 


Overloaded. Returns the index of the first occurrence of a given element. (inherited from Vector) 


Inserts an element into the vector at the given index. The vector is automatically grown if there is insufficie 
nt room to add the element. (inherited from Vector) 


Determines whether the vector contains any elements. (inherited from Vector) 


(inherited from AbstractList ) 


Returns the last element in the vector. The element is not removed from the vector. (inherited from Vector) 


Overloaded. Returns the index of the last occurrence of a given element. (inherited from Vector) 


Overloaded. (inherited from AbstractList ) 


Returns the top element on the stack but does not remove it from the stack. 


Returns the top element on the stack but does not remove it from the stack. 


Removes and returns the top element from the stack. 


Adds an element to the top of the stack. 


Overloaded. Removes an element from the vector. (inherited from Vector) 


Removes all the elements contained in a collection from the vector. If an element appears more than once 
in the vector, all instances are removed. The elements in the vector beyond these elements are then shifted 
down. (inherited from Vector) 


removeAllElements/Removes all elements from the vector. (inherited from Vector) 





removeElement 


Removes the first occurrence of an element from the vector. The elements in the vector beyond this eleme 
nt are then shifted down. (inherited from Vector) 








removeElementAt 


removeRange 


Removes the element from the vector at the specified index. The elements in the vector beyond this index 
are then shifted down. (inherited from Vector) 


Removes all the elements from the vector starting with the element at fromlx to the element at one less th 
an tolx. (inherited from Vector) 














retainAll Removes all elements from the vector that are not contained in the given collection. (inherited from Vector 
) 

search Searches for an element on a stack. 

set Sets the element at the given index to the given element. (inherited from Vector) 





setElementAt 


Sets the element at the given index to the given element. (inherited from Vector) 











setSize Sets the size of the vector to the given value. If the given size is greater than the current size of the vector, t 
hen the contents of the old vector are copied into a new vector of the given size. If the given size is less tha 
n the current size of the vector, then some elements will be removed from the vector. (inherited from 
Vector) 

size Returns the number of elements in the vector. (inherited from Vector) 

subList Returns a List of all the elements in the vector starting with the element at fromlx to the element at one les 
s than tolx. (inherited from Vector) 

toArray Overloaded. Converts a vector into a static array. (inherited from Vector) 

toString Displays a human-readable representation of a vector. (inherited from Vector) 

trimToSize Changes the capacity of a vector to match its size. (inherited from Vector) 


Protected Methods 





Name 


Description 





finalize 





(inherited from Object ) 








See Also 
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Stack Fields 


Public Fields 


























Name Description 

capacitylncrement |A value representing the size to increase the vector once its capacity is reached. (inherited from Vector ) 
elementCount The number of elements currently stored in the vector. (inherited from Vector ) 

elementData An internal static array containing the elements of the vector. (inherited from Vector ) 

modCount (inherited from AbstractList ) 

See Also 

Reference 

Stack Class 

Concepts 


java.util Package 
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Stack Constructor 


Initializes a new instance of a Stack object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.util.Stack(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 
Reference 

Stack Class 
Concepts 

Stack Members 
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Stack Methods 


Public Methods 























ensureCapacity 


equals 


Name Description 

add Overloaded. Adds an element to the vector. (inherited from Vector ) 

addAll Overloaded. Adds multiple elements to the vector at one time. (inherited from Vector ) 

addElement Adds an element to the end of the vector. The vector is automatically grown if there is insufficient room to 
add the element. (inherited from Vector ) 

capacity Returns the number of elements capable of being stored in the vector. (inherited from Vector ) 

clear Removes all elements from the vector. (inherited from Vector ) 

contains Determines whether the vector contains a given element. (inherited from Vector ) 

containsAll Determines whether all the elements in the given collection are contained in the vector. (inherited from 
Vector ) 

copylinto Copies all the elements in the vector into an array. (inherited from Vector ) 

elementAt Returns the element at the specified index. The element is not removed from the vector. (inherited from 
Vector ) 

elements Returns an Enumeration object that can be used to efficiently traverse the elements in the vector. (inherite 
d from Vector ) 

empty Determines whether the stack is empty or if it contains elements. 


Determines whether the vector can hold the given number of elements. If it cannot, a new vector is created 
that is large enough to store the desired number of elements and the contents of the old vector are copied 
into the newly created vector. (inherited from Vector ) 


Determines whether two vectors are equal. Two vectors are considered equal if they contain exactly the sa 
me elements. (inherited from Vector ) 





firstElement 


Returns the first element in the vector. The element is not removed from the vector. (inherited from Vector 


) 





get Returns the element at a given index. The element is not removed from the vector. (inherited from Vector ) 
hashCode Provides a hash value representing this vector. (inherited from Vector ) 

getClass (inherited from Object ) 

indexOf Overloaded. Returns the index of the first occurrence of a given element. (inherited from Vector ) 





insertElementAt 


isEmpty 





Inserts an element into the vector at the given index. The vector is automatically grown if there is insufficie 
nt room to add the element. (inherited from Vector ) 


Determines whether the vector contains any elements. (inherited from Vector ) 

















iterator (inherited from AbstractList ) 

lastElement Returns the last element in the vector. The element is not removed from the vector. (inherited from Vector 
) 

lastindexOf Overloaded. Returns the index of the last occurrence of a given element. (inherited from Vector ) 

listlterator Overloaded. (inherited from AbstractList ) 

peek Returns the top element on the stack but does not remove it from the stack. 

peekTop Returns the top element on the stack but does not remove it from the stack. 

pop Removes and returns the top element from the stack. 

push Adds an element to the top of the stack. 

remove Overloaded. Removes an element from the vector. (inherited from Vector ) 

removeAll Removes all the elements contained in a collection from the vector. If an element appears more than once 


in the vector, all instances are removed. The elements in the vector beyond these elements are then shifted 
down. (inherited from Vector ) 





removeAllElements|Removes all elements from the vector. (inherited from Vector ) 


removeElement 


Removes the first occurrence of an element from the vector. The elements in the vector beyond this eleme 
nt are then shifted down. (inherited from Vector ) 





removeElementAt 


Removes the element from the vector at the specified index. The elements in the vector beyond this index 
are then shifted down. (inherited from Vector ) 





removeRange Removes all the elements from the vector starting with the element at fromlx to the element at one less th 
an tolx. (inherited from Vector ) 

retainAll Removes all elements from the vector that are not contained in the given collection. (inherited from Vector 
) 

search Searches for an element on a stack. 

set Sets the element at the given index to the given element. (inherited from Vector ) 


setElementAt 


setSize 


size 


subList 


Sets the element at the given index to the given element. (inherited from Vector ) 


Sets the size of the vector to the given value. If the given size is greater than the current size of the vector, t 
hen the contents of the old vector are copied into a new vector of the given size. If the given size is less tha 
n the current size of the vector, then some elements will be removed from the vector. (inherited from 
Vector ) 


Returns the number of elements in the vector. (inherited from Vector ) 


Returns a List of all the elements in the vector starting with the element at fromlx to the element at one les 
s than tolx. (inherited from Vector ) 








toArray 


Overloaded. Converts a vector into a static array. (inherited from Vector ) 











toString Displays a human-readable representation of a vector. (inherited from Vector ) 





trimToSize Changes the capacity of a vector to match its size. (inherited from Vector ) 





Protected Methods 
Name 


finalize (inherited from Object ) 








See Also 
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Stack.empty Method 


Determines whether the stack is empty or if it contains elements. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public boolean empty(); 





Return Value 
true if the stack is empty; false otherwise. 
Example 


The following example demonstrates how to determine if a Stack is empty. 











// stack_empty.jsl 
import java.util.*; 
public class Program 
{ 
public static void main(String[] args) 
if 
// Create a Stack and populate it with a few elements. 
Stack stk = new Stack(); 
stk.push(new String("A")); 
stk.push(new String("B")); 
stk.push(new String("C")); 
if (!stk.empty()) 
{ 
// Do something useful with the Stack here. 
} 
} 
} 
See Also 
Reference 
Stack Class 
Concepts 
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Stack.peek Method 


Returns the top element on the stack but does not remove it from the stack. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized java.lang.Object peek(); 


Return Value 
The top element on the stack, which is the last element that was added to the stack. 
Example 


The following example shows the top element on the Stack. 
// stack_peek.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a Stack and populate it with a few elements. 
Stack stk = new Stack(); 
stk.push(new String("A")); 
stk.push(new String("B")); 
stk.push(new String("C")); 
// Look at the top element on the Stack. 
Object o = stk.peek(); 
System.out.println("peek: " + o.toString()); 
} 
; 
/ * 
Output 
peek: C 
*/ 
See Also 
Reference 
Stack Class 
Concepts 
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Stack.peekTop Method 


Returns the top element on the stack but does not remove it from the stack. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object peekTop(); 


Return Value 


The top element on the stack, which is the last element that was added to the stack. 


Example 


The following example shows the top element on the Stack. 


// stack_peektop.jsl 


import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a Stack and populate it with a few elements. 
Stack stk = new Stack(); 
stk.push(new String("A")); 
stk.push(new String("B")); 
stk.push(new String("C")); 
// Look at the top element on the Stack. 
Object o = stk.peekTop(); 
System.out.println("peekTop: " + o.toString()); 
} 
; 
/ * 
Output: 
peekTop: C 
*/ 
See Also 
Reference 
Stack Class 
Concepts 
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Stack.pop Method 


Removes and returns the top element from the stack. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized java.lang.Object pop(); 


Return Value 
The top element on the stack, which is the last element that was added to the stack. 
Example 


The following example removes the top element from the Stack. 
// stack_pop.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a Stack and populate it with a few elements. 
Stack stk = new Stack(); 
stk.push(new String("A")); 
stk.push(new String("B")); 
stk.push(new String("C")); 
// Look at and remove the top element on the Stack. 
Object o = stk.pop(); 
System.out.println("pop: " + o.toString()); 
System.out.println("new top: " + stk.peek().toString()); 
} 
} 
/ * 
Output: 
pop: C 
new top: B 
1, 
See Also 
Reference 
Stack Class 
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Stack.push Method 


Adds an element to the top of the stack. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object push( 
java.lang.Object item); 


Parameters 
item 

The element to be added to the top of the stack. 
Return Value 
The element that was added to the top of the stack. 
Example 


The following example adds an element to the top of the Stack. 
// stack_push.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a Stack and populate it with a few elements. 
Stack stk = new Stack(); 
stk.push(new String("A")); 
stk.push(new String("B")); 
stk.push(new String("C")); 
// Add another element to the top of the Stack. 
stk.push(new String("D")); 
System.out.println("new top: " + stk.peek().toString()); 
} 
} 
/ * 
Output 
new top: D 
*/ 
See Also 
Reference 
Stack Class 
Concepts 
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Stack.search Method 


Searches for an element on a stack. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized int search( 
java.lang.Object obj); 


Parameters 


obj 
The element to search the stack for. 
Return Value 


The position of the element on the stack. The top of the stack is position 1, the element immediately below that is position 2, 
etc. If the element being searched for is not on the stack, then -1 is returned. 


Example 


The following example demonstrates how to search a Stack for a particular element. The position within the Stack is then 
displayed. 


// stack_search.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
// Create a Stack and populate it with a few elements. 
Stack stk = new Stack(); 
stk.push(new String("A")); 
stk.push(new String("B")); 
stk.push(new String("C")); 
// Look for those elements as well as an element that doesn't 
// exist on the Stack. 
String strD = new String("D"); 
String strc = new String("C"); 
String strB = new String("B"); 
String strA = new String("A"); 
System.out.println("search D: " + stk.search(strD)); 
System.out.println("search C: " + stk.search(strC)); 
System.out.printin("search B: " + stk.search(strB)); 
System.out.println("search A: " + stk.search(strA)); 
} 
} 
/* 
Output: 
search D: -1 
search C: 1 
search B: 2 
search A: 3 
*/ 
See Also 


Reference 


Stack Class 
Concepts 

Stack Members 
java.util Package 
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StringTokenizer Class 


Provides methods to parse a string and split it into tokens based on a delimiter. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public class java.util.StringTokenizer 
extends java.lang.Object 
implements java.util.Enumeration 


Example 


The following example demonstrates the countTokens, hasMoreElements, hasMoreTokens, nextElement, and nextToken 
methods of the StringTokenizer class. 


// stringtokenizer_overview.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
String str = 
"This is/some text/that I am/parsing/using StringTokenizer/."; 
StringTokenizer strTokElem = 
new StringTokenizer(str, "/", true); 
System.out.println("Elements..."); 
while (strTokElem.hasMoreElements()) 
{ 
System. out.println(strTokElem.nextElement()) ; 
} 
StringTokenizer strTokToken = 
new StringTokenizer(str, "/", false); 
System.out.println("Tokens..."); 
while (strTokToken.hasMoreTokens() ) 
{ 
System.out.println(strTokToken.nextToken()); 
} 
StringTokenizer strTok = 
new StringTokenizer(str, "/", false); 
System.out.println("Count..."); 
System.out.println(strTok.countTokens()); 
} 
i 
/* 
Output: 
Elements... 
This is 
/ 
some text 
/ 
that I am 
/ 
parsing 
/ 


using StringTokenizer 


/ 


Tokens... 

This is 

some text 

that I am 

parsing 

using StringTokenizer 


Count... 
6 
“) 











Inheritance Hierarchy 
java.lang.Object 
java.util. StringTokenizer 


See Also 

Concepts 

StringTokenizer Members 
java.util Package 
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StringTokenizer Members 


Provides methods to parse a string and split it into tokens based on a delimiter. 


The following tables list the members exposed by the StringTokenizer type. 


Public Constructors 





Name Description 





StringTokenizer Overloaded. Initializes a new instance of a StringTokenizer object. 





Public Methods 


Name Description 

countTokens Counts the number of remaining tokens in the string. Tokens that have already been parsed are not include 
d in the total. 

equals (inherited from Object ) 

hashCode (inherited from Object ) 

getClass (inherited from Object ) 


hasMoreElements|Determines whether there are more elements in the string to be enumerated. For StringTokenizer objects, a 
n element is a token. 





hasMoreTokens |Determines whether there are more tokens in the string to be parsed. 











nextElement Gets the next element in the string during enumeration. For StringTokenizer objects, an element is a token. 
nextToken Overloaded. Gets the next token in the string during parsing. 
toString Overridden. Displays a human-readable representation of a StringTokenizer object. 





Protected Methods 
Name Description 


finalize (inherited from Object ) 


MemberwiseClone Performs a shallow copy of the object. 





See Also 

Reference 
StringTokenizer Class 
Concepts 

java.util Package 
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StringTokenizer Constructor 


Initializes a new instance of a StringTokenizer object. 


Overload List 


Name Description 

StringTokenizer (String) Initializes a new instance of a StringTokenizer object using the given string. 

StringTokenizer (String, String) Initializes a new instance of a StringTokenizer object using the given string and delimi 
ter. 





StringTokenizer (String, String, boolean)|Initializes a new instance of a StringTokenizer object using the given string and delimi 
ter. You can also specify whether the delimiter is to be retained and counted as a toke 
n. 








See Also 

Reference 
StringTokenizer Class 
Concepts 

StringTokenizer Members 
java.util Package 
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StringTokenizer Constructor (String) 


Initializes a new instance of a StringTokenizer object using the given string. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.StringTokenizer( 
java.lang.String str); 


Parameters 
str 


The string to be tokenized. 


See Also 

Reference 
StringTokenizer Class 
Concepts 

StringTokenizer Members 
java.util Package 
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StringTokenizer Constructor (String, String) 


Initializes a new instance of a StringTokenizer object using the given string and delimiter. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.StringTokenizer( 
java.lang.String str, 
java.lang.String delim); 


Parameters 
str 


The string to be tokenized. 
delim 
The delimiter used to tokenize the string. 


See Also 

Reference 
StringTokenizer Class 
Concepts 

StringTokenizer Members 
java.util Package 
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StringTokenizer Constructor (String, String, Boolean) 


Initializes a new instance of a StringTokenizer object using the given string and delimiter. You can also specify whether the 
delimiter is to be retained and counted as a token. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.StringTokenizer( 
java.lang.String str, 
java.lang.String delim, 
boolean retDelim) ; 


Parameters 
str 


The string to be tokenized. 
delim 
The delimiter used to tokenize the string. 
retDelim 
Indicates whether the delimiter is to be retained and counted as a token. 


See Also 

Reference 
StringTokenizer Class 
Concepts 

StringTokenizer Members 
java.util Package 
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StringTokenizer Methods 


Public Methods 








Name Description 

countTokens Counts the number of remaining tokens in the string. Tokens that have already been parsed are not include 
d in the total. 

equals (inherited from Object ) 

hashCode (inherited from Object ) 

getClass (inherited from Object ) 


hasMoreElements|Determines whether there are more elements in the string to be enumerated. For StringTokenizer objects, a 
n element is a token. 


hasMoreTokens |Determines whether there are more tokens in the string to be parsed. 


nextElement Gets the next element in the string during enumeration. For StringTokenizer objects, an element is a token. 
nextToken Overloaded. Gets the next token in the string during parsing. 
toString Overridden. Displays a human-readable representation of a StringTokenizer object. 


Protected Methods 





Name Description 





finalize (inherited from Object ) 





MemberwiseClone Performs a shallow copy of the object. 











See Also 

Reference 
StringTokenizer Class 
Concepts 

java.util Package 
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StringTokenizer.countTokens Method 


Counts the number of remaining tokens in the string. Tokens that have already been parsed are not included in the total. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public int countTokens(); 


Return Value 

The number of tokens in the string yet to be parsed 

Example 

The following example counts the number of tokens in a string. 
// stringtokenizer_counttokens.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
String str = 
"This is/some text/that I am/parsing/using StringTokenizer/."; 
StringTokenizer strTok = 
new StringTokenizer(str, "/", false); 
System.out.println("Count..."); 
System.out.println(strTok.countTokens()); 
} 
} 
/* 
Output: 
Count... 
6 
*/ 
See Also 
Reference 
StringTokenizer Class 
Concepts 


StringTokenizer Members 
java.util Package 
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StringTokenizer.hasMoreElements Method 


Determines whether there are more elements in the string to be enumerated. For StringTokenizer objects, an element is a 
token. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean hasMoreElements(); 


Return Value 
true if there are more elements in the string yet to be parsed; false otherwise. 
Example 


The following example shows how to determine if there are more elements remaining in the string being tokenized. 
// stringtokenizer_hasmoreelements.js1l 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
String str = 
"This is/some text/that I am/parsing/using StringTokenizer/."; 
StringTokenizer strTokElem = 
new StringTokenizer(str, "/", true); 
System.out.println("Elements..."); 
while (strTokElem.hasMoreElements()) 
{ 
System. out.print1ln(strTokElem.nextElement()) ; 
} 
} 
} 
/* 
Output: 
Elements... 
This is 
/ 
some text 
/ 
that I am 
/ 
parsing 
/ 
using StringTokenizer 
‘i 
*/ 
See Also 
Reference 
StringTokenizer Class 
Concepts 


StringTokenizer Members 
java.util Package 
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StringTokenizer.hasMoreTokens Method 


Determines whether there are more tokens in the string to be parsed. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean hasMoreTokens(); 


Return Value 
true if there are more tokens in the string yet to be parsed; false otherwise. 
Example 


The following example shows how to determine if there are more tokens remaining in the string being tokenized. 
// stringtokenizer_hasmoretokens.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
String str = 
"This is/some text/that I am/parsing/using StringTokenizer/."; 
StringTokenizer strTokToken = 
new StringTokenizer(str, "/", false); 
System.out.println("Tokens..."); 
while (strTokToken.hasMoreTokens()) 
{ 
System.out.println(strTokToken.nextToken()); 
; 
} 
} 
/* 
Output: 
Tokens... 
This is 
some text 
that I am 
parsing 


using StringTokenizer 
*/ 


See Also 

Reference 
StringTokenizer Class 
Concepts 

StringTokenizer Members 
java.util Package 
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StringTokenizer.nextElement Method 


Gets the next element in the string during enumeration. For StringTokenizer objects, an element is a token. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object nextElement(); 


Return Value 
The next token in the string. 
Example 


The following example shows how to get the next element from the string being tokenized. 
// stringtokenizer_nextelement.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
String str = 
"This is/some text/that I am/parsing/using StringTokenizer/."; 
StringTokenizer strTokElem = 
new StringTokenizer(str, "/", true); 
System.out.printlin("Elements..."); 
while (strTokElem.hasMoreElements()) 
{ 
System.out.println(strTokElem.nextElement() ); 
; 
} 
} 
/* 
Output: 
Elements... 
This is 
/ 
some text 
/ 
that I am 
/ 
parsing 
/ 
using StringTokenizer 
/ 
*/ 
See Also 
Reference 
StringTokenizer Class 
Concepts 


StringTokenizer Members 
java.util Package 
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StringTokenizer.nextToken Method 


Gets the next token in the string during parsing. 


Overload List 


StringTokenizer.nextToken () Gets the next token in the string during parsing. 





StringTokenizer.nextToken (String) Gets the next token in the string as determined by the given delimiter. 


See Also 

Reference 
StringTokenizer Class 
Concepts 

StringTokenizer Members 
java.util Package 
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StringTokenizer.nextToken Method () 


Gets the next token in the string during parsing. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String nextToken(); 


Return Value 

The next token in the string. 

Example 

The following example shows how to get the next token from the string being tokenized. 
// stringtokenizer_nexttoken.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
String str = 
"This is/some text/that I am/parsing/using StringTokenizer/."; 
StringTokenizer strTokToken = 
new StringTokenizer(str, "/", false); 
System.out.println("Tokens..."); 
while (strTokToken.hasMoreTokens()) 
{ 
System.out.println(strTokToken.nextToken()); 
; 
} 
} 
/* 
Output: 
Tokens... 
This is 
some text 
that I am 
parsing 


using StringTokenizer 
*/ 


See Also 

Reference 

StringTokenizer Class 
Concepts 

StringTokenizer Members 
java.util Package 
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StringTokenizer.nextToken Method (String) 


Gets the next token in the string as determined by the given delimiter. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.String nextToken( 
java.lang.String delim); 


Parameters 
delim 
The delimiter used to tokenize the string. 
Return Value 
The next token in the string. 
Example 


The following example shows how to get the next token (delineated by the "/" character) from the string being tokenized. 
// stringtokenizer_nexttoken_2.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
String str = 
"This is/some text/that I am/parsing/using StringTokenizer/."; 
StringTokenizer strTokToken = 
new StringTokenizer(str, "/", false); 
System.out.println("Tokens..."); 
while (strTokToken.hasMoreTokens() ) 
{ 
System.out.println(strTokToken.nextToken("/")); 
} 
} 
} 
/* 
Output: 
Tokens... 
This is 
some text 
that I am 
parsing 


using StringTokenizer 
*/ 


See Also 

Reference 
StringTokenizer Class 
Concepts 

StringTokenizer Members 
java.util Package 
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TimeZone Class 


Represents an abstract class containing methods useful for calculations involving time zones, such as offsets from UTC and 
determining whether daylight savings time is in effect. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract class java.util.TimeZone 
extends java.lang.Object 
implements java.io.Serializable, java.lang.Cloneable 


Example 


The following example demonstrates the getAvailablelDs, getDefault, getID, getRawOffset, getTimeZone, and inDaylightTime 
methods of the TimeZone class. 


// simpletimezone_overview_2.jsl 
import java.util.*; 
public class Program 


public static void main(String[] args) 


{ 


TimeZone tz = TimeZone.getDefault(); 


// Print out the ID and raw offset of the default 

// time zone. 

System.out.println("default ID = " + tz.getID()); 
System.out.printlin("raw offset = " + tz.getRawOffset()); 


// Print out the rest of the IDs known to the system. 
String[] availTZs = TimeZone.getAvailableIDs(); 
for (int i = @; i < availTZs.length; i++) 


i 
} 


// Get the time zone known by the ID "GMT". 
TimeZone gmt a tz.getTimeZone("GMT"); 

if (gmt != null) 

{ 


System.out.println(availTZs[i]); 


System.out.println("GMT raw offset = " + 
gmt.getRawOffset()); 
} 


// Determine if a given date is in daylight savings time. 
// Friday, July 15, 2005 at midnight. 
Date d2 = new Date( 

105, 

Calendar.JULY, 

15, 

ee, 

ee, 

80); 
boolean isInDaylight = tz.inDaylightTime(d2); 
System.out.printin("July 15 in DST? " + isInDaylight) ; 


Output: 


default ID 
raw offset 
GMT 

UTC 

ECT 

EET 

ART 

EAT 

MET 

NET 

PLT 

IST 

BST 

VST 

CTT 

JST 

ACT 

AET 

SST 

NST 

MIT 

HST 

AST 

PST 

PNT 

MST 

CST 

EST 

IET 

PRT 

CNT 

AGT 

BET 

CAT 

GMT raw offset = @ 
July 15 in DST? true 
sf 


PST 
- 28800000 





Inheritance Hierarchy 

java.lang.Object 

java.util. TimeZone 
java.util. SimpleTimeZone 


See Also 

Concepts 
TimeZone Members 
java.util Package 
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TimeZone Members 


Represents an abstract class containing methods useful for calculations involving time zones, such as offsets from UTC and 
determining whether daylight savings time is in effect. 


The following tables list the members exposed by the TimeZone type. 


Public Constructors 





TimeZone Initializes a new instance of a TimeZone object. 


Public Methods 





Name Description 





equals (inherited from Object ) 


getAvailablelDs |Overloaded. Gets an array of all the valid IDs for all time zones around the world. 


getDefault Gets the default time zone. 

hashCode (inherited from Object ) 

getID Gets the ID of the current time zone. 

getOffset Gets the offset of the time zone from UTC of the given date, including any effects of daylight savings time. 


getRawOffset |Gets the offset of the time zone from UTC, ignoring daylight savings time. 
getTimeZone __|Gets a TimeZone object corresponding to the ID provided. 
getClass (inherited from Object ) 


inDaylightTime |Determines whether daylight savings time is in effect on the given date. 





clone Creates a new instance of a TimeZone object that is a shallow copy of the current object. 

setDefault Sets the default time zone. This will override the default time zone determined by the current locale of the sys 
tem. 

setID Sets the ID used to represent the current time zone. 





setRawOffset __|Sets the offset of the time zone from UTC, ignoring daylight savings time. 





toString Overridden. Displays a human-readable representation of a TimeZone object. 


useDaylightTime|Determines whether the current time zone uses daylight savings time. 


Protected Methods 




















Name Description 
finalize (inherited from Object ) 
See Also 


Reference 


TimeZone Class 
Concepts 
java.util Package 
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TimeZone Constructor 


Initializes a new instance of a TimeZone object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.util.TimeZone(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
TimeZone Class 
Concepts 

TimeZone Members 
java.util Package 
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TimeZone Methods 


Public Methods 
Name Description 








equals (inherited from Object ) 





getAvailablelDs |Overloaded. Gets an array of all the valid IDs for all time zones around the world. 











getDefault Gets the default time zone. 

hashCode (inherited from Object ) 

getID Gets the ID of the current time zone. 

getOffset Gets the offset of the time zone from UTC of the given date, including any effects of daylight savings time. 


getRawOffset |Gets the offset of the time zone from UTC, ignoring daylight savings time. 
getTimeZone __|Gets a TimeZone object corresponding to the ID provided. 
getClass (inherited from Object ) 


inDaylightTime |Determines whether daylight savings time is in effect on the given date. 





clone Creates a new instance of a TimeZone object that is a shallow copy of the current object. 

setDefault Sets the default time zone. This will override the default time zone determined by the current locale of the sys 
tem. 

setID Sets the ID used to represent the current time zone. 





setRawOffset __|Sets the offset of the time zone from UTC, ignoring daylight savings time. 





toString Overridden. Displays a human-readable representation of a TimeZone object. 





useDaylightTime|Determines whether the current time zone uses daylight savings time. 





Protected Methods 


Name Description 


finalize 





(inherited from Object ) 








See Also 
Reference 
TimeZone Class 
Concepts 
java.util Package 
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TimeZone.clone Method 


Creates a new instance of a TimeZone object that is a deep copy of the current object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





Return Value 
A new instance of a TimeZone object that is a deep copy of the current object. 


See Also 

Reference 
TimeZone Class 
Concepts 

TimeZone Members 
java.util Package 
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TimeZone.getAvailablelDs Method 


Gets an array of all the valid IDs for all time zones around the world. 


Overload List 
Name Description 


TimeZone.getAvailablelDs () |Gets an array of all the valid IDs for all time zones around the world. 


TimeZone.getAvailablelDs (int)|Gets an array of all the valid IDs for all time zones around the world that have the given offset f 
rom UTC. 














See Also 
Reference 
TimeZone Class 
Concepts 

TimeZone Members 
java.util Package 
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TimeZone.getAvailablelDs Method () 


Gets an array of all the valid IDs for all time zones around the world. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static synchronized java.lang.String[] getAvailableIDs(); 


Return Value 


An array of all the valid IDs for all time zones around the world. Each time zone is represented by a symbol such as "UTC" or 
"PST", 


Example 


The following example shows how to get all available time zone IDs. 


// simpletimezone_getavailableids.jsl 
import java.util.*; 


public class Program 


{ 


public static void main(String[] args) 


String[] availTZs = TimeZone.getAvailableIDs(); 
for (int i = @; i < availTZs.length; i++) 
{ 

System.out.println(availTZs[i]); 


NET 
PLT 
IST 
BST 
VST 
CTT 
JST 
ACT 
AET 
SST 
NST 
MIT 
HST 
AST 
PST 
PNT 
MST 
CST 
EST 
IET 


PRT 
CNT 
AGT 
BET 
CAT 
*/ 





See Also 

Reference 
TimeZone Class 
Concepts 

TimeZone Members 
java.util Package 
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TimeZone.getAvailablelDs Method (Int32) 


Gets an array of all the valid IDs for all time zones around the world that have the given offset from UTC. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static synchronized java.lang.String[] getAvailableIDs( 
int rawOffset); 


Parameters 
rawOffset 


The offset, represented in milliseconds, of the time zone from UTC, ignoring daylight savings time. Areas east of UTC have 
positive offsets, while areas west of UTC have negative offsets. 


Return Value 


An array of all the valid IDs for all time zones around the world that have the given offset from UTC. Each time zone is 
represented by a symbol such as "UTC" or "PST". 


Example 

The following example shows how to get all available time zone IDs with an offset of -28800000 milliseconds. 
// simpletimezone_getavailableids 2.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
String[] availTZsOffset = TimeZone.getAvailableIDs(-288000@0) ; 
for (int i = @; i < availTZsOffset.length; i++) 
{ 
System.out.println(availTZsOffset[i]); 
; 
} 
} 
/* 
Output: 
PST 
o/, 
See Also 
Reference 
TimeZone Class 
Concepts 


TimeZone Members 
java.util Package 
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TimeZone.getDefault Method 


Gets the default time zone. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static synchronized java.util.TimeZone getDefault(); 


Return Value 


The default time zone. This can either be the default time zone for the current locale of the system, or the value set in the 
setDefault method. 


Example 

The following example shows how to get the default time zone for the system. 
// simpletimezone_getdefault.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
TimeZone def = SimpleTimeZone.getDefault(); 
String id = def.getID(); 
System.out.println("default time zone: " + id); 
} 
} 
/* 
Output: 
default time zone: PST 
ef. 
See Also 
Reference 
TimeZone Class 
Concepts 


TimeZone Members 
java.util Package 
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TimeZone.getID Method 


Gets the ID of the current time zone. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.lang.String getID(); 





Return Value 
The ID of the current time zone, such as "UTC" or "PST". 
Example 


The following example shows how to get the ID for the default time zone for the system. 











// simpletimezone_getid.jsl 
import java.util.*; 
public class Program 
{ 
public static void main(String[] args) 
if 
TimeZone def = SimpleTimeZone.getDefault(); 
String id = def.getID(); 
System.out.println("default time zone: " + id); 
} 
} 
/* 
Output: 
default time zone: PST 
=f 
See Also 
Reference 
TimeZone Class 
Concepts 


TimeZone Members 
java.util Package 
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TimeZone.getOffset Method 


Gets the offset of the time zone from UTC of the given date, including any effects of daylight savings time. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract int getOffset( 
int era, 
int year, 
int month, 
int day, 
int dayOfWeek, 
int milliSeconds) ; 


Parameters 
era 


The era of the date being used to calculate the offset. For the Gregorian calendar system, the value will be one of BC or AD. 
year 

The year of the date being used to calculate the offset. This value is the current year - 1900. 
month 


The month of the date being used to calculate the offset. This value is one of the month constants in the Calendar class, such 
as JANUARY. 


day 
The day of the month for the date being used to calculate the offset. 
dayOfWeek 


The day of the week for the date being used to calculate the offset. This value is one of the day constants in the Calendar 
class, such as SUNDAY. 


milliSeconds 
The time, in milliseconds, for the date being used to calculate the offset. 
Return Value 


The offset, represented in milliseconds, of the time zone from UTC, including any effects of daylight savings time. Areas east of 
UTC will get a positive return value, while areas west of UTC will get a negative return value. 


Example 


The following example shows the offset for the default time zone for both January 1, 2005 and July 1, 2005. In areas where 
daylight savings time is observed, the two offsets will be different. 


// simpletimezone_getoffset.jsl 
import java.util.*; 


public class Program 
{ 


public static void main(String[] args) 


1 
TimeZone def = SimpleTimeZone.getDefault() ; 


// Saturday, January 1, 2005 at midnight. 
int offset1 = def.getOffset( 
GregorianCalendar.AD, 
105, 


Calendar. JANUARY, 
1, 
Calendar.SATURDAY, 
@); 
System.out.println("January 1 offset: " + offset1); 


// Friday, July 1, 2005 at midnight. 
int offset2 = def.getOffset( 
GregorianCalendar.AD, 


105, 
Calendar.JULY, 
1, 
Calendar.FRIDAY, 
@); 
System.out.printlin("July 1 offset: " + offset2); 
} 
} 
/* 
Output: 


January 1 offset: -288@0000 
July 1 offset: -2520000e0 
*/ 





See Also 

Reference 
TimeZone Class 
Concepts 

TimeZone Members 
java.util Package 
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TimeZone.getRawOffset Method 


Gets the offset of the time zone from UTC, ignoring daylight savings time. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract int getRawOffset(); 


Return Value 


The offset, represented in milliseconds, of the time zone from UTC, ignoring daylight savings time. Areas east of UTC will get a 
positive return value, while areas west of UTC will get a negative return value. 


Example 


The following example shows how to get the raw offset for the default time zone. Daylight savings time does not factor into the 
raw offset. 


// simpletimezone_getrawoffset.jsl 
import java.util.*; 


public class Program 


1 
public static void main(String[] args) 
1 
TimeZone def = SimpleTimeZone.getDefault(); 
int offset = def.getRawOffset(); 
System.out.println("Raw offset: " + offset); 
} 
} 
/* 
Output: 
Raw offset: -28800000 
uf 
See Also 
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TimeZone.getTimeZone Method 


Gets a TimeZone object corresponding to the ID provided. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static synchronized java.util.TimeZone getTimeZone( 
java.lang.String ID); 


Parameters 
ID 
The ID of the time zone to be retrieved. 
Return Value 
A TimeZone object corresponding to the ID provided. 
Example 


The following example demonstrates how to get a time zone based on its ID. 
// simpletimezone_gettimezone.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
TimeZone tz = TimeZone.getTimeZone("PST"); 
if (tz != null) 
{ 
System.out.println("Raw offset of PST: " + 
tz.getRawOffset()); 
} 
} 
} 
/* 
Output: 
Raw offset of PST: -28800000 
mf 
See Also 
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TimeZone.inDaylightTime Method 


Determines whether daylight savings time is in effect on the given date. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean inDaylightTime( 
java.util.Date date); 


Parameters 
date 

The Date object used to determine if daylight savings time is in effect. 
Return Value 
true if daylight savings time is in effect on the given date; false otherwise. 
Example 


The following example shows how to determine if a Date is in daylight savings time. 
// simpletimezone_indaylighttime.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
TimeZone def = SimpleTimeZone.getDefault(); 
// Saturday, January 1, 2005 at midnight. 
Date d1 = new Date( 
105, 
Calendar. JANUARY, 
1, 
ee, 
ee, 
80); 
boolean isInDaylight = def.inDaylightTime(d1); 
System.out.println("January 1 in DST? " + isInDaylight) ; 
// Friday, July 1, 2005 at midnight. 
Date d2 = new Date( 
105, 
Calendar.JULY, 
1, 
ee, 
ee, 
80); 
isInDaylight = def.inDaylightTime(d2); 
System.out.println("July 1 in DST? " + isInDaylight) ; 
} 
} 
/* 
Output: 


January 1 in DST? false 
July 1 in DST? true 
*/ 


See Also 
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TimeZone.setDefault Method 


Sets the default time zone. This will override the default time zone determined by the current locale of the system. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public static synchronized void setDefault( 
java.util.TimeZone def); 


Parameters 


def 
A TimeZone object representing the default time zone. 
Example 
The following example demonstrates how to change the default time zone for the system. 
// simpletimezone_setdefault.jsl 
import java.util.*; 
public class Program 


public static void main(String[] args) 


{ 
// Create our own time zone named XYZ with an offset of 
// 10@ milliseconds from GMT. Set the daylight savings 
// time period from the first Sunday in April to the last 
// Sunday in October. Make this the default time zone. 
SimpleTimeZone xyz = new SimpleTimeZone(100, "XYZ", 
Calendar.APRIL, 1, Calendar.SUNDAY, 2, 
Calendar.OCTOBER, -1, Calendar.SUNDAY, 2); 
TimeZone. setDefault (xyz) ; 
System.out.println("default time zone = " + 
TimeZone. getDefault().getID()); 
} 
} 
/* 
Output: 
default time zone = XYZ 
a 
See Also 
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TimeZone.setID Method 


Sets the ID used to represent the current time zone. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void setID( 
java.lang.String ID); 


Parameters 


ID 
The ID used to represent the current time zone. 
Example 
The following example shows how to change the ID of the default time zone for the system. 
// simpletimezone_setid.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
// Create our own time zone named XYZ with an offset of 
// 10@ milliseconds from GMT. Set the daylight savings 
// time period from the first Sunday in April to the last 
// Sunday in October. Make this the default time zone. 
SimpleTimeZone xyz = new SimpleTimeZone(100, "XYZ", 
Calendar.APRIL, 1, Calendar.SUNDAY, 2, 
Calendar.OCTOBER, -1, Calendar.SUNDAY, 2); 
TimeZone. setDefault (xyz) ; 
// Change the ID of this time zone to "WXY". 
xyz.setID("WXY"); 
System.out.println("default time zone = " + 
TimeZone. getDefault().getID()); 
} 
} 
/* 
Output: 
default time zone = WXY 
*/ 
See Also 
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TimeZone.setRawOffset Method 


Sets the offset of the time zone from UTC, ignoring daylight savings time. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract void setRawOffset( 
int offsetMillis); 


Parameters 
offsetMillis 


The offset, represented in milliseconds, of the time zone from UTC, ignoring daylight savings time. Areas east of UTC have 
positive offsets, while areas west of UTC have negative offsets. 


Example 

The following example changes the raw offset for a made-up time zone to 200 milliseconds off GMT. 
// simpletimezone_setrawoffset.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 

// Create our own time zone named XYZ with an offset of 

// 10@ milliseconds from GMT. Set the daylight savings 

// time period from the first Sunday in April to the last 

// Sunday in October. 

SimpleTimeZone xyz = new SimpleTimeZone(100, "XYZ", 
Calendar.APRIL, 1, Calendar.SUNDAY, 2, 
Calendar.OCTOBER, -1, Calendar.SUNDAY, 2); 

TimeZone. setDefault (xyz) ; 

// Change the offset to 200 milliseconds. 

xyz.setRawO0ffset (200) ; 

System.out.printlin("raw offset: " + xyz.getRawOffset()); 

} 
} 
/* 
Output: 
raw offset: 200 
*/ 
See Also 
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TimeZone.useDaylightTime Method 


Determines whether the current time zone uses daylight savings time. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public abstract boolean useDaylightTime(); 


Return Value 

true if the current time zone uses daylight savings time; false otherwise. 

Example 

The following example determines whether a given time zone uses daylight savings time. 
// simpletimezone_usedaylighttime.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
TimeZone tz = TimeZone.getDefault(); 
String name = tz.getID(); 
System.out.println(name + " uses DST? " + 
tz.useDaylightTime()); 
} 
} 
/* 
Output: 
PST uses DST? true 
aw 
See Also 
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TooManyListenersException Class 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public class java.util. TooManyListenersException 
extends java.lang.Exception 





Inheritance Hierarchy 
java.lang.Object 
Exception 
java.lang.Throwable 
java.lang.Exception 
java.util. TooManyListenersException 


See Also 

Concepts 
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TooManyListenersException Members 


The following tables list the members exposed by the TooManyListenersException type. 


Public Constructors 


Name Description 


TooManyListenersException 





Public Properties (see also Protected Properties ) 











Name Description 

HelpLink (inherited from Exception ) 
InnerException (inherited from Exception ) 
Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 


Protected Properties 





Name Description 





HResult (inherited from Exception ) 








Public Methods 











Name Description 

equals (inherited from Object ) 
filllnStackTrace (inherited from Throwable ) 
GetBaseException (inherited from Exception ) 
hashCode (inherited from Object ) 
getLocalizedMessage (inherited from Throwable ) 
getMessage (inherited from Throwable ) 
GetObjectData (inherited from Throwable ) 
getClass (inherited from Object ) 
clone (inherited from Throwable ) 
printStackTrace Overloaded. (inherited from Throwable ) 





toString (inherited from Throwable ) 











Protected Methods 


See Also 
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TooManyListenersException Constructor 


Overload List 





Name 


Description 





TooManyListenersException () 





TooManyListenersException (String) 





TooManyListenersException (SerializationInfo, StreamingContext) 





TooManyListenersException (String, Exception) 








See Also 

Reference 
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TooManyListenersException Constructor () 


Initializes a new instance of the TooManyListenersException Class . 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util. TooManyListenersException(); 


Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
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TooManyListenersException Constructor (String) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util. TooManyListenersException( 
java.lang.String s); 


Parameters 
S 


See Also 
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TooManyListenersException Constructor (SerializationInfo, 
StreamingContext) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


protected java.util. TooManyListenersException( 
System.Runtime.Serialization.SerializationInfo info, 
System.Runtime.Serialization.StreamingContext context) ; 


Parameters 
info 


context 


See Also 
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TooManyListenersException Constructor (String, Exception) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util. TooManyListenersException( 
java.lang.String s, 
System.Exception inner); 


Parameters 
S 


inner 


See Also 
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TooManyListenersException Methods 


Public Methods 





Name 


Description 





equals 


(inherited from Object ) 





filllnStackTrace 


(inherited from Throwable ) 





GetBaseException 


(inherited from Exception ) 





hashCode 


(inherited from Object ) 





getLocalizedMessage 


getMessage 


GetObjectData 


getClass 


clone 


printStackTrace 


toString 





Protected Methods 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Throwable ) 


(inherited from Object ) 


(inherited from Throwable ) 


Overloaded. (inherited from Throwable ) 


(inherited from Throwable ) 

















Name Description 

finalize (inherited from Object ) 
See Also 
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TooManyListenersException Properties 


Public Properties 





Name 


Description 





HelpLink 


(inherited from Exception ) 





InnerException 


(inherited from Exception ) 














Protected Properties 


Message (inherited from Exception ) 
Source (inherited from Exception ) 
StackTrace (inherited from Exception ) 
TargetSite (inherited from Exception ) 








Name 


Description 





HResult 








(inherited from Exception ) 





See Also 
Reference 


TooManyListenersException Class 
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TreeMap Class 


Provides a sorted map object that implements the SortedMap interface. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public class java.util. TreeMap 
extends java.util.AbstractMap 
implements java.util.SortedMap, java.lang.Cloneable, java.io.Serializable 





Inheritance Hierarchy 

java.lang.Object 
java.util AbstractMap 
java.util. TreeMap 


See Also 
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TreeMap Members 


Provides a sorted map object that implements the SortedMap interface. 


The following tables list the members exposed by the TreeMap type. 


Public Constructors 
























































Name Description 

TreeMap Overloaded. 

Public Methods 

Name Description 

clear Overridden. Removes all the mappings from a TreeMap object. 

comparator Retrieves the comparator that is used in ordering the values in a TreeMap object. 
containsKey Overridden. Checks if a TreeMap object contains a specific key. 

containsValue Overridden. Checks if a TreeMap object contains one or more keys that correspond to a specific value. 
entrySet Overridden. Retrieves the set of mappings contained in a TreeMap object. 

equals (inherited from AbstractMap ) 

firstKey Retrieves the lowest key in a TreeMap object. 

get Overridden. Retrieves the value associated with a specific key in a TreeMap object. 
hashCode (inherited from AbstractMap ) 

getClass (inherited from Object ) 

headMap Retrieves a part of the map whose keys are less than a specific key value. 

isEmpty (inherited from AbstractMap ) 

keySet Overridden. Retrieves the set of keys in a TreeMap object. 

lastKey Retrieves the highest key from a TreeMap object. 

MemberwiseClone |Performs a shallow copy of the object. 

put Overridden. Creates an association between an object and specified key entry in a TreeMap object. 
putAll Overridden. Copies the entries of a specific map to a TreeMap object. 

remove Overridden. Removes an entry from a TreeMap object. 

size Overridden. Retrieves the number of key-value mappings of a TreeMap object. 

subMap Creates a sub map that contains the objects within a specified range from a TreeMap object. 











tailMap Retrieves a partial map whose keys are greater than or equal to a specific key in a TreeMap object. 











toString (inherited from AbstractMap ) 
traverse Traverses a TreeMap object. Obsolete. 
values Overridden. Retrieves a collection of values in a TreeMap object. 





Protected Methods 
Name 


finalize (inherited from Object ) 








See Also 
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TreeMap Constructor 


Overload List 





Name Description 





TreeMap() Constructs a TreeMap object sorted according to the natural order. 





TreeMap (Comparator) |Constructs a TreeMap object sorted by a Comparator object. 





TreeMap (Map) Constructs a TreeMap object that has the same mappings as the passed Map object. 





TreeMap (SortedMap) __|Constructs a TreeMap object that has the same mappings as the passed SortedMap object. 











See Also 
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TreeMap Methods 


Public Methods 




















Name Description 

clear Overridden. Removes all the mappings from a TreeMap object. 

comparator Retrieves the comparator that is used in ordering the values in a TreeMap object. 
containsKey Overridden. Checks if a TreeMap object contains a specific key. 

containsValue Overridden. Checks if a TreeMap object contains one or more keys that correspond to a specific value. 
entrySet Overridden. Retrieves the set of mappings contained in a TreeMap object. 

equals (inherited from AbstractMap ) 

firstKey Retrieves the lowest key in a TreeMap object. 

get Overridden. Retrieves the value associated with a specific key in a TreeMap object. 
hashCode (inherited from AbstractMap ) 

getClass (inherited from Object ) 

headMap Retrieves a part of the map whose keys are less than a specific key value. 

isEmpty (inherited from AbstractMap ) 

keySet Overridden. Retrieves the set of keys in a TreeMap object. 

lastKey Retrieves the highest key from a TreeMap object. 


MemberwiseClone |Performs a shallow copy of the object. 











put Overridden. Creates an association between an object and specified key entry in a TreeMap object. 
putAll Overridden. Copies the entries of a specific map to a TreeMap object. 

remove Overridden. Removes an entry from a TreeMap object. 

size Overridden. Retrieves the number of key-value mappings of a TreeMap object. 

subMap Creates a sub map that contains the objects within a specified range from a TreeMap object. 
tailMap Retrieves a partial map whose keys are greater than or equal to a specific key in a TreeMap object. 
toString (inherited from AbstractMap ) 

traverse Traverses a TreeMap object. Obsolete. 





values Overridden. Retrieves a collection of values in a TreeMap object. 











Protected Methods 





See Also 
Reference 
TreeMap Class 
Concepts 
java.util Package 


Visual J# Reference 


TreeMap.clear Method 


Removes all the mappings from a TreeMap object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public void clear(); 





Example 


In this example, you create and initialize a TreeMap object, and then you clear it and display its elements. The result is an empty 
set. 








// TreeMap-ctor3.jsl 
// TreeMap.ctor example 
import java.util.*; 
public class MyClass 
public static void main(String[] args) 
{ 
// Create a TreeMap object: 
TreeMap tm1 = new TreeMap(); 
// Add some elements: 
tm1.put("4", "Sally Abolrous"); 
tm1.put("1", "Craig Combel"); 
tm1.put("2","Pille Mandla"); 
// Clear the map: 
tm1.clear(); 
// Display the values of the cleared map: 
System.out.println("The values of tm1 are: " + tm1.values()); 
} 
} 
/* 
The values of tm1 are: [] 
my 
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TreeMap.clone Method 


Creates a shallow copy of a TreeMap object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





Return Value 
The TreeMap copy. 


See Also 
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TreeMap.comparator Method 


Retrieves the comparator that is used in ordering the values in a TreeMap object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Comparator comparator(); 


Return Value 
A comparator object used in ordering TreeMap. 


See Also 
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TreeMap.containsKey Method 


Checks if a TreeMap object contains a specific key. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean containsKey( 
java.lang.Object k); 


Parameters 
k 

The key searched for in the TreeMap object. 
Return Value 
true if the key is found; false otherwise. 
Example 


In this example, you create and initialize a TreeMap object, and then you check if it contains the key "5." The result is true. 


// TreeMap-contkeyl.jsl 
// TreeMap.containsKey example 


import java.util.*; 


public class MyClass 


4 
public static void main(String[] args) 
{ 
// Create a TreeMap object: 
TreeMap tm = new TreeMap(); 
// Add some elements: 
tm.put( "1", "Sally Abolrous"); 
tm.put("3", "Craig Combel"); 
tm.put("5","Pille Mandla"); 
// Check if the key "5" is in the map: 
System.out.printin(tm.containsKey("5")); 
} 
} 
/* 
Output: 
true 
af 
See Also 
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TreeMap.containsValue Method 


Checks if a TreeMap object contains one or more keys that correspond to a specific value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean containsValue( 
java.lang.Object v); 


Parameters 
V 
The value searched for in the TreeMap object. 
Return Value 
true if the value is found; false otherwise. 
Example 
In this example, you create and initialize a TreeMap object, and then you check if it contains the element " Pille Mandla." The 


result is true. 


// TreeMap-contval.jsl 
// TreeMap.containsValue example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Create a TreeMap object: 
TreeMap tm = new TreeMap(); 
// Add some elements: 
tm.put( "1", "Sally Abolrous"); 
tm.put( "3", "Craig Combel"); 
tm.put("5","Pille Mandla"); 
// Check if "Pille Mandla" is in the map: 
System.out.println(tm.containsValue("Pille Mandla")); 
} 
Hy 
/ * 
Output: 
true 
ey. 
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TreeMap.entrySet Method 


Retrieves the set of mappings contained in a TreeMap object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Set entrySet(); 


Return Value 
A set of mappings in the TreeMap object. 
Example 


In this example, you create and initialize a TreeMap object, and then you display the mappings contained in the object. 


// TreeMap-entrysm1.js1 
// TreeMap.entrySet example 


import java.util.*; 


public class MyClass 
{ 


public static void main(String[] args) 


{ 
// Create a TreeMap object: 
TreeMap tm = new TreeMap(); 


// Add some elements: 
tm.put("1", "Sally Abolrous"); 
tm.put( "3", "Craig Combel"); 
tm.put("5","Pille Mandla"); 


// Display the entry set of the map: 
System.out.println("The entry set is:\n" + tm.entrySet()); 


} 


/* 

Output: 

The entry set is: 

[[1, Sally Abolrous], [3, Craig Combel], [5, Pille Mandla]] 
*/ 


See Also 
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TreeMap.firstkKey Method 


Retrieves the lowest key in a TreeMap object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object firstKey(); 


Return Value 
The lowest key in the TreeMap object. 
Example 


In this example, you create and initialize a TreeMap object, and then you display the lowest key in the object. 


// TreeMap-firstK1.jsl 
// TreeMap.firstKey example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Create a TreeMap object: 
TreeMap tm = new TreeMap(); 
// Add some elements: 
tm.put("3","Sally Abolrous"); 
tm.put("2","Craig Combel"); 
tm.put("5","Pille Mandla"); 
// Display the lowest key: 
System.out.println("The lowest key value is: " + 
tm. firstKey()); 
} 
} 
/ * 
Output: 
The lowest key value is: 2 
a 
See Also 
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TreeMap.get Method 


Retrieves the value associated with a specific key in a TreeMap object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object get( 
java.lang.Object k); 


Parameters 
k 
The key value associated with the object searched for in the TreeMap object. 
Return Value 
The object at the specified key entry in TreeMap. 
Example 
In this example, you create and initialize a TreeMap object, and then you display the element associated with the key "2." 


// TreeMap-get1.jsl 
// TreeMap.get example 


import java.util.*; 


public class MyClass 


4 
public static void main(String[] args) 
{ 
// Create a TreeMap object: 
TreeMap tm = new TreeMap(); 
// Add some elements: 
tm.put("1", "Sally Abolrous"); 
tm.put("2","Craig Combel"); 
// Display the element that corresponds to the key #2: 
System.out.println("The element #2 is: " + tm.get("2")); 
} 
} 
/ * 
Output: 
The element #2 is: Craig Combel 
*/ 
See Also 
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TreeMap.headMap Method 


Retrieves a part of the map whose keys are less than a specific key value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.SortedMap headMap( 
java.lang.Object toV); 


Parameters 
toV 


The highest key value. 
Return Value 
A part of the map whose keys are less than toV. 
Example 


In this example, you create and initialize a TreeMap object, and then you display the elements of headMap. 


// TreeMap-headm1.jsl 
// TreeMap.headMap example 


import java.util.*; 


public class MyClass 
4 


public static void main(String[] args) 


{ 
// Create a TreeMap object: 
TreeMap tm = new TreeMap(); 


// Add some elements: 
tm.put( "1", "Sally Abolrous"); 
tm.put("3", "Craig Combel"); 
tm.put("5","Pille Mandla"); 


// Display the headMap: 
System.out.println("The head map is:\n" + tm.headMap("5")); 


} 


/* 

Output: 

The head map is: 

{1=Sally Abolrous, 3=Craig Combel} 
=i 
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TreeMap.keySet Method 


Retrieves the set of keys in a TreeMap object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Set keySet(); 


Return Value 
The set of keys contained in the TreeMap object. 
Example 


In this example, you create and initialize a TreeMap object, and then you display the keySet contained in the object. 


// TreeMap-keyset1.jsl 
// TreeMap.keySet example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Create a TreeMap object: 
TreeMap tm = new TreeMap(); 
// Add some elements: 
tm.put("3","Sally Abolrous"); 
tm.put("2", "Craig Combel"); 
tm.put("5","Pille Mandla"); 
// Remove the key set: 
System.out.println("The key set is: " + tm.keySet()); 
} 
} 
/* 
Output: 
The key set is: [2, 3, 5] 
of, 
See Also 
Reference 
TreeMap Class 
Concepts 


TreeMap Members 
java.util Package 


Visual J# Reference 


TreeMap.lastKey Method 


Retrieves the highest key from a TreeMap object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object lastKey(); 


Return Value 
The highest key object retrieved from the TreeMap object. 
Example 


In this example, you create and initialize a TreeMap object, and then you display the highest key in the object. 


// TreeMap-lastK1.jsl 
// TreeMap.lastKey example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Create a TreeMap object: 
TreeMap tm = new TreeMap(); 
// Add some elements: 
tm.put( "3", "Sally Abolrous"); 
tm.put("2","Craig Combel"); 
tm.put("5","Pille Mandla"); 
// Display the highest key: 
System.out.println("The highest key value is: " + 
tm. lastKey()); 
} 
} 
/ * 
Output: 
The highest key value is: 5 
=) 
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TreeMap.put Method 


Creates an association between an object and specified key entry in a TreeMap object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object put( 
java.lang.Object k, 
java.lang.Object v); 


Parameters 
k 


The key with which the object is associated in the TreeMap object. 


The object associated with the specified key in the TreeMap object. 
Return Value 
The object associated with the specified key in TreeMap. 
Example 
In this example, you create and initialize a TreeMap object, and then you display element at the key number "2." 


// TreeMap-put1.jsl 
// TreeMap.put example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Create a TreeMap object: 
TreeMap tMap = new TreeMap(); 
// Add some elements: 
tMap.put("1", "Sam Abolrous"); 
tMap.put("2", "Camelia Solomon"); 
// Display the element that corresponds to the key #2: 
System.out.println("The element #2 is: " + tMap.get("2")); 
} 
i 
/ * 
Output: 
The element #2 is: Camelia Solomon 
*/ 
See Also 
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TreeMap.putAll Method 


Copies the entries of a specific map to a TreeMap object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void putAl11l( 
java.util.Map m); 


Parameters 
m 


The map to be copied. 
Example 


In this example, you create and initialize a TreeMap object, and then you copy it to another TreeMap object. 


// TreeMap-putAll1.jsl 
// TreeMap.putAll example 


import java.util.*; 


public class MyClass 
{ 
public static void main(String[] args) 
{ 
// Create two TreeMap objects: 
TreeMap tm1 = new TreeMap(); 
TreeMap tm2 = new TreeMap(); 


// Add some elements to tm1: 
tm1.put("1", "Sally Abolrous"); 
tm1.put("2", "Craig Combel"); 


// Copy tm1 to tm2: 
tm2.putAl1l(tm1) ; 


// Display the element #2 in both objects: 

System.out.println("The element #2 in tm1 is: 
+ tmi.get("2")); 

System.out.println("The element #2 in tm2 is: 
+ tm2.get("2")); 


} 


/* 

Output: 

The element #2 in tm1 is: Craig Combel 
The element #2 in tm2 is: Craig Combel 
*/ 
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TreeMap.remove Method 


Removes an entry from a TreeMap object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object remove( 
java.lang.Object k); 


Parameters 
k 

The key at which the entry is removed. 
Return Value 
The removed entry object in TreeMap. 
Example 


In this example, you create and initialize a TreeMap object, and then you remove one element from the object. 


// TreeMap-rem1.jsl 
// TreeMap.remove example 


import java.util.*; 


public class MyClass 


4 
public static void main(String[] args) 
{ 
// Create a TreeMap object: 
TreeMap tm = new TreeMap(); 
// Add some elements: 
tm.put("3","Sally Abolrous"); 
tm.put( "2", "Craig Combel"); 
tm.put("5","Pille Mandla"); 
// Remove an object: 
System.out.println("The following object has been removed: " + 
tm.remove("5"))5 
} 
} 
/* 
Output: 
The following object has been removed: Pille Mandla 
= 
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TreeMap.size Method 


Retrieves the number of key-value mappings of a TreeMap object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public int size(); 





Return Value 
An integer that represents number of key-value mappings in the TreeMap object. 
Example 


In this example, you create and initialize a TreeMap object, and then you display the number of the key-value mappings of the 
object. 





// TreeMap-size1.jsl 
// TreeMap.size example 


import java.util.*; 


public class MyClass 
{ 
public static void main(String[] args) 
if 
// Create a TreeMap object: 
TreeMap tm = new TreeMap(); 


// Add some elements: 
tm.put("1", "Sally Abolrous"); 
tm.put("2","Craig Combel"); 
tm.put("3","Pille Mandla"); 


// Display the size of the TreeMap: 


System.out.println("The size is: " + tm.size()); 


/* 
Output: 
The size is: 3 


a 
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TreeMap.subMap Method 


Creates a sub map that contains the objects within a specified range from a TreeMap object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.SortedMap subMap( 
java.lang.Object fromv, 
java.lang.Object toV); 


Parameters 
fromV 
The starting key in the TreeMap. 
toV 
The ending key in the TreeMap. 
Return Value 
A sorted map that contains the range of objects between the starting and ending keys in the TreeMap object. 
Example 


In this example, you create and initialize a TreeMap object, and then you create a subMap object from the original object. 


// TreeMap-submap1.jsl 
// TreeMap.subMap example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
if 
// Create a TreeMap object: 
TreeMap tm = new TreeMap(); 
// Add some elements: 
tm.put("1", "Sally Abolrous"); 
tm.put("2","Craig Combel"); 
tm.put("3","Pille Mandla"); 
// Display the SortedMap: 
System.out.println(tm.subMap("1","3")); 
} 
Hy 
/* 
Output: 
{1=Sally Abolrous, 2=Craig Combel} 
7 / 
Remarks 


The starting key is included in the range, but the ending key is excluded. 
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TreeMap.tailMap Method 


Retrieves a partial map whose keys are greater than or equal to a specific key in a TreeMap object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.SortedMap tailMap( 
java.lang.Object fromv); 


Parameters 
fromV 


The lowest key of the tailMap object 
Return Value 
A sorted map that contains the entries greater than or equal to fromV. 
Example 


In this example, you create and initialize a TreeMap object, and then you create a tailMap object from the original object. 


// TreeMap-tailm1.jsl 
// TreeMap.tailMap example 


import java.util.*; 


public class MyClass 
4 


public static void main(String[] args) 


{ 
// Create a TreeMap object: 
TreeMap tm = new TreeMap(); 


// Add some elements: 
tm.put( "1", "Sally Abolrous"); 
tm.put("2","Craig Combel"); 
tm.put("3","Pille Mandla"); 


// Display the tailMap: 
System.out.println("The tail map is:\n" + tm.tailMap("2")); 


} 


/* 

Output: 

The tail map is: 

{2=Craig Combel, 3=Pille Mandla} 
= 
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TreeMap.traverse Method 


NOTE: This Method is now obsolete. 
Traverses a TreeMap object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void traverse(); 
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TreeMap.values Method 


Retrieves a collection of values in a TreeMap object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Collection values(); 


Return Value 
The collection of values contained in the TreeMap object. 
Example 


In this example, you create and initialize a TreeMap object, and then you display the values contained in the object. 


// TreeMap-vla1.jsl 
// TreeMap.values example 


import java.util.*; 


public class MyClass 
{ 


public static void main(String[] args) 


{ 
// Create a TreeMap object: 
TreeMap tm = new TreeMap(); 


// Add some elements: 
tm.put( "1", "Sally Abolrous"); 
tm.put("2","Craig Combel"); 
tm.put("3","Pille Mandla"); 


// Display the elements in the TreeMap object: 
System.out.println("The values are:\n" + tm.values()); 


} 


/* 

Output: 

The values are: 

[Sally Abolrous, Craig Combel, Pille Mandla] 
*/ 
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TreeSet Class 


A class that represents a sorted set of elements. The elements are sorted using the comparator provided through constructor 
or using the Comparable interface methods implemented by the elements. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public class java.util.TreeSet 


extends java.util.AbstractSet 
implements java.util.SortedSet, java.lang.Cloneable, java.io.Serializable 








Remarks 
It is a requirement that all elements of the set must implement Comparable. 
Inheritance Hierarchy 
java.lang.Object 
java.util. AbstractCollection 
java.util AbstractSet 
java.util. TreeSet 
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TreeSet Members 


A class that represents a sorted set of elements. The elements are sorted using the comparator provided through constructor 
or using the Comparable interface methods implemented by the elements. 


The following tables list the members exposed by the TreeSet type. 


Public Constructors 


Name Description 





reeset Overloaded Creates a new TreeSet object. 


Public Methods 























Name Description 

add Overridden. Inserts an element into a TreeSet object. 

addAll (inherited from AbstractCollection ) 

clear Overridden. Removes all the elements from a TreeSet object. 

comparator Returns the comparator used in sorting a TreeSet object. 

contains Overridden. Checks if a TreeSet object contains a specified element. 
containsAll (inherited from AbstractCollection ) 

equals (inherited from AbstractSet ) 

first Returns the first element from the sorted list of elements in a TreeSet object. 
hashCode (inherited from AbstractSet ) 

getClass (inherited from Object ) 

headSet Returns a subset of elements in a TreeSet instance that precede a specified value. 
isEmpty Overridden. Checks whether a TreeSet object is empty. 

iterator Overridden. Returns an iterator over a TreeSet object. 

last Returns the last element from the sorted list of elements in a TreeSet object. 
MemberwiseClone |Performs a shallow copy of the object. 

remove Overridden. Removes a specified element from a TreeSet object. 

removeAll (inherited from AbstractCollection ) 

retainAll (inherited from AbstractCollection ) 

size Overridden. Retrieves the number of elements in a TreeSet object. 

subSet Retrieves a partial sorted set from a TreeSet object whose elements are within a specific range. 











tailSet Returns a subset of elements in a TreeSet object that follow a specified value. 











toArray Overloaded. (inherited from AbstractCollection ) 
toString (inherited from AbstractCollection ) 
traverse Not supported. Obsolete. 





Protected Methods 
Name 


finalize (inherited from Object ) 
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TreeSet Constructor 


Creates a new TreeSet object. 


Overload List 


Name Description 


TreeSet () Creates a new TreeSet object that contains its elements sorted according to the natural order. 





TreeSet (Collection) |Creates a new TreeSet object that contains elements of a specified collection sorted according to the nat 
ural order. 





TreeSet (Comparator)|Creates a new TreeSet object whose elements are sorted according to a specific comparator. 





TreeSet (SortedSet) |Creates a new TreeSet object that contains the elements of a specified set sorted according to the same 
order. 
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TreeSet Constructor () 


Creates a new TreeSet object that contains its elements sorted according to the natural order. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.util.TreeSet(); 


Example ——________________céct___§_~" 


// Create a new TreeSet object: 
TreeSet ts = new TreeSet(); 











Remarks 
The default constructor initializes any fields to their default values. 
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TreeSet Constructor (Collection) 


Creates a new TreeSet object that contains elements of a specified collection sorted according to the natural order. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util. TreeSet( 
java.util.Collection c); 


Parameters 
c 
The collection of elements that represents the TreeSet elements. 


Example 


// TS-ctor2.jsl 
// TreeSet.#ctor example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Create and initialize a SotedSet collection: 
Set ss = new TreeSet(); 
ss.add(new Integer(3)); 
ss.add(new Integer(7)); 
ss.add(new Integer(5)); 
// Create a TreeSet object using the SotedSet collection: 
TreeSet ts = new TreeSet(ss); 
System.out.println(ts); 
} 
} 
/* 
Output: 
[3, 5, 7] 
*/ 
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TreeSet Constructor (Comparator) 


Creates a new TreeSet object whose elements are sorted according to a specific comparator. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util. TreeSet( 
java.util.Comparator comp); 


Parameters 
comp 


The comparator used to sort the elements in the TreeSet object. 
Example 
See the example on comparator. 
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TreeSet Constructor (SortedSet) 


Creates a new TreeSet object that contains the elements of a specified set sorted according to the same order. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util. TreeSet( 
java.util.SortedSet s); 


Parameters 
s 

The set that contains the elements of the TreeSet object. 
Example 


// TS-ctor4.jsl 
// TreeSet.#ctor example 


import java.util.*; 


public class MyClass 


{ 
public static void main(String[] args) 
{ 
// Create and initialize a Set collection: 
SortedSet ss = new TreeSet(); 
ss.add(new Integer(2)); 
ss.add(new Integer(6)); 
ss.add(new Integer(4)); 
// Create a TreeSet object using the SotedSet collection: 
TreeSet ts = new TreeSet(ss); 
System.out.println(ts); 
} 
} 
/* 
Output: 
[2, 4, 6] 
*/ 
See Also 
Reference 
TreeSet Class 
Concepts 


TreeSet Members 
java.util Package 


Visual J# Reference 


TreeSet Methods 


Public Methods 





Name 


Description 

















MemberwiseClone 


add Overridden. Inserts an element into a TreeSet object. 

addAll (inherited from AbstractCollection ) 

clear Overridden. Removes all the elements from a TreeSet object. 

comparator Returns the comparator used in sorting a TreeSet object. 

contains Overridden. Checks if a TreeSet object contains a specified element. 
containsAll (inherited from AbstractCollection ) 

equals (inherited from AbstractSet ) 

first Returns the first element from the sorted list of elements in a TreeSet object. 
hashCode (inherited from AbstractSet ) 

getClass (inherited from Object ) 

headSet Returns a subset of elements in a TreeSet instance that precede a specified value. 
isEmpty Overridden. Checks whether a TreeSet object is empty. 

iterator Overridden. Returns an iterator over a TreeSet object. 

last Returns the last element from the sorted list of elements in a TreeSet object. 


Performs a shallow copy of the object. 

















remove Overridden. Removes a specified element from a TreeSet object. 

removeAll (inherited from AbstractCollection ) 

retainAll (inherited from AbstractCollection ) 

size Overridden. Retrieves the number of elements in a TreeSet object. 

subSet Retrieves a partial sorted set from a TreeSet object whose elements are within a specific range. 
tailSet Returns a subset of elements in a TreeSet object that follow a specified value. 

toArray Overloaded. (inherited from AbstractCollection ) 

toString (inherited from AbstractCollection ) 

traverse Not supported. Obsolete. 








Protected Methods 
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TreeSet.add Method 


Inserts an element into a TreeSet object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean add( 
java.lang.Object e); 


Parameters 
e 

The element to be inserted into the TreeSet object. 
Return Value 
true if the element is added successfully; false otherwise. 
Example 


// TS-add1.jsl 
// TreeSet.add example 


import java.util.*; 
public class MyClass 


public static void main(String[] args) 


{ 
// Create a new TreeSet object: 
TreeSet ts = new TreeSet(); 
// Create new element objects: 
Integer x = new Integer(5); 
Integer y = new Integer(4); 
// Add the elements to the set and display it: 
System.out.println(ts.add(x)); 
System.out.println(ts.add(y)); 
} 
} 
/* 
Output 
true 
true 
/ 
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TreeSet.clear Method 


Removes all the elements from a TreeSet object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public void clear(); 





Example 


In this example, you create a TreeSet object, and then you clear it and display the set before and after the clearing. 











// TS-clear.jsl 
// TreeSet.clear example 
import java.util.*; 
public class MyClass 
{ 
public static void main() 
{ 
// Create a new TreeSet object: 
TreeSet ts = new TreeSet(); 
// Create new element objects: 
Integer x = new Integer(52); 
Integer y = new Integer(43); 
Integer z = new Integer(45); 
// Add some elements: 
ts.add(x); 
ts.add(y); 
ts.add(z); 
// Display ts: 
System.out.println(ts); 
// Clear the set: 
ts.clear(); 
// Display ts after clearing: 
System.out.println(ts); 
} 
} 
/* 
Output 
[43, 45, 52] 
[] 
*/ 
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TreeSet.comparator Method 


Returns the comparator used in sorting a TreeSet object. 
Package: java.util 
Assembly: vjslib (in vjslib.dll) 


public java.util.Comparator comparator(); 


Return Value 


A comparator or null if the TreeSet elements are sorted according to the natural order. 


Example 


// TS-Comp1.jsl 
// TreeSet.COmparator example 


import java.util.*; 
public class x 


public static void main() 


{ 


TreeSet empAgeSet = new TreeSet(new EmployeeComparator_Age()); 


String[] empNames 


{"Dilbert", "Murphy", "Don", "Wattson", "Noddy"}; 


Random rnd = new Random(); 


for(int i=@; i<empNames.length; i++) 


{ 


empAgeSet.add(new Employee(empNames[i], 18+rnd.nextInt(42), 


rnd.nextInt (Integer .MAX_VALUE))); 
D 
Iterator empIterator = empAgeSet.iterator(); 


System.out.println("Name\tAge\tPIN") ; 


while(empIterator.hasNext()) 
: 


} 


System.out.println(empIterator.next()); 


} 


class EmployeeComparator_Age implements Comparator 


{ 
public int compare(Object emp1, Object emp2) 


si 
Employee e1 = (Employee)emp1; 
Employee e2 = (Employee)emp2; 
int ret = 1; 
if(el.age == e2.age) ret = Q@; 
if(el.age < e2.age) ret = -1; 
return ret; 

} 


} 


class Employee 


x 
String name; 
int age; 


int pinNumber ; 
public Employee(String n, int a, int s) 


{ 
name = n; 
age = a; 
pinNumber = s; 
} 
public String toString() 
{ 
return name + "\t" + age + "\t" + pinNumber; 
} 
} 
/* 
Output: 


Wattson, 19, 1570241606 
Dilbert, 24, 1055022363 
Noddy, 31, 1946154285 
Einstein, 52, 467910070 
Murphy, 56, 782476970 
af 
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TreeSet.contains Method 


Checks if a TreeSet object contains a specified element. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean contains ( 
java.lang.Object e); 


Parameters 
e 
The element to search for. 
Return Value 
true if the element is found; false otherwise. 
Example 
In this example, you create and initialize a TreeSet object, and then you check to see if it contains a specified element "x". 


// TS-cont1.jsl 
// TreeSet.contains example 


import java.util.*; 


public class MyClass 


4 
public static void main() 
{ 
// Create a new TreeSet object: 
TreeSet ts = new TreeSet(); 
// Create new element objects: 
Integer x = new Integer(52); 
Integer y = new Integer(43); 
Integer z = new Integer(45); 
// Add the elements to the set: 
ts.add(x); 
ts.add(y); 
ts.add(z); 
// Check if the set contains "x": 
System.out.println(ts.contains(x)); 
} 
} 
/ * 
Output: 
true 
m/f 
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TreeSet.first Method 


Returns the first element from the sorted list of elements in a TreeSet object. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object first(); 


Return Value 


The first element in the TreeSet object. 


Example 


// TS-first.jsl 


// TreeSet. 


first example 


import java.util.*; 


public class MyClass 


public 


{ 
// 


static void main(String[] args) 


Create a new TreeSet object: 


TreeSet ts = new TreeSet(); 


// 


System.out.println("The first element: 


Add some elements: 


.add(new Integer(5)); 
.add(new Integer(4)); 
.add(new Integer(9)); 


Display the first and the last: 


" + ts.first()); 


System.out.println("The last element: " + ts.last()); 


} 
} 
/* 
Output: 


The first element: 4 
The last element: 9 


*/ 
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TreeSet.headSet Method 


Returns a subset of elements in a TreeSet instance that precede a specified value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.SortedSet headSet( 
java.lang.Object toV); 


Parameters 
toV 


The element to which the elements of the returned set are compared. 
Return Value 
A sorted set whose elements precede toV. 
Example 


In this example, you create and initialize a TreeSet object, and then you display the headSet and the tailSet objects. 


// TS-hdset1.jsl 
// TreeSet.headSet example 


import java.util.*; 


public class MyClass 
4 


public static void main(String[] args) 


{ 


// Create a new TreeSet object: 
TreeSet ts = new TreeSet(); 


// Add some elements: 

ts.add(new Integer(5)); 
ts.add(new Integer(4)); 
ts.add(new Integer(9)); 


// Display the headSet and the tailSet: 
System.out.println("The headSet: " + ts.headSet(ts.last())); 
System.out.printin("The tailSet: " + ts.tailSet(ts.last())); 


} 


/* 

Output: 

The headSet: [4,5] 
The tailSet: [9] 
m/f 


Remarks 
The returned set does not include the value toV. 
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TreeSet.isEmpty Method 


Checks whether a TreeSet object is empty. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean isEmpty(); 


Return Value 
true if the TreeSet object is empty; false otherwise. 
Example 


In this example, you create a TreeSet object, and then you clear it and display the set before and after the clearing. 


// TS-isEmp1.jsl 
// TreeSet.isEmpty example 


import java.util.*; 


public class MyClass 


{ 
public static void main() 
{ 
// Create a new TreeSet object: 
TreeSet ts = new TreeSet(); 
// Create new element objects: 
Integer x = new Integer(52); 
Integer y = new Integer(43); 
Integer z = new Integer(45); 
// Add some elements: 
ts.add(x); 
ts.add(y); 
ts.add(z); 
// Display ts: 
System.out.println("The original set: " + ts); 
// Clear the set: 
ts.clear(); 
// Check to see if the set is empty and 
// Display the empty set: 
if (ts.isEmpty()) 
System.out.println("The empty set: " + ts); 
} 
u 
/* 
Output: 


The original set: [43, 45, 52] 
The empty set: [] 
*/ 


See Also 
Reference 
TreeSet Class 
Concepts 

TreeSet Members 


java.util Package 


Visual J# Reference 


TreeSet.iterator Method 


Returns an iterator over a TreeSet object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Iterator iterator(); 


Return Value 
An iterator to be used over the TreeSet object. 
Example 


In this example, you create and initialize a TreeSet object, and then you retrieve an iterator to iterate over the elements and 
display them. 


// TS-iter1.jsl 
// TreeSet.iterator example 


import java.util.*; 


public class MyClass 
{ 
public static void main() 
if 
// Create a new TreeSet object: 
TreeSet ts = new TreeSet(); 


// Create new element objects: 
Integer x = new Integer(9); 
Integer y = new Integer(8); 
Integer z = new Integer(7); 


// Add some elements: 
ts.add(x); 
ts.add(y); 
ts.add(z); 


// Retrieve an iterator to the set: 
Iterator iter = ts.iterator(); 


// Extract and display the elements from the set. 
// Note that the elements may not follow the order in which 
// they weree added to the Set. 


while(iter.hasNext() ) 

{ 
System.out.print(iter.next() + " "); 
iter.remove() ; 


} 

/* 
Output: 
789 


*/ 


See Also 
Reference 
TreeSet Class 
Concepts 


TreeSet Members 
java.util Package 


Visual J# Reference 


TreeSet.last Method 


Returns the last element from the sorted list of elements in a TreeSet object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.lang.Object last(); 





Return Value 

The last element from the sorted list of elements in the TreeSet object. 
Example 

See the example under first. 


See Also 
Reference 
TreeSet Class 
Concepts 

TreeSet Members 
java.util Package 


Visual J# Reference 


TreeSet.remove Method 


Removes a specified element from a TreeSet object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean remove( 
java.lang.Object e); 


Parameters 
e 


The element to be removed from the TreeSet object. 
Return Value 
true if the element is successfully removed; false otherwise. 
Example 
See the example under size. 


See Also 
Reference 
TreeSet Class 
Concepts 

TreeSet Members 
java.util Package 


Visual J# Reference 


TreeSet.size Method 


Retrieves the number of elements in a TreeSet object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public int size(); 


Return Value 
The number of elements in the TreeSet object. 
Example 


In this example, you create and initialize a TreeSet object, and then you remove one element and display the size before and 
after the removal. 


// TS-size1.jsl 
// TreeSet.size example 


import java.util.*; 


public class MyClass 
{ 
public static void main(String[] args) 
if 
// Create a new TreeSet object: 
TreeSet ts = new TreeSet(); 


// Declare some Integer objects: 
Integer x = new Integer(5); 
Integer y = new Integer(213); 
Integer z = new Integer(4); 


// Add some elements: 
ts.add(x); 
ts.add(y); 
ts.add(z); 


// Display the size of the TreeSet object: 
System.out.println("The size is: " + ts.size()); 


// Remove one element: 
ts.remove(x); 


// Display the size of the TreeSet object: 
System.out.println("The new size is: " + ts.size()); 


} 


/* 

Output: 

The size is: 3 

The new size is: 2 


ef 


See Also 
Reference 
TreeSet Class 
Concepts 

TreeSet Members 
java.util Package 


Visual J# Reference 


TreeSet.subSet Method 


Retrieves a partial sorted set from a TreeSet object whose elements are within a specific range. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.SortedSet subSet( 
java.lang.Object fromv, 
java.lang.Object toV); 


Parameters 
fromV 


The lowest value in the range. 
toV 
The highest value in the range. 
Return Value 
A sorted set that contains the range from fromV to toV. 
Example 


In this example, you create and initialize a TreeSet object, and then you retrieve and display two subsets. 


// TS-subs1.jsl 
// TreeSet.subset example 


import java.util.*; 


public class MyClass 
{ 


public static void main(String[] args) 
if 
// Create a new TreeSet object: 
TreeSet ts = new TreeSet(); 


// Declare some Double objects: 
Double x = new Double(5.1); 
Double y = new Double(7.3); 
Double z = new Double(9.2); 


// Add some elements: 
ts.add(x); 
ts.add(y); 
ts.add(z); 


System.out.println("The TreeSet elements are: + 
"x=" + xX 4+ ", y=" + yt ", Z=" + Z)3 
// Display the subsets between two different elements: 
System.out.println("The subset from x to z is: " + 
ts.subSet(x,z))3; 
System.out.println("The subset from x to y is: " + 


ts.subSet(x,y))3 


} 


/* 

Output: 

The TreeSet elements are: x=5.1, y=7.3, z=9.2 
The subset from x to z is: [5.1,7.3] 

The subset from x to y is: [5.1] 


ef 





Remarks 
The fromV value is included in the range, while the toV value is excluded. 


See Also 
Reference 
TreeSet Class 
Concepts 

TreeSet Members 
java.util Package 


Visual J# Reference 


TreeSet.tailSet Method 


Returns a subset of elements in a TreeSet object that follow a specified value. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.SortedSet tailSet( 
java.lang.Object fromv); 


Parameters 
fromV 


The element to which the elements of the returned set are compared. 
Return Value 
A subset whose elements follow fromV. 
Example 
See the example under headSet. 
Remarks 
The returned subset includes the value fromV. 


See Also 
Reference 
TreeSet Class 
Concepts 

TreeSet Members 
java.util Package 


Visual J# Reference 


TreeSet.traverse Method 


NOTE: This Method is now obsolete. 
Not supported. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void traverse(); 


See Also 
Reference 
TreeSet Class 
Concepts 

TreeSet Members 
java.util Package 


Visual J# Reference 


Vector Class (J#) 


Represents a dynamic array of elements. Unlike a static array, a vector will grow in size once it has reached capacity. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public class java.util.Vector 
extends java.util.AbstractList 
implements java.lang.Cloneable, java.util.List, java.io.Serializable 


Example 


The following example demonstrates the add, clear, contains, elementAt, elements, indexOf, isEmpty, remove, set, and size 
methods of the Vector class. 


// vector_overview.jsl 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Create a Vector and add three elements to it. 
Vector v = new Vector(); 
v.add("One"); 
v.add("Two"); 
v.add("Three") ; 


// Is there an element "Two" in the Vector? 
boolean isTwo = v.contains("Two"); 
System.out.println("v contains \"Two\"? " + isTwo); 


// What element is at index 2? 
String s = (String)v.elementAt(2); 
System.out.printin("v[2] = " + s)3 


// What index is element "One" at? 
int idx = v.indexOf("One"); 


System.out.printlin("\"One\" is at index " + idx); 
// How many elements are in the Vector? 
if (!v.isEmpty()) 
{ 
System.out.println("size = " + v.size()); 
} 


// Change the element at index 1 to "Four". 
Object old1 = v.set(1, "Four"); 
System.out.println("Removed element " + old1.toString()); 


// Enumerate over the elements in the Vector. 
Enumeration e = v.elements(); 
while (e.hasMoreElements() ) 


{ 
} 


System.out.println(e.nextElement()); 


// Remove the last element in the Vector. 
s = (String)v.remove(v.size() - 1); 
System.out.println("Removed element 


+ S); 


// Clear all elements in the Vector. 


v.clear(); 
} 
} 
/* 
Output: 


v contains "Two"? true 
v[2] = Three 

"One" is at index @ 
size = 3 

Removed element Two 
One 

Four 

Three 

Removed element Three 


We 











Inheritance Hierarchy 
java.lang.Object 
java.util AbstractCollection 
java.util. AbstractList 
java.util. Vector 
java.util. Stack 


See Also 
Concepts 
Vector Members 
java.util Package 


Visual J# Reference 


Vector Members (J#) 


Represents a dynamic array of elements. Unlike a static array, a vector will grow in size once it has reached capacity. 


The following tables list the members exposed by the Vector type. 


Public Constructors 





Name Description 





Vector Overloaded. Initializes a new instance of a Vector object. 





Public Fields 
Name 


capacityIncrement 


Description 


A value representing the size to increase the vector once its capacity is reached. 





elementCount 


The number of elements currently stored in the vector. 





elementData 


An internal static array containing the elements of the vector. 





modCount 


(inherited from AbstractList ) 








Public Methods 























ensureCapacity 


equals 


Name Description 

add Overloaded. Overridden. Adds an element to the vector. 

addAll Overloaded. Overridden. Adds multiple elements to the vector at one time. 

addElement Adds an element to the end of the vector. The vector is automatically grown if there is insufficient room to 
add the element. 

capacity Returns the number of elements capable of being stored in the vector. 

clear Overridden. Removes all elements from the vector. 

contains Overridden. Determines whether the vector contains a given element. 

containsAll Overridden. Determines whether all the elements in the given collection are contained in the vector. 

copylinto Copies all the elements in the vector into an array. 

elementAt Returns the element at the specified index. The element is not removed from the vector. 

elements Returns an Enumeration object that can be used to efficiently traverse the elements in the vector. 


Determines whether the vector can hold the given number of elements. If it cannot, a new vector is created 
that is large enough to store the desired number of elements and the contents of the old vector are copied 
into the newly created vector. 


Overridden. Determines whether two vectors are equal. Two vectors are considered equal if they contain e 
xactly the same elements. 





firstElement 





Returns the first element in the vector. The element is not removed from the vector. 




















get Overridden. Returns the element at a given index. The element is not removed from the vector. 
hashCode Overridden. Provides a hash value representing this vector. 

getClass (inherited from Object ) 

indexOf Overloaded. Overridden. Returns the index of the first occurrence of a given element. 





insertElementAt 


Inserts an element into the vector at the given index. The vector is automatically grown if there is insufficie 
nt room to add the element. 








isEmpty Overridden. Determines whether the vector contains any elements. 

iterator (inherited from AbstractList ) 

lastElement Returns the last element in the vector. The element is not removed from the vector. 
lastIndexOf Overloaded. Overridden. Returns the index of the last occurrence of a given element. 
listlterator Overloaded. (inherited from AbstractList ) 





MemberwiseClone 


Performs a shallow copy of the object. 





remove 


Overloaded. Overridden. Removes an element from the vector. 





removeAll 


Overridden. Removes all the elements contained in a collection from the vector. If an element appears mor 
e than once in the vector, all instances are removed. The elements in the vector beyond these elements are 
then shifted down. 





removeAllElements/Removes all elements from the vector. 





removeElement 


removeElementAt 


Removes the first occurrence of an element from the vector. The elements in the vector beyond this eleme 
nt are then shifted down. 


Removes the element from the vector at the specified index. The elements in the vector beyond this index 
are then shifted down. 








removeRange 


retainAll 


set 


setElementAt 


Overridden. Removes all the elements from the vector starting with the element at fromlx to the element a 
t one less than tolx. 


Overridden. Removes all elements from the vector that are not contained in the given collection. 


Overridden. Sets the element at the given index to the given element. 


Sets the element at the given index to the given element. 











setSize Sets the size of the vector to the given value. If the given size is greater than the current size of the vector, t 
hen the contents of the old vector are copied into a new vector of the given size. If the given size is less tha 
n the current size of the vector, then some elements will be removed from the vector. 

size Overridden. Returns the number of elements in the vector. 

subList Overridden. Returns a List of all the elements in the vector starting with the element at fromlx to the eleme 


nt at one less than tolx. 








toArray Overloaded. Overridden. Converts a vector into a static array. 





toString Overridden. Displays a human-readable representation of a vector. 


trimToSize Changes the capacity of a vector to match its size. 





Protected Methods 





Name Description 





finalize (inherited from Object ) 














See Also 
Reference 


Vector Class 
Concepts 
java.util Package 


Visual J# Reference 


Vector Fields 


Public Fields 





Name 


Description 





capacityIncrement 


A value representing the size to increase the vector once its capacity is reached. 





elementCount 


The number of elements currently stored in the vector. 





elementData 


An internal static array containing the elements of the vector. 





modCount 





(inherited from AbstractList ) 








See Also 
Reference 
Vector Class 
Concepts 
java.util Package 





Visual J# Reference 


Vector.capacityIncrement Field 


A value representing the size to increase the vector once its capacity is reached. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


protected int capacityIncrement ; 


See Also 
Reference 
Vector Class 
Concepts 

Vector Members 
java.util Package 


Visual J# Reference 


Vector.elementCount Field 


The number of elements currently stored in the vector. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


protected int elementCount; 


See Also 
Reference 
Vector Class 
Concepts 

Vector Members 
java.util Package 


Visual J# Reference 


Vector.elementData Field 


An internal static array containing the elements of the vector. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


protected java.lang.Object[] elementData; 


See Also 
Reference 
Vector Class 
Concepts 

Vector Members 
java.util Package 


Visual J# Reference 


Vector Constructor 


Initializes a new instance of a Vector object. 


Overload List 
Name Description 


Vector () Initializes a new instance of a Vector object. 
Vector (Collection)|Initializes a new instance of a Vector object with the elements in the given collection. 
Vector (int) Initializes a new instance of a Vector object to the given size. 


Vector (int, int) Initializes a new instance of a Vector object to the given size. You can also specify an amount representing t 
he size to increment the vector once it reaches capacity. 





See Also 
Reference 


Vector Class 
Concepts 

Vector Members 
java.util Package 





Visual J# Reference 


Vector Constructor () 


Initializes a new instance of a Vector object. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.util.Vector(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 
Reference 
Vector Class 
Concepts 

Vector Members 
java.util Package 


Visual J# Reference 


Vector Constructor (Collection) 


Initializes a new instance of a Vector object with the elements in the given collection. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Vector ( 
java.util.Collection c); 


Parameters 
Cc 


A collection whose elements are to be copied into the vector. The initial size of the vector is set to the same size as this 
collection. Only a shallow copy of these elements is performed. 


See Also 
Reference 
Vector Class 
Concepts 

Vector Members 
java.util Package 


Visual J# Reference 


Vector Constructor (Int32) 


Initializes a new instance of a Vector object to the given size. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Vector( 
int initSize); 


Parameters 
initSize 
The initial size of the vector. 


See Also 
Reference 
Vector Class 
Concepts 

Vector Members 
java.util Package 


Visual J# Reference 


Vector Constructor (Int32, Int32) 


Initializes a new instance of a Vector object to the given size. You can also specify an amount representing the size to increment 
the vector once it reaches capacity. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Vector( 
int initSize, 
int increment); 


Parameters 
initSize 

The initial size of the vector. 
increment 


The amount to increase the vector once it reaches capacity. 


See Also 
Reference 
Vector Class 
Concepts 

Vector Members 
java.util Package 


Visual J# Reference 


Vector Methods 


Public Methods 





























Name Description 

add Overloaded. Overridden. Adds an element to the vector. 

addAll Overloaded. Overridden. Adds multiple elements to the vector at one time. 

addElement Adds an element to the end of the vector. The vector is automatically grown if there is insufficient room to 
add the element. 

capacity Returns the number of elements capable of being stored in the vector. 

clear Overridden. Removes all elements from the vector. 

contains Overridden. Determines whether the vector contains a given element. 

containsAll Overridden. Determines whether all the elements in the given collection are contained in the vector. 

copylinto Copies all the elements in the vector into an array. 

elementAt Returns the element at the specified index. The element is not removed from the vector. 

elements Returns an Enumeration object that can be used to efficiently traverse the elements in the vector. 





ensureCapacity 


Determines whether the vector can hold the given number of elements. If it cannot, a new vector is created 
that is large enough to store the desired number of elements and the contents of the old vector are copied 
into the newly created vector. 





equals 


firstElement 


Overridden. Determines whether two vectors are equal. Two vectors are considered equal if they contain e 
xactly the same elements. 


Returns the first element in the vector. The element is not removed from the vector. 


get Overridden. Returns the element at a given index. The element is not removed from the vector. 
hashCode Overridden. Provides a hash value representing this vector. 

getClass (inherited from Object ) 

indexOf Overloaded. Overridden. Returns the index of the first occurrence of a given element. 


insertElementAt 


Inserts an element into the vector at the given index. The vector is automatically grown if there is insufficie 
nt room to add the element. 


isEmpty Overridden. Determines whether the vector contains any elements. 

iterator (inherited from AbstractList ) 

lastElement Returns the last element in the vector. The element is not removed from the vector. 
lastindexOf Overloaded. Overridden. Returns the index of the last occurrence of a given element. 











listlterator 


remove 


removeAll 


removeElement 


removeElementAt 


Overloaded. (inherited from AbstractList ) 


MemberwiseClone |Performs a shallow copy of the object. 


Overloaded. Overridden. Removes an element from the vector. 


Overridden. Removes all the elements contained in a collection from the vector. If an element appears mor 
e than once in the vector, all instances are removed. The elements in the vector beyond these elements are 
then shifted down. 


removeAllElements|/Removes all elements from the vector. 


Removes the first occurrence of an element from the vector. The elements in the vector beyond this eleme 
nt are then shifted down. 


Removes the element from the vector at the specified index. The elements in the vector beyond this index 
are then shifted down. 





removeRange 


retainAll 


set 


setElementAt 


Overridden. Removes all the elements from the vector starting with the element at fromlx to the element a 
t one less than tolx. 


Overridden. Removes all elements from the vector that are not contained in the given collection. 
Overridden. Sets the element at the given index to the given element. 


Sets the element at the given index to the given element. 











setSize Sets the size of the vector to the given value. If the given size is greater than the current size of the vector, t 
hen the contents of the old vector are copied into a new vector of the given size. If the given size is less tha 
n the current size of the vector, then some elements will be removed from the vector. 

size Overridden. Returns the number of elements in the vector. 

subList Overridden. Returns a List of all the elements in the vector starting with the element at fromlx to the eleme 
nt at one less than tolx. 

toArray Overloaded. Overridden. Converts a vector into a static array. 

toString Overridden. Displays a human-readable representation of a vector. 

trimToSize Changes the capacity of a vector to match its size. 





Name 


finalize 





Protected Methods 





Description 


(inherited from Object ) 








See Also 
Reference 
Vector Class 
Concepts 
java.util Package 


Visual J# Reference 


Vector.add Method 


Adds an element to the vector. 


Overload List 


Name Description 


Vector.add (Object) |Adds an element to the end of the vector. The vector is automatically grown if there is insufficient room 


to add the element. 








Vector.add (int, Object)|Adds an element to the vector at the specified index. The vector is automatically grown if there is insuffi 
cient room to add the element. 





See Also 
Reference 
Vector Class 
Concepts 

Vector Members 
java.util Package 





Visual J# Reference 


Vector.add Method (Object) 


Adds an element to the end of the vector. The vector is automatically grown if there is insufficient room to add the element. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized boolean add( 
java.lang.Object e); 


Parameters 
e 
The element to add to the end of the vector. 
Return Value 
true if the element was successfully added to the vector; false otherwise. 
Example 


The following example creates a Vector object and appends three elements to it. 
// vector_add.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
, 
// Create a Vector and add three elements to it. 
Vector v = new Vector(); 
v.add("One"); 
v.add("Two"); 
v.add("Three") ; 
// Display the contents of the Vector. 
Enumeration vEnum = v.elements(); 
while (vEnum.hasMoreElements() ) 
{ 
System.out.println(vEnum.nextElement()); 
} 
} 
} 
/ * 
Output 
One 
Two 
Three 
*/ 
See Also 
Reference 
Vector Class 
Concepts 


Vector Members 
java.util Package 


Visual J# Reference 


Vector.add Method (Int32, Object) 


Adds an element to the vector at the specified index. The vector is automatically grown if there is insufficient room to add the 
element. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void add( 
int ix, 
java.lang.Object e); 


Parameters 
ix 


The position within the vector to add the element. 


The element to add to the vector. 
Example 
The following example creates a Vector object and adds three elements to it at the specified indices. 
// vector_add_2.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a Vector and add three elements to it. 
// Order should be "Orange", "Banana", "Apple". 
Vector v = new Vector(); 
v.add(@, "Apple"); 
v.add(®, "Orange"); 
v.add(1, "Banana"); 
// Display the contents of the Vector. 
Enumeration vEnum = v.elements(); 
while (vEnum.hasMoreElements() ) 
{ 
System.out.println(vEnum.nextElement()); 
} 
} 
} 
/ * 
Output: 
Orange 
Banana 
Apple 
* ff 
See Also 
Reference 
Vector Class 
Concepts 


Vector Members 
java.util Package 
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Vector.addAll Method 


Adds multiple elements to the vector at one time. 


Overload List 
Name 





Vector.addAll (Collection) Adds all the elements in the collection to the vector. The vector is automatically grown if there is i 


nsufficient room to add the elements. 









Vector.addAll (int, Collection)|Adds all the elements in the collection to the vector starting at the specified index. The vector is a 
utomatically grown if there is insufficient room to add the elements. 





See Also 
Reference 
Vector Class 
Concepts 

Vector Members 
java.util Package 





Visual J# Reference 


Vector.addAll Method (Collection) 


Adds all the elements in the collection to the vector. The vector is automatically grown if there is insufficient room to add the 
elements. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized boolean addA11( 
java.util.Collection c); 


Parameters 
Cc 


The elements to be added to the collection. Only a shallow copy of these elements is performed. 
Return Value 
true if all the elements were successfully added to the vector; false otherwise. 
Example 


The following example adds all the elements of a LinkedList object into a Vector object. 


// vector_addall.jsl 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Create a LinkedList and add three elements to it. 
LinkedList 11 = new LinkedList(); 
ll.add("Linked List Element 1"); 
ll.add("Linked List Element 2"); 
ll.add("Linked List Element 3"); 


// Create a Vector containing the same elements as the 
// LinkedList. 
Vector v = new Vector(11); 


// Display the contents of the Vector. 
Enumeration vEnum = v.elements(); 
while (vEnum.hasMoreElements()) 


{ 
} 


System.out.println(vEnum.nextElement()); 


} 


/* 

Output: 

Linked List Element 1 
Linked List Element 2 
Linked List Element 3 
*/ 


See Also 
Reference 
Vector Class 
Concepts 

Vector Members 


java.util Package 
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Vector.addAll Method (Int32, Collection) 


Adds all the elements in the collection to the vector starting at the specified index. The vector is automatically grown if there is 
insufficient room to add the elements. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized boolean addA11( 
int ix, 
java.util.Collection c); 


Parameters 
ix 


The position within the vector to add the first element. All subsequent elements in the collection are added immediately after 
this index. 


The elements to be added to the collection. Only a shallow copy of these elements is performed. 
Return Value 
true if all the elements were successfully added to the vector; false otherwise. 
Example 


The following example adds all the elements of a LinkedList object into a Vector object at a specified index. 


// vector_addall_ 2.jsl 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Create a LinkedList and add three elements to it. 
LinkedList 11 = new LinkedList(); 
ll.add( "Linked List Element A"); 
ll.add("Linked List Element B"); 
ll.add("Linked List Element C"); 


// Create a Vector and add three elements to it. 
Vector v = new Vector(); 

v.add("Vector Element 1"); 

v.add("Vector Element 2"); 

v.add("Vector Element 3"); 


// Add the contents of the LinkedList to the Vector 
// at index 1 (after element "Vector Element 1"). 
v.addAl1(1, 11); 


// Display the contents of the Vector. 
Enumeration vEnum = v.elements(); 
while (vEnum.hasMoreElements() ) 


{ 
} 


System.out.println(vEnum.nextElement()); 


f* 


Output: 

Vector Element 1 
Linked List Element A 
Linked List Element B 
Linked List Element C 
Vector Element 2 
Vector Element 3 


*/ 





See Also 
Reference 
Vector Class 
Concepts 

Vector Members 
java.util Package 
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Vector.addElement Method 


Adds an element to the end of the vector. The vector is automatically grown if there is insufficient room to add the element. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final synchronized void addElement( 
java.lang.Object o); 


Parameters 
oO 


The element to add to the end of the vector. 
Example 
The following example creates a Vector object and appends three elements to it. 
// vector_addelement.jsl 
import java.util.*; 
public class Program 


public static void main(String[] args) 


{ 
// Create a Vector and add three elements to it. 
Vector v = new Vector(); 
v.addElement("One") ; 
v.addElement ("Two") ; 
v.addElement ("Three") ; 
// Display the contents of the Vector. 
Enumeration vEnum = v.elements(); 
while (vEnum.hasMoreElements() ) 
{ 
System.out.println(vEnum.nextElement()); 
ie 
i 
i 
/* 
Output: 
One 
Two 
Three 
*/ 
See Also 
Reference 
Vector Class 
Concepts 


Vector Members 
java.util Package 
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Vector.capacity Method 


Returns the number of elements capable of being stored in the vector. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final int capacity(); 


Return Value 
The number of elements capable of being stored in the vector. 
Example 


The following example creates a Vector object, appends three elements to it, and then displays the capacity. 
// vector_capacity.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a Vector and add three elements to it. 
Vector v = new Vector(); 
v.add("Dog"); 
v.add("Cat"); 
v.add("Monkey") ; 
// Display the contents of the Vector. 
Enumeration vEnum = v.elements(); 
while (vEnum.hasMoreElements() ) 
‘ 
System.out.println(vEnum.nextElement()); 
} 
// Display the capacity of the Vector. 
// Note that this is not the size of the Vector. 
System.out.println("capacity = " + v.capacity()); 
} 
} 
/ * 
Output: 
Dog 
Cat 
Monkey 
Capacity = 10 
=f 
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Vector.clear Method 


Removes all elements from the vector. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void clear(); 


Example 

The following example shows how to clear the contents of a Vector object. 
// vector_clear.jsl 
import java.util.*; 
public class Program 


public static void main(String[] args) 


if 
// Create a Vector and add three elements to it. 
Vector v = new Vector(); 
v.add("A"); 
v.add("B"); 
v.add("C"); 
// Display the contents of the Vector. 
Enumeration vEnum = v.elements(); 
while (vEnum.hasMoreElements()) 
{ 
System.out.println(vEnum.nextElement()); 
} 
// Clear the Vector and display its size. 
v.clear(); 
System.out.println("size = " + v.size()); 
} 
ij 
/ * 
Output 
A 
B 
C 
size = @ 
*/ 
See Also 
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Vector.clone Method 


Creates a new instance of a Vector object that is a shallow copy of the existing vector. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





Return Value 
A new instance of a Vector object that is a shallow copy of the existing vector. 


See Also 
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Vector.contains Method 


Determines whether the vector contains a given element. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean contains ( 
java.lang.Object elem); 


Parameters 
elem 
The element to search the vector for. 
Return Value 
The index of the element in the vector, or -1 if the element is not contained in the vector. 
Example 


The following example shows how to determine if a Vector contains a given element. 
// vector_contains.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a Vector and add three elements to it. 
Vector v = new Vector(); 
Date d1 = new Date(105, Calendar.JANUARY, 1); 
Date d2 = new Date(); 
Date d3 = new Date(105, Calendar.APRIL, 15); 
Date d4 = new Date(99, Calendar.DECEMBER, 31); 
v.add(d1); 
v.add(d2); 
v.add(d3); 
// Determine which of the four Date objects exist in 
// the Vector. 
boolean containsD1 = v.contains(d1); 
boolean containsD2 = v.contains(d2); 
boolean containsD3 = v.contains(d3); 
boolean containsD4 = v.contains(d4); 
System.out.println("v contains d1? " + containsD1); 
System.out.println("v contains d2? " + containsD2) ; 
System.out.println("v contains d3? " + containsD3); 
System.out.println("v contains d4? " + containsD4) ; 
} 
} 
/* 
Output: 


v contains d1? true 
v contains d2? true 
v contains d3? true 
v contains d4? false 


*/ 
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Vector.containsAll Method 


Determines whether all the elements in the given collection are contained in the vector. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized boolean containsA11l( 
java.util.Collection c); 


Parameters 
c 
The collection containing the elements to search the vector for. 
Return Value 
true if all the elements in the collection are contained in the vector; false otherwise. 
Example 


The following example shows how to determine if a Vector contains all the elements of two LinkedList objects. 
// vector_containsall.jsl 
import java.util.*; 


public class Program 


{ 

public static void main(String[] args) 

if 
// Create two LinkedList objects and a Vector object 
// containing random Dates. 
Date d1 = new Date(105, Calendar.JANUARY, 1); 
Date d2 = new Date(); 
Date d3 = new Date(105, Calendar.APRIL, 15); 
Date d4 = new Date(99, Calendar.DECEMBER, 31); 
LinkedList list1 = new LinkedList(); 
list1.add(d1); 
list1.add(d2); 
list1.add(d3); 
list1.add(d4); 
LinkedList list2 = new LinkedList(); 
list2.add(d1); 
Vector v = new Vector(); 
v.add(d1); 
v.add(d2); 
v.add(d3); 
// Determine whether the Vector contians all the objects 
// in the two LinkedList objects. 
boolean containsAllList1 = v.containsAll(list1); 
boolean containsAllList2 = v.containsAll(list2); 
System.out.println("v contains all list1? " + 

containsAllList1) ; 
System.out.println("v contains all list2? " + 
containsAl1List2); 
} 


/* 

Output: 

v contains all listi? false 
v contains all list2? true 


*/ 
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Vector.copylnto Method 


Copies all the elements in the vector into an array. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final synchronized void copyInto( 
java.lang.Object[] objArray); 


Parameters 
objArray 


An array to store the elements of the vector. The array must be greater than or equal to the size of the vector. Only a shallow 
copy of the elements is performed. 


Example 

The following example shows how to copy all the contents of a Vector object into a static array. 
// vector_copyinto.jsl 
import java.util.*; 


public class Program 


+ 
public static void main(String[] args) 
{ 
// Create a Vector and add three elements to it. 
Vector v = new Vector(); 
v.add(new SimpleTimeZone(-28800000, "PST")); 
v.add(new SimpleTimeZone(-14490000, "EST")); 
v.add(new SimpleTimeZone(@, "GMT")); 
// Create a static array to contain the elements of 
// the Vector. 
TimeZone[] tzArr = new TimeZone[3]; 
v.copyInto(tzArr) ; 
// Display the contents of the static array. 
for (int i = @; i < tzArr.length; i++) 
{ 
System. out.println(tzArr[i].getID()); 
} 
} 
/ * 
Output: 
PST 
EST 
GMT 
of 
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Vector.elementAt Method 


Returns the element at the specified index. The element is not removed from the vector. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final synchronized java.lang.Object elementAt( 
int index); 


Parameters 
index 
The index of the element to be retrieved. This value must be less than the overall length of the vector. 
Return Value 
The element present at the specified index of the vector. 
Example 


The following example shows how to retrieve the element at a given index in the Vector object. 
// vector_elementat.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a Vector and add three elements to it. 
Vector v = new Vector(); 
v.add("One"); 
v.add("Two"); 
v.add("Three") ; 
// Display the contents of the Vector. 
for (int i = @; i < v.size(); i++) 
{ 
System.out.println(v.elementAt(i) ); 
H 
} 
} 
/ * 
Output 
One 
Two 
Three 
m/f 
See Also 
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Vector.elements Method 


Returns an Enumeration object that can be used to efficiently traverse the elements in the vector. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final synchronized java.util.Enumeration elements(); 


Return Value 
An Enumeration object that can be used to efficiently traverse the elements in the vector. 
Example 


The following example shows how to traverse a Vector object using an Enumeration. 
// vector_elements.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a Vector and add three elements to it. 
// Order should be "Orange", "Banana", "Apple". 
Vector v = new Vector(); 
v.add(@, "Apple"); 
v.add(®, "Orange"); 
v.add(1, "Banana"); 
// Display the contents of the Vector. 
Enumeration vEnum = v.elements(); 
while (vEnum.hasMoreElements() ) 
{ 
System.out.println(vEnum.nextElement()); 
} 
} 
} 
/ * 
Output: 
Orange 
Banana 
Apple 
*/ 
See Also 
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Vector.ensureCapacity Method 


Determines whether the vector can hold the given number of elements. If it cannot, a new vector is created that is large enough 
to store the desired number of elements and the contents of the old vector are copied into the newly created vector. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final synchronized void ensureCapacity( 
int minCapacity); 


Parameters 
minCapacity 
The desired number of elements to store in the vector. 


Example 


The following example shows one way to manually grow a Vector object once its capacity is reached using ensureCapacity. 
// vector_ensurecapacity.jsl 
import java.util.*; 


public class Program 


+ 
public static void main(String[] args) 
{ 
// Create a Vector and add three elements to it. 
Vector v = new Vector(3); 
v.add(new SimpleTimeZone(-28800000, "PST")); 
v.add(new SimpleTimeZone(-14400000, "EST")); 
v.add(new SimpleTimeZone(@, "GMT")); 
// Grow the Vector if it is full. 
if (v.capacity() == v.size()) 
{ 
v.ensureCapacity(v.size() * 2); 
} 
// Display the capacity of the Vector. 
System.out.println("new capacity = " + v.capacity()); 
} 
} 
/ * 
Output: 
new capacity = 6 
ay A 
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Vector.equals Method 


Determines whether two vectors are equal. Two vectors are considered equal if they contain exactly the same elements. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized boolean equals( 
java.lang.Object obj); 


Parameters 


obj 
The collection to compare for equality with the vector. 
Return Value 
true if the provided collection contains exactly the same elements as the vector; false otherwise. 
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Vector.firstElement Method 


Returns the first element in the vector. The element is not removed from the vector. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final synchronized java.lang.Object firstElement(); 


Return Value 

The first element in the vector. 

Example 

The following example shows how to retrieve the first element in a Vector. 
// vector_firstelement.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a Vector and add three elements to it. 
Vector v = new Vector(); 
v.add("First Element"); 
v.add("Second Element") ; 
v.add("Third Element") ; 
// Display the first element of the Vector. 
System.out.println(v.firstElement()); 
} 
} 
LF 
Output: 
First Element 
*/ 
See Also 
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Vector.get Method 


Returns the element at a given index. The element is not removed from the vector. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized java.lang.Object get( 
int ix); 


Parameters 
ix 
The index of the element to retrieve. This value must be less than the number of elements in the vector. 
Return Value 
The element at the given index in the vector. 
Example 


The following example shows how to retrieve the element at a given index in the Vector object. 
// vector_get.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a Vector and add three elements to it. 
Vector v = new Vector(); 
v.add("One"); 
v.add("Two"); 
v.add("Three") ; 
// Display the contents of the Vector. 
for (int i = @3; i < v.size(); i++) 
{ 
System.out.printin(v.get(i)); 
H 
} 
} 
/ * 
Output 
One 
Two 
Three 
m/f 
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Vector.hashCode Method 


Provides a hash value representing this vector. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized int hashCode(); 


Return Value 
A hash value representing this vector. 


See Also 
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Vector.indexOf Method 


Returns the index of the first occurrence of a given element. 


Overload List 
Name 


Vector.indexOf (Object) 








Description 


Returns the index of the first occurrence of a given element. 


Vector.indexOf (Object, int)/Returns the index of the first occurrence of a given element. The vector is searched starting from th 





See Also 
Reference 
Vector Class 
Concepts 

Vector Members 
java.util Package 





Visual J# Reference 


Vector.indexOf Method (Object) 


Returns the index of the first occurrence of a given element. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public int indexOf( 
java.lang.Object obj); 


Parameters 
obj 
The element to search the vector for. 
Return Value 
The index of the first occurrence of the given element. 
Example 


The following example shows how to determine the index of an object in a Vector. 
// vector_indexof.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a Vector and add three elements to it. 
Vector v = new Vector(); 
Date d1 = new Date(105, Calendar.JANUARY, 1); 
Date d2 = new Date(); 
Date d3 = new Date(105, Calendar.APRIL, 15); 
Date d4 = new Date(99, Calendar.DECEMBER, 31); 
v.add(d1); 
v.add(d2); 
v.add(d3); 
// Determine the indices of the various Date objects 
// in the Vector. 
int indexD1 = v.indexOf(d1); 
int indexD2 = v.indexOf(d2); 
int indexD3 = v.indexOf(d3); 
int indexD4 = v.indexOf(d4); 
System.out.printin("v contains d1 at index " + indexD1); 
System.out.println("v contains d2 at index " + 
System.out.println("v contains d3 at index " + 
System.out.println("v contains d4 at index " + 
} 
} 
/* 
Output: 


v contains di at index 
v contains d2 at index 
v contains d3 at index 
v contains d4 at index -1 


*/ 


NF ® 


indexD2); 
indexD3); 
indexD4) ; 
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Vector.indexOf Method (Object, Int32) 


Returns the index of the first occurrence of a given element. The vector is searched starting from the given index. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized int indexOFf( 
java.lang.Object obj, 
int index); 


Parameters 


obj 
The element to search the vector for. 
index 


Represents the index of the element in the vector to start the search. This value must be less than the number of elements in 
the vector. 


Return Value 
The index of the first occurrence of the given element after the starting index. 
Example 


The following example shows how to determine all the indices of an object in a Vector. 


// vector_indexof_2.jsl 
import java.util.*; 


public class Program 


{ 


public static void main(String[] args) 

{ 
// Create a Vector and add three elements to it. 
Vector v = new Vector(); 


Date d1 = new Date(105, Calendar.JANUARY, 1); 
Date d2 = new Date(); 

Date d3 = new Date(105, Calendar.APRIL, 15); 
Date d4 = new Date(99, Calendar.DECEMBER, 31); 


.add(d1); 
.add(d2); 
.add(d3); 
.add(d1); 
.add(d3); 


<<<<< 


// Determine all the indices of a Date object 
// in the Vector. 

int currIndex = @; 

while (true) 


currIndex = v.indexOf(d1, currIndex) ; 
if (currIndex == -1) 

break; 
else 


i 


System.out.println("v contains d1 at index " + currIndex); 


currIndex++; 


} 


/* 

Output: 

v contains d1 at index @ 
v contains d1 at index 3 
*/ 
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Vector.insertElementAt Method 


Inserts an element into the vector at the given index. The vector is automatically grown if there is insufficient room to add the 
element. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final synchronized void insertElementAt( 
java.lang.Object obj, 
int index); 


Parameters 
obj 
The element to insert into the vector. 
index 
The index to insert the element into. This value must be less than the number of elements in the vector. 
Example 


The following example creates a Vector object and adds three elements to it at the specified indices. 
// vector_insertelementat.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a Vector and add three elements to it. 
// Order should be "Orange", "Banana", "Apple". 
Vector v = new Vector(); 
v.insertElementAt("Apple", @); 
v.insertElementAt("Orange", 0); 
v.insertElementAt("Banana", 1); 
// Display the contents of the Vector. 
Enumeration vEnum = v.elements(); 
while (vEnum.hasMoreElements() ) 
{ 
System. out.print1ln(vEnum.nextElement() ); 
} 
} 
} 
/ * 
Output: 
Orange 
Banana 
Apple 
* ff 
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Vector.isEmpty Method 


Determines whether the vector contains any elements. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final boolean isEmpty(); 


Return Value 
true if the vector contains no elements; false otherwise. 
Example 


The following example checks to see if a Vector object is empty before enumerating over its contents. 
// vector_isempty.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a Vector and add three elements to it. 
Vector v = new Vector(); 
v.add("1"); 
v.add("2"); 
v.add("3"); 
// Display the contents of the Vector if it is not empty. 
if (!v.isEmpty()) 
{ 
Enumeration vEnum = v.elements(); 
while (vEnum.hasMoreElements() ) 
{ 
System.out.println(vEnum.nextElement()); 
} 
} 
} 
} 
/* 
Output: 
1 
2 
3 
te / 
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Vector.lastElement Method 


Returns the last element in the vector. The element is not removed from the vector. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final synchronized java.lang.Object lastElement(); 


Return Value 

The last element in the vector. 

Example 

The following example shows how to retrieve the last element in a Vector. 
// vector_lastelement.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a Vector and add three elements to it. 
Vector v = new Vector(); 
v.add("First Element"); 
v.add("Second Element") ; 
v.add("Third Element"); 
// Display the last element of the Vector. 
System.out.printin(v.lastElement()); 
} 
} 
/* 
Output: 
Third Element 
*/ 
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Vector.lastindexOf Method 


Returns the index of the last occurrence of a given element. 


Overload List 


Name Description 


Vector.lastIndexOf (Object) Returns the index of the last occurrence of a given element. 





Vector.lastIndexOf (Object, int)/Returns the index of the last occurrence of a given element. The vector is searched starting fro 
m the beginning until the given index. 
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Vector.lastIndexOf Method (Object) 


Returns the index of the last occurrence of a given element. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public int lastIndexOf( 
java.lang.Object obj); 


Parameters 


obj 
The element to search the vector for. 
Return Value 
The index of the last occurrence of the given element. 
Example 


The following example shows how to determine the last index of an object in a Vector. 


// vector_lastindexof.jsl 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
if 
// Create a Vector and add six elements to it. 
Vector v = new Vector(); 


Date d1 = new Date(105, Calendar.JANUARY, 1); 
Date d2 = new Date(); 

Date d3 = new Date(105, Calendar.APRIL, 15); 
Date d4 = new Date(99, Calendar.DECEMBER, 31); 


.add(d1); 
.add(d2); 
.add(d3); 
.add(d3); 
.add(d2); 
.add(d1); 


<<<<<< 


// Determine the last index of the various Date objects 
// in the Vector. 

int indexD1 = v.lastIndexOf(d1); 

int indexD2 = v.lastIndexOf(d2); 

int indexD3 = v.lastIndexOf(d3); 

int indexD4 = v.lastIndexOf(d4); 


System.out.println("v contains d1 at last index of " + 
indexD1) ; 

System.out.println("v contains d2 at last index of " + 
indexD2) ; 

System.out.println("v contains d3 at last index of " + 
indexD3) ; 

System.out.println("v contains d4 at last index of " + 
indexD4) ; 


/* 

Output: 

v contains di 
v contains d2 
v contains d3 
v contains d4 


nL 





at last 
at last 
at last 
at last 


index 
index 
index 
index 


of 5 
of 4 
of 3 
of -1 
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Vector.lastIndexOf Method (Object, Int32) 


Returns the index of the last occurrence of a given element. The vector is searched starting from the beginning until the given 
index. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized int lastIndexOf( 
java.lang.Object obj, 
int index); 


Parameters 


obj 
The element to search the vector for. 
index 


Represents the index of the element in the vector to end the search. The search is started from the beginning of the vector. 
This value must be less than the number of elements in the vector. 


Return Value 
The index of the last occurrence of the given element before the ending index. 
Example 


The following example shows how to determine all the indices of an object in a Vector in reverse order. 


// vector_lastindexof_2.jsl 
import java.util.*; 


public class Program 
if 
public static void main(String[] args) 
1 
// Create a Vector and add five elements to it. 
Vector v = new Vector(); 


Date d1 = new Date(105, Calendar.JANUARY, 1); 
Date d2 = new Date(); 

Date d3 = new Date(105, Calendar.APRIL, 15); 
Date d4 = new Date(99, Calendar.DECEMBER, 31); 


.add(d1); 
.add(d2); 
.add(d3); 
.add(d1); 
.add(d3); 


<<<<< 


// Determine all the indices of a Date object 
// in the Vector. 

int currIndex = v.size() - 1; 

while (true) 


currIndex = v.lastIndexOf(d1, currIndex) ; 
if (currIndex == -1) 

break; 
else 


{ 


System.out.println("v contains d1 at index 
currIndex--; 


+ currIndex) ; 


} 
} 
} 
/* 
Output: 


v contains d1 at index 3 
v contains d1 at index 0 


a 





See Also 
Reference 
Vector Class 
Concepts 

Vector Members 
java.util Package 





Visual J# Reference 


Vector.remove Method 


Removes an element from the vector. 


Overload List 


Name Description 







Removes the element from the vector at the specified index. The elements in the vector beyond this in 
dex are then shifted down. 


Vector.remove (int) 





Vector.remove (Object)|Removes the first occurrence of an element from the vector. The elements in the vector beyond this ele 
ment are then shifted down. 
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Vector.remove Method (Int32) 


Removes the element from the vector at the specified index. The elements in the vector beyond this index are then shifted 
down. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object remove( 
int ix); 


Parameters 
ix 
The index of the element to be removed from the vector. This value must be less than the number of elements in the vector. 
Return Value 
The element at the specified index. 
Example 


The following example shows how to remove an element at a given index from a Vector. 
// vector_remove.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
{ 
// Create a Vector and add three elements to it. 
Vector v = new Vector(); 
v.add("One"); 
v.add("Two"); 
v.add("Three") ; 
// Remove the element at index 1. 
v.remove(1); 
// Display the contents of the Vector. 
Enumeration vEnum = v.elements(); 
while (vEnum.hasMoreElements() ) 
{ 
System.out.println(vEnum.nextElement()); 
i; 
i 
} 
/ * 
Output: 
One 
Three 
* 
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Vector.remove Method (Object) 


Removes the first occurrence of an element from the vector. The elements in the vector beyond this element are then shifted 
down. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean remove( 
java.lang.Object e); 


Parameters 
e 


The element to be removed from the vector. 
Return Value 
true if the element was successfully removed; false otherwise. 
Example 


The following example shows how to remove a given element from a Vector. 


// vector_remove_2.jsl 
import java.util.*; 


public class Program 


{ 


public static void main(String[] args) 


{ 


// Create a Vector and add three elements to it. 
Vector v = new Vector(); 


Date d1 
Date d2 
Date d3 
Date d4 


new Date(105, Calendar.JANUARY, 1); 
new Date(); 

new Date(105, Calendar.APRIL, 15); 
new Date(99, Calendar.DECEMBER, 31); 


v.add(d1); 
v.add(d2); 
v.add(d3); 


// Remove d1 and d4 from the Vector. 
boolean diRemoved = v.remove(d1); 
boolean d4Removed = v.remove(d4); 


// Display the results of the remove operation. 
System.out.println("d1 successfully removed? " + diRemoved) ; 
System.out.println("d4 successfully removed? " + d4Removed) ; 


/* 

Output: 

d1 successfully removed? true 
d4 successfully removed? false 


*/ 


See Also 
Reference 
Vector Class 


Concepts 
Vector Members 
java.util Package 
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Vector.removeAll Method 


Removes all the elements contained in a collection from the vector. If an element appears more than once in the vector, all 
instances are removed. The elements in the vector beyond these elements are then shifted down. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized boolean removeA11( 
java.util.Collection c); 


Parameters 
Cc 


A collection of elements to be removed from the vector. 
Return Value 
true if at least one element in the collection was removed from the vector; false otherwise. 
Example 


The following example shows how to remove all elements in a LinkedList from a Vector. 


// vector_removeall.jsl 
import java.util.*; 


public class Program 
{ 
public static void main(String[] args) 
{ 
// Create a LinkedList and add three elements to it. 
LinkedList 11 = new LinkedList(); 
ll.add("Linked List Element A"); 
ll.add("Linked List Element B"); 
ll.add("Linked List Element C"); 


// Create a Vector and add three elements to it. 
Vector v = new Vector(); 

v.add("Vector Element 1"); 

v.add("Vector Element 2"); 

v.add("Vector Element 3"); 


// Add the contents of the LinkedList to the Vector 
// at index 1 (after element "Vector Element 1"). 
v.addAl1(1, 11); 


// Now remove all the elements in the LinkedList from 
// the Vector. 
v.removeAl1(11); 


// Display the contents of the Vector. 
Enumeration vEnum = v.elements(); 
while (vEnum.hasMoreElements() ) 


i 
} 


System.out.println(vEnum.nextElement()); 


} 


/* 
Output: 
Vector Element 1 


Vector Element 2 
Vector Element 3 
a | 





See Also 
Reference 
Vector Class 
Concepts 

Vector Members 
java.util Package 
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Vector.removeAllElements Method 


Removes all elements from the vector. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final synchronized void removeAllElements(); 


Example 

The following example shows how to clear the contents of a Vector object. 
// vector_removeallelements.jsl 
import java.util.*; 
public class Program 


public static void main(String[] args) 


{ 
// Create a Vector and add three elements to it. 
Vector v = new Vector(); 
v.add("A"); 
v.add("B"); 
v.add("C"); 
// Display the contents of the Vector. 
Enumeration vEnum = v.elements(); 
while (vEnum.hasMoreElements() ) 
{ 
System.out.println(vEnum.nextElement()); 
} 
// Clear the Vector and display its size. 
v.removeAllElements(); 
System.out.println("size = " + v.size()); 
} 
H 
/ * 
Output 
A 
B 
C 
size = @ 
*/ 
See Also 
Reference 
Vector Class 
Concepts 


Vector Members 
java.util Package 
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Vector.removeElement Method 


Removes the first occurrence of an element from the vector. The elements in the vector beyond this element are then shifted 
down. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final synchronized boolean removeElement( 
java.lang.Object obj); 


Parameters 


obj 
The element to be removed from the vector. 
Return Value 
true if the element was successfully removed from the vector; false otherwise. 
Example 


The following example shows how to remove a given element from a Vector. 


// vector_removeelement.jsl 
import java.util.*; 


public class Program 


{ 


public static void main(String[] args) 


{ 


// Create a Vector and add three elements to it. 
Vector v = new Vector(); 


Date d1 
Date d2 
Date d3 
Date d4 


new Date(105, Calendar.JANUARY, 1); 
new Date(); 

new Date(105, Calendar.APRIL, 15); 
new Date(99, Calendar.DECEMBER, 31); 


v.add(d1); 
v.add(d2); 
v.add(d3); 


// Remove d1 and d4 from the Vector. 
boolean diRemoved = v.removeElement(d1); 
boolean d4Removed = v.removeElement(d4); 


// Display the results of the remove operation. 
System.out.println("d1 successfully removed? " + diRemoved) ; 
System.out.println("d4 successfully removed? " + d4Removed) ; 


/* 

Output: 

d1 successfully removed? true 
d4 successfully removed? false 


*/ 


See Also 
Reference 
Vector Class 


Concepts 
Vector Members 
java.util Package 
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Vector.removeElementAt Method 


Removes the element from the vector at the specified index. The elements in the vector beyond this index are then shifted 
down. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final synchronized void removeElementAt( 
int index); 


Parameters 
index 


The index of the element to be removed from the vector. This value must be less than the number of elements in the vector. 
Example 
The following example shows how to remove an element at a given index from a Vector. 
// vector_removeelementat.jsl 
import java.util.*; 


public class Program 


+ 
public static void main(String[] args) 
{ 
// Create a Vector and add three elements to it. 
Vector v = new Vector(); 
v.add("One"); 
v.add("Two"); 
v.add("Three"); 
// Remove the element at index 1. 
v.removeElementAt (1); 
// Display the contents of the Vector. 
Enumeration vEnum = v.elements(); 
while (vEnum.hasMoreElements() ) 
{ 
System.out.println(vEnum.nextElement()); 
} 
} 
} 
/® 
Output 
One 
Three 
* / 
See Also 
Reference 
Vector Class 
Concepts 


Vector Members 
java.util Package 
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Vector.removeRange Method 


Removes all the elements from the vector starting with the element at fromlx to the element at one less than tolx. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


protected void removeRange( 
int fromIx, 
int toIx); 


Parameters 
fromlx 


The index of the first element to be removed from the vector. This value must be less than the number of elements in the 
vector. 


tolx 


The index one greater than the last element to be removed from the vector. This value must be greater than from|x and less 
than the number of elements in the vector. 


See Also 
Reference 
Vector Class 
Concepts 

Vector Members 
java.util Package 
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Vector.retainAll Method 


Removes all elements from the vector that are not contained in the given collection. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized boolean retainAl1l( 
java.util.Collection c); 


Parameters 
Cc 


The collection of elements that are to be retained in the vector. All elements not in this collection are removed from the 
vector. 


Return Value 
true if at least one element was removed from the vector; false otherwise. 
Example 


The following example shows how to retain all the elements in a Vector that are contained in a LinkedList, and to dispose of all 
other elements in the Vector. 


// vector_retainall.jsl 
import java.util.*; 


public class Program 


{ 


public static void main(String[] args) 
{ 
// Create a LinkedList and add three elements to it. 
LinkedList 11 = new LinkedList(); 
ll.add("A"); 
ll.add("B"); 
ll.add("C"); 


// Create a Vector containing the same elements as the 
// LinkedList and more. 

Vector v = new Vector(); 

v.add("A"); 

-add("B"); 

-add("C"); 

.add("D"); 

.add("E"); 


<<<< 


// Retain only those elements found in the LinkedList. 
v.retainAl1(11); 


// Display the contents of the Vector. 
Enumeration vEnum = v.elements(); 
while (vEnum.hasMoreElements() ) 


{ 
} 


System.out.println(vEnum.nextElement()); 


Output: 


C 
*/ 


See Also 
Reference 
Vector Class 
Concepts 

Vector Members 
java.util Package 
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Vector.set Method 


Sets the element at the given index to the given element. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized java.lang.Object set( 
int ix, 
java.lang.Object e); 


Parameters 
x 


The index in the vector where the element is to be set. 


The element to set at the given index in the vector. 
Return Value 
The element that was at the given index before the element was changed. 
Example 


The following example shows how to set an element at a given index in the Vector. 
// vector_set.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
ii 
// Create a Vector and add some elements to it. 
Vector v = new Vector(); 
v.add("One"); 
v.add("Two"); 
v.add("Three") ; 
// Change the element at index 1. 
Object oldTwo = v.set(1, "Four"); 
// Display the contents of the Vector. 
Enumeration vEnum = v.elements(); 
while (vEnum.hasMoreElements() ) 
{ 
System.out.println(vEnum.nextElement()); 
} 
} 
} 
/ * 
Output 
One 
Four 
Three 
af 
See Also 
Reference 


Vector Class 


Concepts 
Vector Members 
java.util Package 
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Vector.setElementAt Method 


Sets the element at the given index to the given element. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final synchronized void setElementAt( 
java.lang.Object obj, 
int index); 


Parameters 
obj 

The element to set at the given index in the vector. 
index 

The index in the vector where the element is to be set. 
Example 


The following example shows how to set an element at a given index in the Vector. 
// vector_setelementat.jsl 
import java.util.*; 


public class Program 


4 
public static void main(String[] args) 
{ 
// Create a Vector and add some elements to it. 
Vector v = new Vector(); 
v.add("1"); 
v.add("2"); 
v.add("3"); 
// Change the element at index 1. 
v.setElementAt("4", 1); 
// Display the contents of the Vector. 
Enumeration vEnum = v.elements(); 
while (vEnum.hasMoreElements() ) 
{ 
System.out.println(vEnum.nextElement()); 
} 
} 
} 
/ * 
Output: 
1 
4 
3 
*/ 
See Also 
Reference 
Vector Class 
Concepts 


Vector Members 
java.util Package 
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Vector.setSize Method 


Sets the size of the vector to the given value. If the given size is greater than the current size of the vector, then the contents of 
the old vector are copied into a new vector of the given size. If the given size is less than the current size of the vector, then 
some elements will be removed from the vector. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final synchronized void setSize( 
int newSize); 


Parameters 
newSize 


The new size of the vector. 
Example 
The following example shows how to shrink a Vector object by decreasing its size. 
// vector_setsize.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a Vector and add some elements to it. 
Vector v = new Vector(); 
v.add("Dog"); 
v.add("Cat"); 
v.add("Bird"); 
// Change the size of the Vector. 
v.setSize(2); 
// Display the contents of the Vector. 
Enumeration vEnum = v.elements(); 
while (vEnum.hasMoreElements() ) 
{ 
System.out.println(vEnum.nextElement()); 
} 
} 
} 
/* 
Output: 
Dog 
Cat 
+f 
See Also 
Reference 
Vector Class 
Concepts 


Vector Members 
java.util Package 
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Vector.size Method 


Returns the number of elements in the vector. 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final int size(); 


Return Value 


The number of elements in the vector. 


Example 


The following example shows how to determine the size of a Vector. 


// vector_size.jsl 


import java.util.*; 


public class Program 


{ 


public static void main(String[] args) 


A 


See Also 
Reference 


Vector Class 


Concepts 


// Create a LinkedList and add three elements to it. 
LinkedList 11 = new LinkedList(); 

ll.add("A"); 

ll.add("B"); 

ll.add("C"); 


// Create a Vector containing the same elements as the 
// LinkedList and more. 

Vector v = new Vector(); 

v.add("A"); 

v.add("B"); 

v.add("C"); 

v.add("D"); 

v.add("E"); 

// Retain only those elements found in the LinkedList. 
v.retainAl1(11); 


// Display the size of the Vector. 
System.out.println("size = " + v.size()); 


Vector Members 
java.util Package 
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Vector.subList Method 


Returns a List of all the elements in the vector starting with the element at fromlx to the element at one less than tolx. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.List subList( 
int fromIx, 
int toIx); 


Parameters 
fromlx 


The index of the first element in the vector to be inserted into the List. This value must be less than the number of elements 
in the vector. 


tolx 


The index one greater than the last element in the vector to be inserted into the List. This value must be greater than fromlx 
and less than the number of elements in the vector. 


Return Value 
A List object containing the elements in the given range. 
Example 


The following example shows hw to return a sub-list of the elements in a Vector. 
// vector_sublist.jsl 
import java.util.*; 


public class Program 


1 

public static void main(String[] args) 

{ 
// Create a Vector and add four elements to it. 
Vector v = new Vector(); 
Date d1 = new Date(105, Calendar.JANUARY, 1); 
Date d2 = new Date(); 
Date d3 = new Date(105, Calendar.APRIL, 15); 
Date d4 = new Date(99, Calendar.DECEMBER, 31); 
v.add(d1); 
v.add(d2); 
v.add(d3); 
v.add(d4) ; 
// Get a sublist of the elements in the range [1, 3). 
List 1 = v.subList(1, 3); 
// Display the elements in the List. 
Iterator iter = l.iterator(); 
while (iter.hasNext()) 
{ 

System.out.printlin(iter.next()); 

} 

: 

} 


f* 


Output: 
Thu Sep @9 18:08:03 PDT 2004 


Fri Apr 15 00:00:00 PDT 2005 
| 





See Also 
Reference 
Vector Class 
Concepts 

Vector Members 
java.util Package 
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Vector.toArray Method 


Converts a vector into a static array. 


Overload List 


Name Description 


Converts a vector into a static array. 


Converts a vector into a static array. 





See Also 
Reference 
Vector Class 
Concepts 

Vector Members 
java.util Package 
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Vector.toArray Method () 


Converts a vector into a static array. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized java.lang.Object[] toArray(); 


Return Value 
A static array containing the elements of the vector. This array represents a shallow copy of the original vector. 
Example 


The following example shows how to populate a static array with the contents of a Vector. 
// vector_toarray.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a Vector and add three elements to it. 
Vector v = new Vector(); 
v.add(new SimpleTimeZone(-28800000, "PST")); 
v.add(new SimpleTimeZone(-14400000, "EST")); 
v.add(new SimpleTimeZone(@, "GMT")); 
// Create a static array to contain the elements of 
// the Vector. 
Object[] tzArr = new TimeZone[v.size()]; 
tzArr = v.toArray(); 
// Display the contents of the static array. 
for (int i = @; i < tzArr.length; i++) 
{ 
System.out.println(((SimpleTimeZone)tzArr[i]).getID()); 
} 
} 
} 
/ * 
Output: 
PST 
EST 
GMT 
af 
See Also 
Reference 
Vector Class 
Concepts 


Vector Members 
java.util Package 
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Vector.toArray Method (Object[ ]) 


Converts a vector into a static array. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public synchronized java.lang.Object[] toArray( 
java.lang.Object[] arr); 


Parameters 
arr 
The array to add the elements of the vector to. 
Return Value 
A static array containing the elements of the vector. This array represents a shallow copy of the original vector. 
Example 


The following example shows how to populate a static array with the contents of a Vector. 
// vector_toarray_2.jsl 
import java.util.*; 


public class Program 


{ 
public static void main(String[] args) 
if 
// Create a Vector and add three elements to it. 
Vector v = new Vector(); 
v.add(new SimpleTimeZone(-28800000, "PST")); 
v.add(new SimpleTimeZone(-14400000, "EST")); 
v.add(new SimpleTimeZone(@, "GMT")); 
// Create a static array to contain the elements of 
// the Vector. 
Object[] tzArr = new TimeZone[v.size()]; 
tzArr = v.toArray(tzArr); 
// Display the contents of the static array. 
for (int i = @; i < tzArr.length; i++) 
{ 
System. out.print1ln(((SimpleTimeZone)tzArr[i]).getID()); 
} 
} 
} 
/ * 
Output 
PST 
EST 
GMT 
*/ 
See Also 
Reference 
Vector Class 
Concepts 


Vector Members 
java.util Package 
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Vector.toString Method 


Displays a human-readable representation of a vector. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final synchronized java.lang.String toString(); 


Return Value 
A human-readable representation of a vector. 


See Also 
Reference 
Vector Class 
Concepts 

Vector Members 
java.util Package 
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Vector.trimToSize Method 


Changes the capacity of a vector to match its size. 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public final synchronized void trimToSize(); 


Example 

The following example shows how to trim a Vector to the number of elements it contains. 
// vector_trimtosize.jsl 
import java.util.*; 
public class Program 


public static void main(String[] args) 


{ 
// Create a Vector and add three elements to it. 
Vector v = new Vector(2@); 
v.add("One"); 
v.add("Two"); 
v.add("Three") ; 
// Trim the Vector from a capacity of 20 to 3. 
v.trimToSize(); 
// Display the capacity of the Vector. 
System.out.println("capacity = " + v.capacity()); 
} 
} 
/ * 
Output: 
capacity = 3 
+] 
See Also 
Reference 
Vector Class 
Concepts 


Vector Members 
java.util Package 
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WeakHashMap Class 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public class java.util.WeakHashMap 
extends java.util.AbstractMap 
implements java.util.Map 





Inheritance Hierarchy 
java.lang.Object 
java.util AbstractMap 
java.util. WeakHashMap 


See Also 

Concepts 

WeakHashMap Members 
java.util Package 
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WeakHashMap Members 


The following tables list the members exposed by the WeakHashMap type. 


Public Constructors 
Name 


WeakHashMap 


Public Methods 








Name 


Description 





clear 


Overridden. 





containsKey 


containsValue 


entrySet 


equals 


get 


hashCode 


getClass 


isEmpty 


keySet 


clone 


put 


putAll 


remove 


size 


toString 


values 





Overridden. 


(inherited from AbstractMap ) 


Overridden. 


(inherited from AbstractMap ) 


Overridden. 


(inherited from AbstractMap ) 


(inherited from Object ) 


Overridden. 


(inherited from AbstractMap ) 


(inherited from AbstractMap ) 


Overridden. 


(inherited from AbstractMap ) 


Overridden. 


Overridden. 


(inherited from AbstractMap ) 


(inherited from AbstractMap ) 





Protected Methods 
Name 


finalize 





See Also 
Reference 


WeakHashMap Class 





Description 


(inherited from Object ) 
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WeakHashMap Constructor 


Overload List 





Name 


Description 





WeakHashMap () 





WeakHashMap (int) 





WeakHashMap (int, float) 








See Also 

Reference 
WeakHashMap Class 
Concepts 

WeakHashMap Members 
java.util Package 
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WeakHashMap Constructor () 


Initializes a new instance of the WeakHashMap Class . 
Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public java.util.WeakHashMap(); 





Remarks 
The default constructor initializes any fields to their default values. 


See Also 

Reference 
WeakHashMap Class 
Concepts 

WeakHashMap Members 
java.util Package 
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WeakHashMap Constructor (Int32) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.WeakHashMap( 
int initCap); 


Parameters 
initCap 


See Also 

Reference 
WeakHashMap Class 
Concepts 

WeakHashMap Members 
java.util Package 
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WeakHashMap Constructor (Int32, Single) 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.WeakHashMap( 
int initCap, 
float loadFactor) ; 


Parameters 
initCap 


loadFactor 


See Also 

Reference 
WeakHashMap Class 
Concepts 

WeakHashMap Members 
java.util Package 
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WeakHashMap Methods 


Public Methods 






































Name Description 

clear Overridden. 

containsKey Overridden. 

containsValue (inherited from AbstractMap ) 
entrySet Overridden. 

equals (inherited from AbstractMap ) 
get Overridden. 

hashCode (inherited from AbstractMap ) 
getClass (inherited from Object ) 
isEmpty Overridden. 

keySet (inherited from AbstractMap ) 
clone (inherited from AbstractMap ) 
put Overridden. 

putAll (inherited from AbstractMap ) 
remove Overridden. 

size Overridden. 

toString (inherited from AbstractMap ) 
values (inherited from AbstractMap ) 
Protected Methods 

Name Description 

finalize (inherited from Object ) 

See Also 

Reference 


WeakHashMap Class 
Concepts 
java.util Package 
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WeakHashMap.clear Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public void clear(); 


See Also 

Reference 
WeakHashMap Class 
Concepts 

WeakHashMap Members 
java.util Package 
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WeakHashMap.containsKey Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean containsKey( 
java.lang.Object k); 


Parameters 


k 


See Also 

Reference 
WeakHashMap Class 
Concepts 

WeakHashMap Members 
java.util Package 
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WeakHashMap.entrySet Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.util.Set entrySet(); 


See Also 

Reference 
WeakHashMap Class 
Concepts 

WeakHashMap Members 
java.util Package 
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WeakHashMap.get Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object get( 
java.lang.Object k); 





Parameters 
k 


See Also 

Reference 
WeakHashMap Class 
Concepts 

WeakHashMap Members 
java.util Package 
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WeakHashMap.isEmpty Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public boolean isEmpty(); 


See Also 

Reference 
WeakHashMap Class 
Concepts 

WeakHashMap Members 
java.util Package 
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WeakHashMap.put Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object put( 
java.lang.Object k, 
java.lang.Object v); 


Parameters 


k 


See Also 

Reference 
WeakHashMap Class 
Concepts 

WeakHashMap Members 
java.util Package 
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WeakHashMap.remove Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 


public java.lang.Object remove( 
java.lang.Object k); 


Parameters 


k 


See Also 

Reference 
WeakHashMap Class 
Concepts 

WeakHashMap Members 
java.util Package 
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WeakHashMap.size Method 


Package: java.util 


Assembly: vjslib (in vjslib.dll) 





public int size(); 





See Also 

Reference 
WeakHashMap Class 
Concepts 
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java.util Package 
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Visual J# Samples 


This section contains sample abstracts for the Visual J# samples. The sample abstracts include a link to open or copy the 
sample's source files. Each sample comes with a solution (.sIn) file, so the sample can be opened, built, and debugged in the 
Visual Studio development environment. 


In This Section 
Application Samples 


Samples that are modeled after complete applications that you might develop. 
Cross-Language Samples 

Samples that use components developed in other languages. 
Technology Samples 


Samples that illustrate individual technologies and language features such as platform invocation, loading resources, 
security, attributes, events, delegates, and more. 


Visual J# Advanced Application Samples 


Samples that are modeled after complete applications that you might develop. These samples illustrate more complex 
applications than those found in Visual J# Application Samples. 


Visual J# Advanced Cross-Language Samples 
Contains links to samples that are ported from samples in other languages. 
Visual J# Advanced Technology Samples 


Samples that illustrate the various technologies and features in the .NET Framework and in Visual J#. The intent is to instruct 
on a single technology or a few related technologies. 


Related Sections 
.NET Framework Samples 


Provide instruction on aspects of the NET Framework and the .NET Compact Framework. 


Visual J# Samples 


Visual J# Application Samples 


The samples in this section are modeled after complete applications that you might develop. These samples illustrate more 
complete error handling and object-oriented development than other Visual J# samples. 





Sample __ Description 





Dice Illustrates how to consume C# classes from Visual J#. 





TypeFinder |Provides a command line interface to get information about types from user's environment. This sample also prov 
ides general information about reflection. 


WinTalk — |Offers a brief introduction to Windows Forms and Sockets including other FCL topics. The sample is a very simple 
Sockets Chat application. 





WordCount/Offers an introduction to the .NET Framework class library. Provides an application that counts words in a text file 
and organizes the results according to command-line arguments. 














Related Sections 
Visual J# Samples 
Visual J# Technology Samples 


Visual J# Cross-Language Samples 


Visual J# Samples 


Dice Sample (Consume C# Classes) 


Download sample 
This sample illustrates how to consume C# classes from Visual J# by means of the following: 
e Implementing an interface (defined in C#) on a Visual J# class. 
e Handling exceptions thrown from a C# class, in Visual J#. 
e Examining properties exposed by a C# class, in Visual J#. 
e Sinking events raised by a C# class in Visual J#. 
The cscServer project implements a die (the kind used in games). 


The number of sides (faces) on the die can be set programmatically. The die is rolled by the Roll method. The Roll operation 
returns the number on the top face of the die. 


The die uses the interface IRoll to perform the roll operation. Clients are required to provide an implementation of this 
interface. The client is required to set this interface on the die before invoking a Roll method on the die. 


If the die is constructed with an invalid number of sides (for example, the number of sides being less than or equal to 0), the die 
throws a BadDieSizeException. If the Roll method on the die is invoked prior to the number of sides being set, the die 
throws a NullReferenceException exception. 


The die exposes a read-only property (NumSides) that can be used to inspect the number of sides for the die. 
Every time an implementation of the IRoll interface is set on the die, it raises the LoadedDice event. 
The Dice project does the following: 

e Provides implementations for the IRoll interface. 

e Catches both the exceptions thrown. 

e Examines the NumSides property. 


e Provides a delegate object to sink the events raised by the die. 





aSecurity Note 





This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 
te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 











Building and Running the Sample 
To open the sample file in Solution Explorer 
1. Click Download Sample. 
The File Download message box appears. 
2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 
3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 
4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build from the development environment 


e@ On the Build menu, click Build Solution, or press CTRL+SHIFT+B. 
-Or- 


From the command line, type BUILD.bat. 





Note 





For more information, see Building from the Command Line (Visual J#). 











To run this sample 


e From the development environment, press F5. 
-Or- 


From the command line, type Dice and press ENTER. 


See Also 
Other Resources 


Visual J# Application Samples 


Visual J# Samples 


TypeFinder Sample (Get Type Information) 


Download sample 


This sample provides a command-line interface to get information about types in the environment. Sometimes locating a 
specific type's namespace or DLL can be difficult, and once you locate the type, the documentation may be unavailable or out 
of date. This utility provides a simple way to determine what types are available, what module they are in, and what interfaces, 
methods, fields, properties, and events are available on the type. This sample also provides an introduction to reflection. 


This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 


te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 





Building and Running the Sample 
To open the sample file in Solution Explorer 
1. Click Download Sample. 
The File Download message box appears. 
2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 
3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 
4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build and run the sample from the development environment 
1. On the Build menu, click Build Solution, or press CTRL+SHIFT+B. 
2. Press F5 to run the sample. 

To build and run the sample from the command line 


1. Type BUILD.bat. 


Note 


For more information, see Building from the Command Line (Visual J#). 





2. Type TypeFinder, and press ENTER. 
3. To find the location of each type with a word in its name, type TypeFinder word from the command line. 
Classes and Technologies in the Sample 


The following classes and technologies are used in this sample. 


Reflection 





Class/Technology Description 





Assembly Loads assemblies into the AppDomain so that they can be searched for types. 














Module Gets types from the assembly or module for comparison to the search string. 





























Type Gets type information such as name, namespace, and members. 

Propertylnfo Finds information about properties in types. 

Eventinfo Finds information about events in types. 

FieldInfo Finds information about fields in types. 

MethodInfo Finds information about methods in types. 

1/0 

Class/Technology |Description 

TextWriter Used by the Indentedwriter sample type to output (to the console, by default) in a generic fashion. 
Text 


Class/Technology |Description 


StringBuilder Used by the IndentedWriter sample type to create a string. 
String Used throughout the sample to find format strings, find substrings, uppercase strings, for example. 
Collections 


Class/Technology Description 








ArrayList Used by the sample to manage a list of strings. 

Registry 

Class/Technology |Description 

Registry Used to create an instance of the Regist ryKey type for a subkey of the LocalMachine key. 
RegistryKey Used to read values from a key in the registry. 

See Also 


Other Resources 
Visual J# Application Samples 





Visual J# Samples 


WinTalk Sample (Introduces Windows Forms and Sockets) 


Download sample 


This sample offers a brief introduction to Windows Forms and Sockets including other Framework Class Library (FCL) topics. 
The sample is a very simple Sockets Chat application. 


aSecurity Note 


This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 


te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 





Building and Running the Sample 
To open the sample file in Solution Explorer 


1. Click Download Sample. 
The File Download message box appears. 

2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 

3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 

4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build this sample 


e@ On the Build menu, click Build Solution, or press CTRL+SHIFT+B. 
-Or- 


From the command line, type BUILD.bat. 





Note 





For more information, see Building from the Command Line (Visual J#). 











To run this sample 


1. Type WinTalk.exe /? in the command line for a complete list of command line options for the utility. 


2. To try the sample where the client and the server are on the same machine, simply run the application twice with no 
parameters. 


3. When specifying a port number, verify that port is not already in use by another program; otherwise, the sample will not 
run correctly. Try using a high port number between 5001 and 5150. 


4. For the sample to function properly, your Path, Include, and Lib environment variables must be set correctly. You can 
set these variables by running vsVars.bat, located in the <SDKRoot>\Bin directory. vsVars.bat must be executed in every 
command shell. 


Classes and Technologies in the Sample 
The following classes and technologies are used in this sample. 


Windows Forms 





Class/Tec |Description 
hnology 


Applicati |Used by the sample application to implement a message pump. 
on 





Splitter |Control type that handles splitter semantics. Used in the application to separate the send and receive text frames. 





Panel Allows for flexible organizing, docking, and anchoring of controls on a form. In this case, the panel contains the two 
text boxes and the splitter. The status control, on the other hand, is a peer to the panel. 


TextBox {Implements two edit controls in the sample. One is read-only for receiving text. 


Label Used to display static status information in the sample. 


Message [Used by the sample to relay information about errors and shutdown situations. 
Box 





Networking 

Class/Te |Description 
chnolog 
y 


IPEndPo |Used by the sample to encapsulate an IP address and port number. 
int 





IPAddre |Provides useful IPAddress-related logic. 
ss 


Dns Used to get an IP address from a DNS name. 


Socket |Most networking implemented in managed code is done using an abstraction such as XML Web services. However, i 
tis possible to implement socket code directly, and this sample uses the Socket class to do so. 





Network(|Derived from stream, and uses a socket as its underlying device. This makes it very useful for streaming data over a 
Stream _|socket. You can use the NetworkStream type just like you would use any other stream type, such as FileStream. 





1/0 

Class/Technology Description 

StreamWriter Used to write to the network stream that represents a socket. 
StreamReader Used to read from the network stream that represents a socket. 


Garbage Collection 


Class/Technology Description 


GC Used to suppress finalization of a custom object that has already been disposed. 





Delegates 

Class/Te |Description 
chnolog 
y 





Multicas |This sample implements a delegate type derived from MulticastDelegate. This type is used for notifications relate 
tDelegat |d to network events. The sample uses this delegate type to bind the networking type to the form type in the sample 
e 














Threading 





Class/ |Description 
Techn 


ology 





Threa |The custom Talker class in this sample handles networking logic and uses a second thread for reading from the netwo 
dPool |rk. However, rather than creating a thread, it simply uses a thread from the common language runtime thread pool. Th 
is is the suggested method for multithreading in managed code. 








Exceptions 

Class/ |Description 
Techn 

ology 








IOExce|The StreamReader and StreamWriter types commonly throw the IOException type. However, to catch and handle t 
ption |hese exceptions properly, it is commonly necessary to check the attached exception that reflects the more base error. | 
n this sample's case this will be the SocketException type. 





Socket|This sample catches the SocketException type and checks the ErrorCode property of the socket for certain expected 
Exceptierror types. 
ion 











Command-Line Requirements 


For the Visual J# samples to function properly when building and running from the command line, your Path environment 
variable must be set correctly. You must set the Path variable to include the <%windir%>\Microsoft 
.NET\Framework\v<%version%> directory. Additionally, you may also need to run CorVars.bat (located in the 
<.NETFrameworkSDKRoot>\Bin directory). 


See Also 
Other Resources 
Visual J# Application Samples 


Visual J# Samples 


WordCount Sample (Introduction to .NET Framework Class 
Library) 


Download sample 


This sample offers an introduction to the INET Framework class library. It shows how to create an application that opens 
multiple files (specified on the command line) and counts each file's size (in bytes), characters, words, and lines. The results 
from each file and the total of all files are displayed. 


aSecurity Note 


This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 


te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 





Building and Running the Sample 
To open the sample file in Solution Explorer 
1. Click Download Sample. 
The File Download message box appears. 
2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 
3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 
4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build and run this sample from the development environment 
1. On the Build menu, click Build Solution, or press CTRL+SHIFT+B. 
2. -Press F5 to run the sample. 

To build and run this sample from the command line 


1. Type BUILD.bat. 


Note 


See Building from the Command Line (Visual J#) for more information. 





2. Type WordCount and press ENTER. 


3. To count the words in a file, type WordCount filename. 


Classes and Technologies in the Sample 
The following classes and technologies are used in this sample. 
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Class/Techn |Description 








FileStream Used for file access. This class is used to read to and write from files. 





StreamWriter |Used when the command-line arguments request that the output be sent to a file. The StreamWriter is used in 
conjunction with a FileStream instance to format text output to a file. 





StreamReader|Used to read the contents of a file for which the sample is counting words. The StreamReader is used in conju 
nction with a FileStream instance to read text from a file. 

















Collections 

Class/Technology Description 

ArrayList Used as a general collection class for storing sets of objects. 

SortedList Used as a collection class for storing sets of objects in a sorted manner. 
[IEnumerator Used directly to enumerate over sets of objects. 

IDictionaryEnumerator Used directly to enumerate over indexed sets of objects. 

See Also 


Other Resources 
Visual J# Application Samples 


Visual J# Samples 


Visual J# Cross-Language Samples 


The samples in this section are ported from samples in other languages. 


In This Section 
Sample 


Delegates Sample (Custom Delegates) 


Description 


Illustrates use of the delegates in 
Visual C++. A delegate is create 

d over a method defined in a DL 
L created with Visual J#. 





ManagedEvents Sample (Demonstrates Creating and Using Events in a Managed Application) 


Demonstrates event handling int 
eroperability between Managed 
Extensions for C++ and Visual J 
# objects. The Visual J# code im 
plements both an event source a 
nd an event receiver. 





TilePuzzle Sample: Visual J# and Managed Extenstions for C++ Interoperability 





Related Sections 
Visual J# Samples 
Visual J# Application Samples 


Visual J# Technology Samples 





Demonstrates interoperability b 
etween managed components ( 

written with Managed Extension 
s for C++ and Visual J#) and nat 
ive components (written with C 

++ using COM attributes). 





Visual J# Samples 


Delegates Sample (Custom Delegates) 


Download sample 
This sample implements two uses of a delegate (single-cast and multicast) using the _ delegate keyword. 


The sample also demonstrates interoperability between a Visual C++ application and a Visual J# DLL (jsde1). The Visual J# 
DLL implements a basic Visual J# class (jsde1) with a custom method. 





aSecurity Note 





This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 
te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 








Building and Running the Sample 
To open the sample file in Solution Explorer 


1. Click Download Sample. 
The File Download message box appears. 

2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 

3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 

4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build and run this sample using Visual Studio 
1. In Solution Explorer, right-click the Delegates solution. 
2. On the shortcut menu, click Build Solution. 
3. On the Debug menu, click Start. 
When the sample is built and run, single-cast and multicast delegates are created and invoked: 
@ pSCDelegate 


A single-cast delegate is created and then the bound method is invoked. The confirmation is a printed string with the 
value passed by the single-cast delegate. 


@ pMCDelegate 


Before creating the multicast delegate, the Visual J# class (jsdel) is first instantiated. The delegate is then bound to both 


the Visual J# and managed class methods and invoked. The confirmation is a printed string with the value passed by the 
multicast delegate. 


See Also 
Other Resources 


Visual J# Cross-Language Samples 





Visual J# Samples 


ManagedEvents Sample (Demonstrates Creating and Using 
Events in a Managed Application) 


Download sample 


This sample demonstrates event handling interoperability between Visual C++ and Visual J# objects. 
Building and Running the Sample 
To open the sample file in Solution Explorer 


1. Click Download Sample. 
The File Download message box appears. 

2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 

3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 

4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build and run the solution 


1. Right-click the Receiver node in Solution Explorer, and select Set as Startup Project. 

2. From the Build menu, click Build Solution. 

3. From the Debug menu, click Start Without Debugging. 

4. The sample can also be run with JSEvent as startup project. Set JSEvent as the startup project. 

5. Right-click the JSEvent project and select Properties. On the General tab, choose the Console Application output type. 


6. Build and run the sample. 


How the Sample Works 


The code creates two event sources: A Visual C++ event source Event (see Event.cpp) and a Visual J# event source JSEvent 
(see JSEventjsl). It also creates two event receivers: A Visual C++ event receiver Receiver (see Receiver.cpp), and a Visual J# 
event receiver JR2 (see JSEventjsl). 


The Visual C++ event source Event declares two events: MyEvent and MyEvent2 The Visual J# event source JEvent declares 
one event: JMyEvent. 


The Visual C++ event receiver Receiver hooks: 


@ Event: :MyEvent to the event handler methods Handleri and Handler2 





@ Event: :MyEvent2 to the event handler method Handler5 





@ JEvent::JMyEvent to the event handler methods Handler3 and Handler4 








The Visual J# event receiver JR2 hooks: 


@ JEvent::JMyEvent to the event handler methods H1 and H2 











@ Event: :MyEvent to the event handler methods 43 and H4 





The main code in Receiver.cpp instantiates the event sources and the Visual C++ event receiver. Then, it calls methods to hook 
the event handlers to the event sources and also to fire these events. 


The main code in JSEventjsl instantiates the event sources and the Visual J# event receiver. Then it calls methods to hook, fire, 
and unhook the event handlers. 


The Visual J# event receiver JR2 and the Visual C++ event receiver Receiver receive events from both Visual C++ and Visual 
J# event sources, Event and JEvent, respectively. 


See Also 
Other Resources 


Visual J# Cross-Language Samples 


Visual J# Samples 


TilePuzzle Sample: Visual J# and Managed Extenstions for C++ 
Interoperability 


Download sample 


This sample demonstrates interoperability between managed components (written with Visual C++ and Visual J#) and native 
components (written with C++ using COM attributes). 


The sample implements a basic puzzle game called the Tile Puzzle. The sample loads a bitmap, splits the bitmap into any 
number of tiles (determined by the user), and randomizes the individual tiles. The user then solves the puzzle by sliding 
individual tiles around until the original picture is displayed. In addition to these features, the sample has the ability to solve the 
puzzle using heuristic search algorithms written in Visual C++ and the NET Framework classes. 





aSecurity Note 





This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 
te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 








Building and Running the Sample 
To open the sample file in Solution Explorer 


1. Click Download Sample. 
The File Download message box appears. 

2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 

3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 

4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build and run TilePuzzle using Visual Studio 


1. In Solution Explorer, right-click the Puzzle solution. 
2. On the shortcut menu, click Build Solution. 


3. On the Debug menu, click Start. Verify that the Puzzle project is set as the startup project. 


Remarks 
After the project builds successfully, try to solve the puzzle yourself. 
The save and load game features are not implemented. 


To access the native COM component from within the managed .NET Framework objects, the sample uses TLBIMP.EXE to 
generate a .NET Framework proxy DLL. 


Classes in the Sample 


The following classes are used in this sample. 


System.Windows.Forms.Form Implements the About Form object found in the Puzzle project. 








System.Object 


Implements the GameLevelEnum object found in the Puzzle project. 





System.Delegate 





Implements the SolveThreadProcD1g object found in the Puzzle project. 





See Also 
Other Resources 


Visual J# Cross-Language Samples 





Visual J# Samples 


Visual J# Technology Samples 


The samples in this section illustrate some of the technologies and features in the .NET Framework and in Visual J#. The intent 


is to instruct on a single technology or a few related technologies. 





Sample 


Description 





ClassLoader Sample (Modify Custom Class Loader for Assemblies) 


Class loader 





CLSExtender Sample (Authoring .NET Framework Properties, Events and Delegates) 


CLS Extender 





CrossLanguage Sample (Visual J# Interop with Other Managed Languages) 


Cross language 





Enum Type Sample (Declare a Enumeration Type) 


Enum type 





Bean Style Indexed Property Sample (Sets Property Value) 


Indexed bean-style prope 


rty 





Properties Sample (Use .NET Framework Properties) 


Using .NET Framework 





Bean Style Simple Property Sample (Sets Property Value) 


Value Type Sample (Declaring a Point Type as a Value Type) 


WFCUsingWinForm Sample (Extend WFC Application Built in Visual J++ 6.0 Using Windows Forms) 








Simple bean-style propert 


Windows Forms and exte 
nding WFC application 





Related Sections 

Visual J# Samples 

Visual J# Application Samples 
Visual J# Cross-Language Samples 


Visual J# Advanced Technology Samples 





Visual J# Samples 


Bean Style Indexed Property Sample (Sets Property Value) 


Download sample 
This sample demonstrates authoring bean-style properties. 
The button type declares the following two properties: 

e The Point type, which declares an indexed property. 


e The Point type, which can be indexed to set the relevant field within. 





aSecurity Note 





This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 
te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 








Building and Running the Sample 
To open the sample file in Solution Explorer 
1. Click Download Sample. 
The File Download message box appears. 
2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 
3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 
4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build and run this sample 
1. On the Build menu, click Build Solution. 
-or- 
From the command line, type BUILD.bat. 


4Note 


For more information, see Building from the Command Line (Visual J#). 





2. From the command line, type app. 


3. Examine the output. Expected output: 








p.x: 5 
p.y: 10 
See Also 


Other Resources 
Bean Style Simple Property Sample (Sets Property Value) 
Visual J# Technology Samples 


Visual J# Samples 


Bean Style Simple Property Sample (Sets Property Value) 


Download sample 


This sample demonstrates authoring bean-style properties. The button type declares the following two properties: 
e The text property is a simple property. 
e The pressed property is a boolean property. 

aSecurity Note 


This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 


te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 





Building and Running the Sample 
To open the sample file in Solution Explorer 


1. Click Download Sample. 
The File Download message box appears. 

2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 

3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 

4. Double-click the sample's sin file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build and run this sample 


1. On the Build menu, click Build Solution, or press CTRL+SHIFT+B. 
-Or- 


From the command line, type BUILD.bat. 





Note 





For more information, see Building from the Command Line (Visual J#). 











2. On the Debug menu, click Start Debugging, or press F5. 
-Or- 
From the command line, type app. 


3. Examine the output. Expected output: 





Is the button pressed: True 
Button text is: Ok 





See Also 
Other Resources 


Bean Style Indexed Property Sample (Sets Property Value) 
Visual J# Technology Samples 


Visual J# Samples 


ClassLoader Sample (Modify Custom Class Loader for 
Assemblies) 


Download sample 


This sample shows how custom class loaders in existing Java-language applications can be modified to load classes from 
managed assemblies. For new code, it is recommended that classes be searched and loaded from managed assemblies using 
common language runtime semantics and .NET Framework APIs rather than using custom class loaders. Class loaders are only 
intended to be used by existing Java-language applications. The resolveClass and defineClass methods in the class 
java.lang.ClassLoader are unsupported. In existing Java-language applications, the loadClass method will have to be 
rewritten to call one of the versions of Class.forName and then make appropriate entries in the application configuration 
(.config) file so that the managed assemblies needed by the application can be located and loaded. If the managed assemblies 
are located in the application's working directory, then no configuration file is required and the Class.forName search 
heuristics will locate the class. 





aSecurity Note 





This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 
te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 











Building and Running the Sample 
To open the sample file in Solution Explorer 


1. Click Download Sample. 
The File Download message box appears. 

2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 

3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 

4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build and run this sample 
e On the Build menu, click Build Solution, or press CTRL+SHIFT+B. 
-Or- 


From the command line, type BUILD.bat. 





Note 





See Building from the Command Line (Visual J#) for more information. 








e From the development environment, press F5 to build and run the sample. 
-Or- 


From the command line, type ClassLoaderSample.exe from the command line. 


See Also 
Other Resources 


Visual J# Technology Samples 


Visual J# Samples 


CrossLanguage Sample (Visual J# Interop with Other Managed 
Languages) 


Download sample 


This sample shows how Java-language syntax can be used in Visual J# to access classes written in other languages and how 
other languages can access Visual J# classes. Also shown is how other languages can catch Java-language exceptions thrown 
by components written in Java-language. This sample creates three assemblies. These three library or DLL assemblies define 
simple classes written in Visual C++, Visual Basic, and Visual J#. These classes derive from each other and ultimately from the 
base class written in Visual C++. Finally, the executable written in C# creates instances of the Visual J# class and calls methods 
on it. The NET Framework is an environment where various developers can work together seamlessly while developing in their 
language of choice. 





This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 
te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 





Building and Running the Sample 
To open the sample file in Solution Explorer 
1. Click Download Sample. 
The File Download message box appears. 
2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 
3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 
4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build this sample 


e On the Build menu, click Build Solution. 
-Or- 


e Type BUILD.bat from the command line. 





Note 





See Building from the Command Line (Visual J#) for more information. 











Note 





The location of one of the DLLs needed to compile the sample is hard-coded in the build script to C\Windows\Microsoft .NET 
\Framework\v<%version%>\vjslib.dll. This may need to be changed based on the version of Visual J# installed on the machi 
ne and the name of the Windows directory. 











To run this sample 


e Inthe development environment, press F5. 


-Or- 
Type CrossLang.exe from the command line. 


For each object instantiated, the code called was written in at least two different development languages. 


See Also 
Other Resources 
Visual J# Technology Samples 


Visual J# Samples 


Enum Type Sample (Declare a Enumeration Type) 


Download sample 


In this sample, an enumeration type color is declared. The enumerated constants are explicitly assigned values. The sample 
illustrates various operations on the enum type. 


aSecurity Note 


This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 


te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 





Building and Running the Sample 
To open the sample file in Solution Explorer 


1. Click Download Sample. 
The File Download message box appears. 

2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 

3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 

4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build and run this sample 


1. On the Build menu, click Build Solution, or press CTRL+SHIFT+B. 
-Or- 


From the command line, type BUILD.bat. 





Note 





For more information, see Building from the Command Line (Visual J#). 











2. From the command line, type app. 


3. Examine the output. Expected output: 





The Color type is derived from System. Enum 
Underlying type: System. Int32 

Red 

Does c1 equal c2: true 

Does c1 equal c2: true 

The Color is Red 








4. 


See Also 
Other Resources 


Visual J# Cross-Language Samples 
Visual J# Technology Samples 


Visual J# Samples 


Value Type Sample (Declaring a Point Type as a Value Type) 


Download sample 


In this sample, a "Point" type is declared as a value type. The value type is then instantiated, methods are called on it, and it is 
passed to a method as a parameter. 


aSecurity Note 


This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 


te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 





Building and Running the Sample 
To open the sample file in Solution Explorer 


1. Click Download Sample. 
The File Download message box appears. 

2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 

3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 

4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build and run this sample 


1. In Solution Explorer, click Build Solution, or press CTRL+SHIFT+B. 
-Or- 


From the command line, type BUILD.bat. 





Note 





For more information, see Building from the Command Line (Visual J#). 











2. On the Debug menu, click Start. 
-Or- 
From the command line, type app. 


3. Examine the output. Expected output: 
The Point type is derived from System.ValueType 
Does p1 equal p2: true 
Does p1 equal p2: false 





4. 


See Also 
Other Resources 


Visual J# Cross-Language Samples 


Visual J# Technology Samples 


Visual J# Samples 


WFCUsingWinForm Sample (Extend WFC Application Built in 
Visual J++ 6.0 Using Windows Forms) 


Download sample 


This sample demonstrates how a WFC application built in Visual J++ 6.0 can be extended using Windows Forms. A simple 
WFC application built in Visual J++ 6.0 is upgraded to Visual J#. This sample is extended to launch a simple Windows Forms 
component on clicking a button or selecting a menu option. A similar approach can be used to invoke and launch any 
Windows Forms component from a WFC application. 





aSecurity Note 





This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 
te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 








Building and Running the Sample 
To open the sample file in Solution Explorer 
1. Click Download Sample. 
The File Download message box appears. 
2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 
3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 
4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build this sample 


@ On the Build menu, click Build Solution, or press CTRL+SHIFT+B. 
-Or- 
From the command line, type BUILD.bat. 


Note 


For more information, see Building from the Command Line (Visual J#). 





To run this sample 


e From the development environment, press F5. 
-Or- 
From the command line, type WFCUsingWinForm.exe. 


To use the WFC application 


e Click the button to launch a Windows Forms component. 


-or- 


From File, choose Start Windows Form to launch the same Windows Forms component. 


See Also 
Other Resources 


Visual J# Technology Samples 


Visual J# Samples 


Visual J# Advanced Application Samples 


The samples in this section are modeled after complete applications that you might develop. These samples illustrate more 
complex applications than those found in Visual J# Application Samples. 


In This Section 
Acronym Web Service 


Demonstrates creating and consuming an XML Web service from a Web application. Also shows how to bind the contents of 
a dataset to a server-side Datagrid. 


Agent Explorer 
Demonstrates how to upgrade a Java-language/COM application to run on Visual J#. 
Vjsresgen 


Converts a Visual J++ 6.0 resource file to a .NET Framework resource file (.resx). 


Related Sections 

Visual J# Samples 

Visual J# Application Samples 

Visual J# Technology Samples 

Visual J# Cross-Language Samples 

Visual J# Advanced Cross-Language Samples 


Visual J# Advanced Technology Samples 


Visual J# Samples 


Acronym-WebService Sample (Create and Consume an XML 
Web Service) 


Download sample 
This sample demonstrates how to: 
e@ Create an XML Web service. 
e Use Web controls such as buttons, labels, and DataGrids. 
e Consume a Web service. 
The Web service takes the first few characters of the acronym and returns all matching acronyms. 
The Web application consumes this Web service and binds the contents of the dataset to the server-side Datagrid control. 
aSecurity Note 


This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 


te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 





Requirements 
e IIS 
e Microsoft Visual Studio 


e Microsoft Visual J# 
Building and Running the Sample 
To open the sample file in Solution Explorer 


1. Click Download Sample. 
The File Download message box appears. 

2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 

3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 

4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To prepare to run this sample 


1. After you download the sample directories (AcronymWA and AcronymWebServicelnJavaLanguage) to your machine, 
copy them under %SystemDrive%\inetpub\wwwroot. 


2. Make AcronymWA a virtual directory under IIS following the steps given below: 
a. From Start, choose Programs, then Admin Tools, and then Internet Services Manager. 
b. Right-click the default Web site from the tree and choose New, then Virtual Directory. 
c. Set the alias to AcronymWA. 


d. Set the location to %SystemDrive%\inetpub\wwwroot\AcronymWA. 


e. Select all the access permissions options (Read, RunScripts, Execute, Write, and Browse). 
3. Create a virtual directory for AcronymWebServicelnJavaLanguage following the same steps as above. 


4. Add Write permission to the subdirectory AcronymWebServicelnJavaLanguage for the local user account ASPNET 
(<your_machine_name>\ASPNET). This enables the Web service to read and write to the Microsoft Access database 
Acro.mdb, which is located in this directory. 





Note 





In the WhatltMeans.asmxjsl file, locate the set_ConnectionString method and replace C: with the appropriate drive let 
ter if necessary. 





5. Open Microsoft Visual Studio .NET. 
6. Open AcronymWAssIn from %SystemDrive%\inetpub\wwwroot\AcronymWA. 
7. From the Build menu, click Build Solution. 


8. In Solution Explorer, right-click AcronymExplainer.aspx and select Set as Startup Page. 
To test the sample 


1. Select Start Without Debugging from Debug menu. You will see the page that prompts for the acronym. The 
Acro.mdb database can be accessed through Microsoft Access with the database password vj#sample. 


2. Type any character in the edit box. 
3. Click the Get Acronym button. 


4. List of titles appear in the Datagrid. 


See Also 
Other Resources 


Visual J# Application Samples 





Visual J# Samples 


AgentExplorer Sample (Upgrade Java-Language/COM 
Application) 


Download sample 


This sample demonstrates how Visual J++® 6.0 Java-language/COM applications can be upgraded to run on Visual J#. The 
sample uses wrappers generated by the JActiveX® tool for the Microsoft Agent control COM component and classes from the 
com.ms.* and JDK level 1.1.4 packages. The sample creates an instance of the Microsoft® Agent COM control by using the new 
operator on the pre-generated JActiveX wrappers. It then casts the COM objects to specific interfaces and calls the methods 


and properties on them. The JActiveX wrappers are generated from the COM server agentsvr.exe in the %WinDir%\msagent 
directory. 





aSecurity Note 





This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 


te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 








Building and Running the Sample 
To open the sample file in Solution Explorer 
1. Click Download Sample. 


The File Download message box appears. 


2. Click Open, and on the left column of the zip folder window, click Extract all files. 


The Extraction Wizard opens. 


3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 


4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build from the development environment 
e On the Build menu, click Build Solution, or press CTRL+SHIFT+B. 
To build from the command line 


e Type BUILD.bat. 





Note 








For more information, see Building from the Command Line (Visual J#). 








To run this sample 
e From the development environment, press F5. 
-or- 
From the command line, type AgentExplorer, and press ENTER. 


See Also 
Other Resources 


Visual J# Application Samples 


Visual J# Samples 


Vjsresgen Sample (Convert a Visual J++ 6.0 Resource File to a 
-NET Framework Resource (.resx) File) 


Download sample 
This sample demonstrates how a Visual J++ 6.0 resource file can be converted to a NET Framework resource file (.resx). 


For the upgraded application to work correctly, it is important that all the resources in the CLASSPATH used by the application 
be identified and embedded or linked into the assembly. Care must be taken to preserve the directory structure when 
converting the resource files to .NET Framework resources. 





aSecurity Note 





This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 
te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 








Building and Running the Sample 
To open the sample file in Solution Explorer 


1. Click Download Sample. 
The File Download message box appears. 

2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 

3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 

4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build this sample 
e@ On the Build menu, click Build Solution, or press CTRL+SHIFT+B. 
-or- 
From the command line, type BUILD.bat. 


Note 


See Building from the Command Line (Visual J#) for more information. 





To run this sample 


e This sample must be run from the command line. Type vjsresgen.exe from the command line with the names of the 
files to convert to .resx format. 


By default the .resx file generated is named vjs.resx. You can override this using the /out option. 


Syntax and Options for Vjsresgen 


vjsresgen [/out:filename] [/recurse:wildcard] resourcefiles 


Remarks 


where: 


filename 


The name of the .resx output file to be created. 


wildcard 


The wildcard expression to match the file name(s). 


resourcefiles 


Input resource files. 


The /recurse option lets you specify files that match a wildcard expression (wildcard). You can optionally specify the directory 
in which you want the search to begin. If this is not specified, the search begins in the project directory. 


Examples of Running Vjsregen.exe 


The following examples illustrate how to use Vjsresgen.exe from the command line. 


Resources in the Same Directory 


Vjsresgen /out:myresource.resx *.txt 

Resgen myresource.resx myresource.resources 
JbIlmp /res:myresource.resources myarchive.zip 
-or- 


vjc /resource:myresource.resources * java 


Resources in Subdirectories 


Vjsresgen /out:myresource.resx subdir\res1.bmp subdir\r.resources subdir2\res.txt subdir2\r.resources 
Resgen myresource.resx myresource.resources 

JbIlmp /res:myresource.resources myarchive.zip 

-or- 

vjc /resource:myresource.resources * java 


In the above example, subdir\r.resources and subdir2\r.resources are two different resource files. When 
Class.getResource is called on a class that exists in package subdir, it gets the resource specified by subdir\r.resources, 
whereas a class in package subdir2 gets subdir2\r.resources. 


In the above example, r.resources is a file created under Visual J++ 6.0 and is not equivalent to the .resources file format 
supported by the .NET Framework. 


Resources Using the /recurse Option 


Vjsresgen /out:my.resx /recurse:p1\*.resources /recurse:p2\*.bmp 
Resgen my.resx 

and then 

JbImp /res:my.resources /recurse 

-or- 

vjc /resource:my.resources /recurse”* java 


In the above example, *.resources present in directory p1 and *.bmp files present in directory p2 are embedded. 





The path to the converted resource that was embedded in the managed resource file (.resx) must match with the path u 
sed to specify the resource in Class.getResource (or similar methods), you might need to modify your application cod 
e appropriately. For example, to convert a Visual J++ resource located at c:\resources\package1\data.txt, you may need 
to browse to the c:\temp directory and then run Vjsresgen. Application code must then be modified to specify the resou 
rce as "package1 .data.txt" in methods like class. getResources (String resourceName). 











See Also 

Tasks 

How to: Upgrade Visual J++ 6.0 Applications That Use Resources 
Other Resources 

Visual J# Application Samples 


Visual J# Samples 


Visual J# Advanced Cross-Language Samples 


The following samples are ported from samples in other languages. 


In This Section 
DataSetConsumer Sample (Consumes Multiple Table Datasets) 


Demonstrates how to consume multiple-table datasets in a SPROXY-generated SOAP client. The Visual J# code creates a 
multiple-table dataset and exposes it through an XML Web services method. 


JrniPost Sample (Accessing Business Logic from Both COM and .NET Framework Clients) 


Creates a single DLL containing native business logic, an interface and type library for COM clients, and an assembly with 
corresponding metadata for NET Framework clients. The Visual J# code instantiates a managed object from the DLL and 
calls a couple of methods on it. It illustrates that the DLL contains both COM and .NET Framework classes. 


MCppWrapper Sample (Wrapping a C++ DLL) 


Illustrates how a Managed Extensions __gc class can be used as a proxy class (or wrapper) for an unmanaged C++ class ina 
DLL. The Visual J# code is a client that reads a string and position from the console and displays a suffix. 


Related Sections 

Visual J# Samples 

Visual J# Application Samples 

Visual J# Technology Samples 

Visual J# Cross-Language Samples 
Visual J# Advanced Technology Samples 


Visual J# Advanced Application Samples 


Visual J# Samples 


DataSetConsumer Sample (Consumes Multiple Table Datasets) 


Download sample 


This sample demonstrates how to consume multiple table datasets from an unmanaged Visual C++ client using an XML Web 
service proxy. 


The DataSetConsumer sample illustrates how to consume multiple table datasets from an unmanaged Visual C++ application. 
DataSetConsumer is an ATL Server application that consumes a multiple table dataset exposed through an XML Web service 
created using ASP.NET. 


DataSetConsumer also shows how to use Web references to support the consumption of multiple table datasets. Web 
references convert single table datasets into C++ structures, but treat multiple table datasets as XML streams. Therefore, the 
corresponding XML Web services method in the proxy class returns the full XML serialization of the dataset as string data. It 
must then be parsed to be useful in most applications. 


The DataSetConsumer application accesses multiple tables in a dataset, while the walkthrough accesses a single table. 





aSecurity Note 





This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 
te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 











Requirements 
e {IS must be installed and running. 


e Atleast one SQL Server database must be installed. 


Building and Running the Sample 


To use this sample, follow the steps in this section. You will create an XML Web service project WebService1 that defines a Web 
services method to access data from a dataset. You then add a Web reference, which creates a proxy class for the XML Web 
service. DataSetConsumer uses an instance of this proxy to call the XML Web services method in WebServicel. WebServicel 
returns the dataset as type BSTR, and DataSetConsumer loads it as XML, using the DOM and the MSXML parser to parse the 
string and print the data as HTML. 


To open the sample file in Solution Explorer 


1. Click Download Sample. 
The File Download message box appears. 

2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 

3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 

4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To create an ASP.NET Web service project to access a dataset 


1. Create anew XML Web service using ASP.NET. 


From the File menu, click New, then Project. The New Project dialog box appears. In the Visual J# Projects folder, 
select ASP.NET Web Service. Name the project WebServicel. The location should be the default 
(http: //localhost/WebServicel). 


6. 


Click OK. When the project has been created, you will see Service1.asmx,jsl in the Design pane. 


. Create a data connection. 


In Server Explorer, right-click Data Connection and click Add Connection. The Data Link Properties dialog box 
appears. Fill in the details to create a data connection to a database, for example, the Northwind database. Select the 
Allow Saving Password checkbox. 


. Add tables and data adapters. 


Open the Tables node of your new data connection and drag two tables from Server Explorer to the Design pane. Two 
DataAdapters and one data connection will appear in the Design pane. 


. Generate a dataset. 


From the Data menu, click Generate Dataset. In the Generate Dataset dialog box, choose a New Dataset named 
DataSet1 (the default), and choose to add both tables to the dataset. Also select the Add this dataset to the designer 
box (optional but recommended). Click OK to create the dataset (named dataSet11 by default). 


. Implement a Web services method. 


From the View menu, click Code. The code for Service1.asmx,js!l appears in the Edit pane. Scroll to the bottom of the file 
to the HelloWorld example Web services method: 


// /** @attribute WebMethod() */ 
// public System.String HelloWorld() 


// { 
// return "Hello World"; 
// } 


In place of the HelloWorld example code, implement a new Web services method named GetDataSet as follows: 


/** @attribute WebMethod() */ 

public DataSet1 GetDataSet() 

{ 
this.sqlDataAdapter1.Fill (this.dataSet11) ; 
return dataSet11; 





Build the WebService1 project. From the Build menu, click Build Solution. 


To consume data from DataSetConsumer 


1. 
2. 
3. 


Open the DataSetConsumer project. 
Open the solution file, DataSetConsumer.sln, in the Visual Studio development environment. 


Make sure that DataSetConsumer.h contains this line: 


#include "WebService.h" 


. Add a Web reference to the project. 


Adding a Web reference will generate a proxy class for the XML Web service. An XML Web service client can call a 
method on the proxy, which in turn does the necessary work to remotely invoke the call over the network to call the 
corresponding XML Web services method. By default, the proxy class uses SOAP to access the corresponding method. 
SOAP supports the richest set of data types of the three supported protocols (SOAP, HTTP-GET, and HTTP-POST). Adding 
a Web reference can generate proxy classes for the latter two protocols as well. In Solution Explorer, right-click the 


DataSetConsumer project node and select Add Web Reference from the shortcut menu. 


The Add Web Reference dialog box appears. 


. In the Address bar, type the URL for WebService as follows and press ENTER. 


http://localhost/WebService1/Servicel.asmx 


The Web service description is an XML document written in an XML grammar called Web Service Description Language 
(WSDL) that defines the format of messages for the XML Web service. 





. Click Add Reference. This adds the proxy class Service1 to the DataSetConsumer project. The header file WebService.h 


appears in Solution Explorer. 





Note 





In the header file generated for your web service, the cService1T constructor is hard-coded to use the URL specified w 
hen you added the Web reference. If you want to use DataSetConsumer with another XML Web service, change the UR 
L to match the location of that XML Web service .asmx file. 








. From the Build menu, click Build Solution to build the DataSetConsumer project. 


. Torun the client application, from the Debug menu, click Start Without Debugging. 


You are prompted for a URL. 


. Enter the following: 





http://localhost/DataSetConsumer/DataSetConsumer. srf 


. Click OK. 


The Web browser appears, displaying the data accessed through the XML Web service. 


Classes, Technologies, and Concepts in the Sample 


Adding and Removing Web References 
ADO.NET DataSet 

Creating XML Web Service Clients 
DataSet Class 

request_handler 

soap_handler 


soap_method 


See Also 
Other Resources 


Visual J# Cross-Language Samples 


Visual J# Samples 


JrniPost Sample (Accessing Business Logic from Both COM and 
-NET Framework Clients) 


Download sample 


This sample creates a single DLL containing native business logic, an interface and type library for COM clients, and an 
assembly with corresponding metadata for .NET Framework clients. Clients written in Visual J# and Managed Extensions for 
C++ are used to access the business logic. 


aSecurity Note 


This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 


te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 





Building and Running the Sample 
To open the sample file in Solution Explorer 


1. Click Download Sample. 
The File Download message box appears. 

2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 

3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 

4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build this sample 
e On the Build menu, click Build Solution. 
-Or- 
In Solution Explorer, right-click the JrnIPost solution, and on the shortcut menu, click Build Solution. 
To run this sample 


1. In Solution Explorer, right-click the comJrniClient project. 
2. On the shortcut menu, click Debug, then click Start new instance. 


3. Repeat steps 1 and 2 with the netrniClientA and newUrniClientB projects. 


Once the clients have started, a series of dialog boxes (with an OK button) appear, notifying you of calls into the business logic. 
Close the dialog boxes by clicking the OK button. 





To get more information on the interaction between components, step through the code by either setting breakpoints or usin 
g the Debug menu to step into or over the sample code. 





Project Description 


The main focus of the sample is accessing business logic from both COM and .NET Framework clients and not on 


implementation of the business logic itself. Therefore, the business logic in this sample is relatively uninteresting. In fact, the 
business logic does minimal validation and shows Win32 message boxes corresponding to server business actions to illustrate 
steps. The JEPost class, which implements the business logic, is defined and implemented in JEPost.h and JEPost.cpp, 
respectively. 





The class implementing the COM component contains a pointer to an instance of the business logic class. The COM 
component can be thought of as the wiring through which a COM client accesses the underlying business logic. Jrn|Post.dll 
contains a type library that COM clients consume to discover the interfaces and methods exposed by the COM component. The 
COM client in this sample uses the compiler's #import feature to consume a type library and generate a smart pointer that is 
then used by the client to instantiate and call into the COM component. The class implementing the COM component is 
comJEPost, which is defined and implemented in comJEPost.h and comJEPost.cpp, respectively. 





The class implementing the .NET Framework component also contains a pointer to an instance of the business logic class. 
Much like its COM counterpart, the NET Framework component in this sample can be thought of as the wiring through which 
a .NET Framework client accesses the underlying business logic. JrnIPost.dll contains a single file assembly with corresponding 
metadata that INET Framework clients consume to discover and access the public classes and methods exposed by the .NET 
Framework component. The class implementing the NET Framework component is net JEPost, which is defined and 
implemented in neJEPost.h and net/EPost.cpp, respectively. 


There are three client projects in this sample: 
e ComJsrniClient, a COM client implemented in native C++. 
e NewtrniClientA, a .NET Framework client written in Visual J#. 


e NetJrniClientB, a client written using Managed Extensions for C++. 


See Also 
Other Resources 
Visual J# Cross-Language Samples 


Visual J# Samples 


MCppWrapper Sample (Wrapping a C++ DLL) 


Download sample 


This sample illustrates how a Managed Extensions __ge class can be used as a proxy class (or wrapper) for an unmanaged C++ 
class in a DLL. Some of the basic concepts demonstrated are Managed Extensions interoperability, wrapper and proxy classes, 
and basic data marshaling. 





aSecurity Note 





This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 
te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 











Building and Running the Sample 
To open the sample file in Solution Explorer 


1. Click Download Sample. 
The File Download message box appears. 

2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 

3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 

4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build and run this sample using Visual Studio 


1. In Solution Explorer, right-click the MCppWrapper solution. 
2. On the shortcut menu, click Build Solution. 


3. On the Debug menu, click Start. 


How the Sample Works 


The unmanaged DLL provides a class called substring. This has a method called suffix that returns the suffix of a string from 
an index position to the end of the string. The first character in the string has index position 1. A position of 0 or a negative 
position results in the whole string being returned. A position larger than the length of the string results in the empty string 
being returned. 


The substring class is wrapped by a Managed Extensions __ge class called substring_w. This class contains a method called 
find_suffix that takes a managed string and an int as arguments. The method does some simple data marshaling: the 
managed string is converted to an unmanaged one. It creates an object of the substring class and calls suffix with the 
converted string and integer position. The string returned is converted implicitly to a managed String. 


The client of the subst ring_w class is a simple Visual J# program that reads a string and position from the console, and then 
creates a substring_w object, calls find_suffix, and displays the suffix. 


See Also 
Other Resources 


Visual J# Cross-Language Samples 


Visual J# Samples 


Visual J# Advanced Technology Samples 


The samples in this section illustrate the various technologies and features in the INET Framework and in Visual J#. The intent is 
to instruct on a single technology or a few related technologies. 


In This Section 
Attributes Sample (Use .NET Framework Attributes) 


Using .NET Framework 

By Reference Sample (Pass a Type by Reference) 
Passing a type by reference to a method. 

CLSExtender Sample (Authoring .NET Framework Properties, Events and Delegates) 
CLS Extender 

CodeDOM Sample (Use CodeDomProvider) 
CodeDOM 

COMCallsJava_NET Sample (Expose Managed Components to COM) 
Java-language/COM (using .NET Framework semantics) 

COMCallsJava Sample (Upgrading Visual J++ 6.0 Java-Language Components) 
Java-language/COM 

Custom Attribute Sample (Attach a Custom Attribute to a Class) 
Custom attribute 

DynamicLoading Sample (Load Classes from Deployed Assemblies) 
Dynamic loading 

EventsAndDelegates Sample (Use .NET Framework Events and Delegates) 
Using the .NET Framework 

Generics Samples (Consuming Generics) 
Consuming generics 

JavaCallsCOM Sample (Upgrading Visual J++ 6.0 Java-Language Components) 
Java-language/COM 

JavaCallsCOM_NET Sample (Expose COM Objects to Managed Components) 
Java-language/COM (using .NET Framework semantics) 

Minesweeper Sample (Build a Version of the Minesweeper Game) 
Using the .NET Framework 

PInvoke Sample (Call Unmanaged APIs) 
Using the platform invoke services 

Remoting Sample 
Remoting service 

Scoping Sample (Using /securescoping) 
Scoping 

SecurityProviders Sample (Specify Third Party Security Providers) 


Security providers 


Related Sections 

Visual J# Samples 

Visual J# Application Samples 
Visual J# Technology Samples 
Visual J# Cross-Language Samples 


Visual J# Advanced Application Samples 


Visual J# Samples 


Attributes Sample (Use .NET Framework Attributes) 


This sample demonstrates how language applications compiled and run on Visual J# can use the .NET Framework attributes to 
provide enhanced functionality. Any of the attributes available in the .NET Framework can be attached to Visual J# programs. 
However, the Visual J# compiler does not support authoring (defining) attributes in Visual J# programs. 


aSecurity Note 


This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 


te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 





Building and Running the Sample 
To open the sample file in Solution Explorer 


1. Click Download Sample. 
The File Download message box appears. 

2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 

3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 

4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build this sample 


e On the Build menu, click Build Solution, or press CTRL+SHIFT+B. 
-Or- 


From the command line, type BUILD.bat. 





Note 





See Building from the Command Line (Visual J#) for more information. 











To run this sample 


e From the development environment, press F5. 
-Or- 


From the command line, type AttributeSample.exe. 


See Also 
Other Resources 


Visual J# Technology Samples 


Visual J# Samples 


By Reference Sample (Pass a Type by Reference) 


Download sample 
This sample demonstrates passing a reference type, a value type, or a primitive type by reference to a method. 


The sample declares a point type as a value type, and then instantiates the value type. Methods are called on the value type, 
and it is passed by reference to a method. 


You can also pass primitive types as parameters by reference, as the swap method demonstrates. 


This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 


te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 





Building and Running the Sample 
To open the sample file in Solution Explorer 
1. Click Download Sample. 
The File Download message box appears. 
2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 
3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 
4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build and run this sample 


1. On the Build menu, click Build Solution. 
-Or- 


From the command line, type BUILD.bat. 





Note 





For more information, see Building from the Command Line (Visual J#). 











2. From the command line, type app. 


3. Examine the output. Expected output: 





Does p1 equal p2: true 
Does p1 equal p2: false 
Swapping two values 

Before swap: i = 1 j = 101 
After swap: i = 101 j = 1 


See Also 
Other Resources 


Visual J# Technology Samples 


Visual J# Samples 


CLSExtender Sample (Authoring .NET Framework Properties, 
Events, and Delegates) 


Download sample 
This sample shows the authoring of INET Framework properties, events, and delegates. 
aSecurity Note 


This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 


te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 





Building and Running the Sample 
To open the sample file in Solution Explorer 


1. Click Download Sample. 
The File Download message box appears. 

2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 

3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 

4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build this sample 


e On the Build menu, click Build Solution, or press CTRL+SHIFT+B. 
-Or- 


From the command line, type BUILD.bat. 





Note 





For more information, see Building from the Command Line (Visual J#). 











To run this sample: 
e From the development environment, press F5. 
-Or- 


From the command line, type Container.exe. 


See Also 
Other Resources 


Visual J# Technology Samples 


Visual J# Samples 


CodeDOM Sample (Use CodeDomProvider) 


Download sample 


This sample demonstrates using Visual J# CodeDomProvider to dynamically generate code and compile it using CodeDOM. 
This sample: 


e Generates codeDOM tree for a simple Hello, World program. 
© Generates source code for it in file bin\GeneratedFilejsl. 


e Compiles the generated file using the CodeDomProvider implementation for Visual J# to give the generated "hello 
world!" assembly. 


For more information on CodeDOM, see CodeDOM Quick Reference. 


aSecurity Note 





This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 
te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 











Building and Running the Sample 
To open the sample file in Solution Explorer 


1. Click Download Sample. 
The File Download message box appears. 

2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 

3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 

4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build this sample 
e On the Build men, click Build Solution, or press CTRL+SHIFT+B. 
-Or- 


From the command line, type BUILD.bat. 





Note 





For more information, see Building from the Command Line (Visual J#). 





To run this sample 


e From the development environment, press F5 to build and run the sample. 
The generated file GeneratedFile,js| is also available. 
-Or- 


From the command line, type CodeDOMUsage.exe. The generated file GeneratedFile,jsl is available under bin\debug 
directory. 





See Also 
Other Resources 


Visual J# Technology Samples 


Visual J# Samples 


COMCallsJava_NET Sample (Expose Managed Components to 
COM Using .NET Framework Interop) 


Download sample 


This sample demonstrates how managed components written in Visual J# can be exposed to COM using the .NET Framework 
COM-interop semantics. Using NET Framework semantics is the recommended way for COM inter-op for newly written Visual 
J# components. In this sample, the managed component written in Visual J# is compiled to a DLL. The DLL is then registered as 
a COM component using the RegAsm tool, which then allows it to be accessed from clients such as Visual Basic 6.0. 


For more information on COM inter-op using .NET Framework semantics please refer to 
Interoperating with Unmanaged Code. 





aSecurity Note 





This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 


te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 








Building and Running the Sample 
To open the sample file in Solution Explorer 
1. Click Download Sample. 
The File Download message box appears. 
2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 
3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 
4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build this sample 


e On the Build men, click Build Solution, or press CTRL+SHIFT+B. 
-Or- 
From the command line, type BUILD.bat. 


Note 


For more information, see Building from the Command Line (Visual J#). 





To run this sample 


1. Open the VB6Project.vbp file in Visual Basic 6.0. 


2. From the Project menu, choose References. Then, browse and add a reference to the MyForm.tlb file present in your 
sample directory, or in the \bin\debug subdirectory of the project root when building from the IDE. 
3. Press F5. 


4. Once running, click the Visual Basic form's button to create a managed form. Adjust the properties on the Visual Basic 
form and watch the changes occur on the managed form. The Visual Basic form also allows you to create a button on the 


managed form and adjust some of its properties. This is all done from unmanaged Visual Basic code. 


See Also 
Other Resources 


Visual J# Technology Samples 


Visual J# Samples 


COMCallsJava Sample (Upgrading Visual J++ 6.0 Java- 
Language/COM Components) 


Download sample 


This sample demonstrates upgrading Visual J++6.0 Java-language components exposed as COM DLLs. To upgrade the Visual 
J++ 6.0 component, a managed wrapper DLL is generated from the type library of the COM server using the .NET Framework 
tool TlbImp. This managed DLL is then referenced when compiling the sources. The DLL emitted is then registered using the 
.NET Framework tool RegAsm. 


For detailed information on upgrading Visual J++ 6.0 Java-language/COM applications to Visual J#, refer to 
Upgrading Visual J++ 6.0 Components Exposed to COM. 





aSecurity Note 





This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 
te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 








Building and Running the Sample 
To open the sample file in Solution Explorer 
1. Click Download Sample. 
The File Download message box appears. 
2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 
3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 
4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build this sample 


e On the Build menu, click Build Solution, or press CTRL+SHIFT+B. 
-Or- 
From the command line, type BUILD.bat. 


Note 


For more information, see Building from the Command Line (Visual J#). 





To run this sample 
1. Go to the COMClient directory and open the COMClient.vbp file in Visual Basic® 6.0. 
-or- 
From the Project menu, choose References. 


2. Add a reference to the Server.tlb file in the .\JavaServer\ directory. Build and run the demo by pressing F5. 


See Also 
Other Resources 


Visual J# Technology Samples 


Visual J# Samples 


Custom Attribute Sample (Attach a Custom Attribute to a 
Class) 


Download sample 
In this sample, a custom attribute author is declared in J#, so it can be attached to (or target) all program elements. 
The custom attribute is then attached to the class Point, and to the constructor of the class Point. 


The class app reflects on the Point class and discovers if there are any custom attributes attached, and to what program 
elements they are attached. 





aSecurity Note 





This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 
te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 








Building and Running the Sample 
To open the sample file in Solution Explorer 


1. Click Download Sample. 
The File Download message box appears. 

2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 

3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 

4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build and run this sample 


1. From the command line, type BUILD.bat. 


Note 


See Building from the Command Line (Visual J#) for more information. 





2. From the command line, type app. 


3. Examine the output. Expected output: 


Number of custom attributes on type Point are: 1 

Number of methods (incl. constructors) on type Point are: 1 
Method name: .ctor 

Number of custom attributes on method: 2 


4. 


See Also 
Other Resources 


Visual J# Cross-Language Samples 
Visual J# Technology Samples 


Visual J# Samples 


DynamicLoading Sample (Load Classes from Deployed 
Assemblies) 


Download sample 


This sample demonstrates how classes can be loaded from managed DLLs deployed to multiple locations using the 
Class.forName APIs. There are two versions of Class.forName: 


e Class.forName(String className) 
e Class.forName(String assemblyName, String className, boolean absolutePath) 


For more information, see Runtime Binding: Class.forName() Semantics. 





aSecurity Note 





This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 
te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 








Building and Running the Sample 
To open the sample file in Solution Explorer 
1. Click Download Sample. 
The File Download message box appears. 
2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 
3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 


Make sure that the Show extracted files check box is selected, and click Finish. 


To build this sample 
e From the command line, type BUILD.bat. 


Note 


For more information, see Building from the Command Line (Visual J#). 





To run this sample 
e Type DynamicLoading.exe from the command line. 
See Also 


Other Resources 
Visual J# Technology Samples 


Visual J# Samples 


EventsAndDelegates Sample (Use .NET Framework Events and 
Delegates) 


Download sample 


This sample demonstrates the use of .NET Framework delegates and events. You can consume .NET Framework delegates in 
Visual J#. The delegate or multicast keywords create delegates of type com.ms.lang.Delegate rather than of 
System.Delegate. 


aSecurity Note 


This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 


te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 





Building and Running the Sample 
To open the sample file in Solution Explorer 


1. Click Download Sample. 
The File Download message box appears. 

2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 

3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 

4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build this sample 


e On the Build menu, click Build Solution, or press CTRL+SHIFT+B. 
-Or- 


From the command line, type BUILD.bat. 





Note 





For more information, see Building from the Command Line (Visual J#). 











To run this sample 


e From the development environment, press F5. 
-Or- 


From the command line, type EventsAndDelegates.exe. 


Command-Line Requirements 


For the Visual J# samples to function properly when building and running from the command line, you need to run vsvars.bat 
(located in the <%Program Files%>\Microsoft Visual Studio 8\Common7\Tools directory). Alternatively, you can also use the 
Visual Studio command prompt (click Start, then Programs, then Microsoft Visual Studio, and then Visual Studio Tools). 


See Also 


Other Resources 
Visual J# Technology Samples 


Visual J# Samples 


Generics Samples (Consuming Generics) 


The samples in this section demonstrate creating generics in C# and consuming them in J#. 

Sample Description 

Generic Stack Class Sample (Consuming Using J#) A generic stack class, written in C# and consumed from J#. 
Constraint Sample (Constraining a Type Using a Generic Class)/The generic stack type imposes a constraint that the type para 


meter 'T’ must be a type that implements the interface IDispla 
y. 


Delegate Sample (Applying a Generic Delegate Type) A generic delegate type, Proc, is declared in C#. From J#, instan 
tiate and apply the generic delegate type. 





Generic Stack Interface Sample (Consuming an Interface) The generic stack class implements a generic stack interface. Fr 
om J#, consume this generic stack class in terms of the generic 
stack interface. 


Generic Printing Method Sample (Prints an Array of Types) A "printer" type has a generic method that can print out an arra 
y of types onto the console. This type is consumed from J#, pro 
viding different constructed types. 








See Also 

Other Resources 

Visual J# Samples 

Visual J# Cross-Language Samples 
Visual J# Application Samples 
Visual J# Technology Samples 


Visual J# Samples 


Generic Stack Class Sample (Consuming Using J#) 


Download sample 


This sample demonstrates a generic stack class, written in C# and consumed from J#. 





aSecurity Note 





This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 
te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 








Building and Running the Sample 
To open the sample file in Solution Explorer 
1. Click Download Sample. 
The File Download message box appears. 
2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 
3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 
4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build and run this sample 
@ On the Build menu, click Build Solution, or press CTRL+SHIFT+B. 
-or- 
From the command line, type BUILD.bat. 


Note 


For more information, see Building from the Command Line (Visual J#). 





See Also 

Other Resources 

Generics Samples (Consuming Generics) 
Visual J# Cross-Language Samples 
Visual J# Technology Samples 





Visual J# Samples 


Constraint Sample (Constraining a Type Using a Generic Class) 


Download sample 


In this sample, the generic stack type imposes a constraint: The type parameter ‘T’ must be a type that implements the interface 
IDisplay. The stack type introduces a new method displayAll, which invokes the methods on the IDisplay interface of the 
types stored using the stack. 





aSecurity Note 





This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 
te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 











Building and Running the Sample 
To open the sample file in Solution Explorer 


1. Click Download Sample. 
The File Download message box appears. 

2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 

3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 

4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build and run this sample 
e@ On the Build menu, click Build Solution, or press CTRL+SHIFT+B. 
-or- 
From the command line, type BUILD.bat. 


Note 


For more information, see Building from the Command Line (Visual J#). 





e On the Debug menu, click Start Debugging, or press F5. 
-Or- 


From the command line, type app. 


See Also 
Other Resources 


Generics Samples (Consuming Generics) 
Visual J# Cross-Language Samples 
Visual J# Technology Samples 


Visual J# Samples 


Delegate Sample (Applying a Generic Delegate Type) 


Download sample 


In this sample, declare a generic delegate type "Proc" C#. From J#, instantiate and apply the generic delegate type. 





aSecurity Note 





This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 
te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 











Building and Running the Sample 
To open the sample file in Solution Explorer 


1. Click Download Sample. 
The File Download message box appears. 

2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 

3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 

4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build and run this sample 
@ On the Build menu, click Build Solution, or press CTRL+SHIFT+B. 
-or- 
From the command line, type BUILD.bat. 


Note 


For more information, see Building from the Command Line (Visual J#). 





e On the Debug menu, click Start Debugging, or press F5. 
-Or- 


From the command line, type app. 


See Also 
Other Resources 


Generics Samples (Consuming Generics) 
Visual J# Cross-Language Samples 
Visual J# Technology Samples 


Visual J# Samples 


Generic Stack Interface Sample (Consuming an Interface) 


Download sample 


This sample demonstrates consuming a generic stack class. The generic stack class implements a generic stack interface. J#, 
consume this generic stack class in terms of the generic stack interface. 


aSecurity Note 


This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 


te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 





Building and Running the Sample 
To open the sample file in Solution Explorer 


1. Click Download Sample. 
The File Download message box appears. 

2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 

3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 

4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build and run this sample 


e On the Build menu, click Build Solution, or press CTRL+SHIFT+B. 
-Or- 


From the command line, type BUILD.bat. 





Note 





For more information, see Building from the Command Line (Visual J#). 











e On the Debug menu, click Start Debugging, or press F5. 
-Or- 


From the command line, type app. 


See Also 
Other Resources 


Generics Samples (Consuming Generics) 
Visual J# Cross-Language Samples 
Visual J# Technology Samples 


Visual J# Samples 


Generic Printing Method Sample (Prints an Array of Types) 


Download sample 


In this sample, a "printer" type has a generic method that can print out an array of types to the console. This method is 
consumed from J#, providing different constructed types. 


aSecurity Note 


This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 


te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 





Building and Running the Sample 
To open the sample file in Solution Explorer 


1. Click Download Sample. 
The File Download message box appears. 

2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 

3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 

4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build and run this sample 


e On the Build menu, click Build Solution, or press CTRL+SHIFT+B. 
-Or- 


From the command line, type BUILD.bat. 





Note 





For more information, see Building from the Command Line (Visual J#). 











e On the Debug menu, click Start Debugging, or press F5. 
-Or- 


From the command line, type app. 


See Also 
Other Resources 


Generics Samples (Consuming Generics) 
Visual J# Cross-Language Samples 
Visual J# Technology Samples 


Visual J# Samples 


JavaCallsCOM_NET Sample (Expose COM Objects to Managed 
Components Using .NET Framework Interop) 


Download sample 


This sample demonstrates how Visual J# applications can access COM DLLs using the .NET Framework COM inter-op 
semantics. Using NET Framework semantics is the recommended way for COM inter-op for newly written Visual J# 
applications. Managed wrappers are generated for the COM DLL using the .NET Framework tool Tiblmp. The managed 
wrappers are then imported into the Visual J# program. Using the new operator on the appropriate wrappers then creates an 
instance of the COM coclass. The developer can then invoke methods on the COM DLL by calling methods on the wrapper. 
Unlike inter-op using JActiveX® wrappers the wrappers generated by TlbImp extend from System.Object and take NET 
Framework data types as parameters and return types. 


For more information on COM inter-op using .NET semantics please refer Exposing .NET Framework Components to COM. 





aSecurity Note 


This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 


te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 





Building and Running the Sample 
To open the sample file in Solution Explorer 


1. Click Download Sample. 
The File Download message box appears. 

2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 

3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 

4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build this sample 


e@ On the Build menu, click Build Solution, or press CTRL+SHIFT+B. 


-or- 


From the command line, type BUILD.bat. 





For more information, see Building from the Command Line (Visual J#). 





A prebuilt COM DLL is included in the sample. If you do not want to rebuild the COM server, you need to register the 
existing DLL by typing regsvr32 COMServer.dll before using it. ln case you rebuild the COM server no explicit 
registration is required, as the build process does this. 


To run this sample 


e From the development environment, open the Clientvjsproj file (from the \Client directory) and press F5 to build and run 
the sample. 


-or- 


From the command line, type Client.exe. 


See Also 
Other Resources 


Visual J# Technology Samples 


Visual J# Samples 


JavaCallsCOM Sample (Upgrading Visual J++ 6.0 Java- 
Language/COM Components) 


Download sample 


This sample demonstrates upgrading Visual J++ 6.0 Java-language/COM applications to Visual J#. The sample has three 
directories under the Clients subdirectory. The client in the SimpleClient directory shows upgrading of a simple client that 
accesses a COM DLL. Even the JActiveX® generated wrappers are upgraded. The InterfaceMarshaling and MessagePump 
samples explain specific workarounds to threading related issues that developers may face when upgrading their applications 
to Visual J#. 


For detailed information on upgrading Visual J++ 6.0 Java-language/COM applications to Visual J# please refer to 
Upgrading Visual J++ 6.0 Applications That Access COM Components. 





aSecurity Note 


This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 
te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 





Building and Running the Sample 
To open the sample file in Solution Explorer 


1. Click Download Sample. 
The File Download message box appears. 

2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 

3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 

4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build this sample in the development environment 
1. On the Build menu, click Build Solution, or press CTRL+SHIFT+B. 
-Or- 


From the command line, type BUILD.bat. 





Note 





For more information, see Building from the Command Line (Visual J#). 











2. Open the appropriate project file (SimpleClient.vjsproj, InterfaceMarshaling.vjsproj, or MessagePump.vjsproj) in the 
development environment and build it. 


To build this sample from the command line 


e Type BUILDALL.bat from the sample root directory. 


A COM DLL is in included in the sample. In case you do not want to rebuild the COM server, you need to register the 
existing DLL by typing regsvr32 COMServer.dll to be able to use it. If you rebuild the COM server, no explicit 
registration is required as the build process does this. 


To run this sample 


e From the development environment, press F5 to build and run the sample. 
-Or- 


From the command line, type Client.exe from the relevant client directory. 


See Also 
Other Resources 


Visual J# Technology Samples 


Visual J# Samples 


Minesweeper Sample (Build a Version of the Minesweeper 
Game) 


Download sample 
This sample demonstrates how applications can target and consume the following .NET Framework features: 
e Events 
e Delegates 
e Value types 
e@ Properties 
e Attributes 
The following .NET Framework classes from the following namespaces are used: 
e System 
e System.Drawing 
e System.Windows.Forms 


e System.ComponentModel 


This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 


te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 





Building and Running the Sample 
To open the sample file in Solution Explorer 


1. Click Download Sample. 
The File Download message box appears. 

2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 

3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 

4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build this sample 


e@ On the Build menu, click Build Solution, or press CTRL+SHIFT+B. 
-Or- 


From the command line, type BUILD.bat. 





Note 





For more information, see Building from the Command Line (Visual J#). 











To run this sample 


e From the development environment, press F5. 
-Or- 


From the command line, type Minesweeper.exe. 


See Also 
Other Resources 


Visual J# Technology Samples 


Visual J# Samples 


Pinvoke Sample (Call Unmanaged APIs) 


Download sample 


This sample demonstrates how Visual J# can use the platform invoke services provided by the common language runtime to 
call unmanaged APIs. Platform invoke is an alternative to J/Direct® technology (J/Direct is fully supported by Visual J#) but 
uses .NET Framework inter-op attributes and .NET Framework data types to call into unmanaged APIs, instead of the @dll() 
directives and Java-language types used by J/Direct. 


This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 


te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 





Building and Running the Sample 
To open the sample file in Solution Explorer 


1. Click Download Sample. 
The File Download message box appears. 

2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 

3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 

4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build this sample 


e@ On the Build menu, click Build Solution, or press CTRL+SHIFT+B. 
-Or- 


From the command line, type BUILD.bat. 





Note 





For more information, see Building from the Command Line (Visual J#). 











To run this sample: 


e From the development environment, press F5 to build and run the sample. 
-Or- 


From the command line, type PInvokeSample.exe. 


Command-Line Requirements 


For the Visual J# samples to function properly when building and running from the command line, you need to run vsvars.bat 
(located in the <%Program Files%>\Microsoft Visual Studio 8\Common7\Tools directory). Alternatively, you can also use the 
Visual Studio command prompt (click Start, then Programs, then Microsoft Visual Studio, and then Visual Studio Tools). 


See Also 
Other Resources 


Visual J# Technology Samples 


Visual J# Samples 


RemotingSample Sample (Build a Remoting Service) 


Download sample 


This sample shows how to use Visual J# to build a remoting service. This simple service manipulates a string passed to it as a 
parameter and returns the result back to the caller. It is important to note that the service must be hosted before a client can 
call it, which can be achieved by compiling the service as a DLL and registering the service in IIS. 


This sample contains the following directory structure: 
\bin 


Contains the HelloService.dll required when the remoting service is accessed using IIS. The service should be registered with 
IIS before calling this service from the clients in the Clients\ConsoleClient and Clients\WebClient directories. 


\Service 


The source code for the HelloService.dll and associated build.bat are stored here. Build.bat creates HelloService.dll and copies 
the file to the bin directory. 


\Client\ConsoleClient 


Contains the client and associated build.bat. HelloService.dll is copied from the bin directory because the compiler needs to 
reference the metadata of the service when compiling the client. The service should be registered with IIS before running this 
client. 


\Client\WebClient 


Contains the .config and the .aspx files required to access the service from a Web browser. 





aSecurity Note 





This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 
te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 











Building and Running the Sample 
To open the sample file in Solution Explorer 


1. Click Download Sample. 
The File Download message box appears. 

2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 

3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 

4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build this sample 
e@ On the Build menu, click Build Solution, or press CTRL+SHIFT+B. 
-Or- 


From the command line, type BUILD.bat. 





For more information, see Building from the Command Line (Visual J#). 











To register the service in IIS 


1. 


Compile the service to a DLL and copy this DLL to the bin directory from which the service will be loaded. For this 
sample, create the bin subdirectory under the sample directory and copy HelloService.dll there. Building the sample by 
running build.bat will accomplish this. 


. Start Internet Services Manager (accessible from the Start menu under Administrative Tools) and select the default 


Web site under the server node. 


. From the Action menu, choose New and then Virtual Directory. 
. Click Next to continue. 
. Enter HelloService as the alias and click Next. 


. Enter the directory where the service is located. Enter the full path up to but excluding the bin directory where the DLL in 


step 1 was copied, for example, C\Samples\RemotingService. 


. Click Next. Accept the defaults presented and click Next again. Click Finish. 


The remoting service has now been registered and will appear under the list of Default Web Sites in the Internet Services 
Manager window. 


. Verify that there is a web.config file in the directory where the service was registered. This file describes the service and 


will automatically be loaded when a client attempts to access the service with a browser or client using the HTTP channel 
on port 80. 


To run this sample 


1. 


Verify that the HelloService is registered with IIS and run the executable in the Clients\ConsoleClient directory. 


2. Verify that the HelloService is registered with IIS and run the sample from a browser by connecting to 


http://localhost/HelloService/Clients/WebClient. 


You may be required to reboot the machine after installing Visual J# for this sample to work correctly. 


See Also 
Other Resources 


Visual J# Technology Samples 


Visual J# Samples 


Scoping Sample (Using /securescoping) 


Download sample 


This sample demonstrates the two scoping options (using /securescoping) available in vjc.exe and the semantic differences 
between two applications compiled and run on Visual J# that have different scoping semantics for package and protected 
scoped members. These differences affect packages compiled into two or more assemblies and, more significantly, 
components written in Visual J# that are exposed to other languages on .NET. The secure scoping option is discussed in detail 
in /securescoping. 


In the sample, a package scoped class in one assembly (an .EXE) tries to access another package scoped class of the same 
package but in a different assembly (a .DLL). When the DLL is compiled without the /securescoping option the class in the .EXE 
is able to access the package scoped class in the DLL. When compiled with the /securescoping option this causes a 
java.lang.lllegalAccessError. 





aSecurity Note 





This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 
te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 








Building and Running the Sample 
To open the sample file in Solution Explorer 


1. Click Download Sample. 
The File Download message box appears. 

2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 

3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 

4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build this sample 
e@ On the Build menu, click Build Solution, or press CTRL+SHIFT+B. 
-or- 
From the command line, type BUILD.bat. 


Note 


For more information, see Building from the Command Line (Visual J#). 





To run this sample 


e From the development environment, press F5. 
-Or- 


Type PublicClass.exe from the command line. 


Command-Line Requirements 


For the Visual J# samples to function properly when building and running from the command line, you need to run vsvars.bat 
(located in the <%Program Files%>\Microsoft Visual Studio 8\Common7\Tools directory). Alternatively, you can also use the 
Visual Studio command prompt (click Start, then Programs, then Microsoft Visual Studio, and then Visual Studio Tools). 


See Also 
Other Resources 


Visual J# Technology Samples 


Visual J# Samples 


SecurityProviders Sample (Specify Third Party Security 
Providers) 


Download sample 


This sample demonstrates how the vjsharp.config file can be used to specify the third party security providers that must be 
used to perform cryptographic operations like generating keys and signatures. The vjsharp.config file is not installed by default. 
To use third party security providers for cryptographic operations rather than the default security provider that ships with the 
Visual J# class libraries, the user has to create this file and copy it to the 

<%windir%> \Microsoft.NET\Framework\v<%version%> directory. See Loading Third-Party Security Providers for information 
on the format of this file and how security providers are loaded using this file. 


This sample creates a dummy security provider that provides a message digest implementation using a Sample algorithm. The 
vjsharp.config file is then created to specify that this provider should be considered while searching for message digest classes 
implemented using the Sample algorithm. An application then tries to load a class from the dummy security provider using the 
getinstance API in the java.security.MessageDigest class. 


This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustra 


te the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code 
be used for purposes other than as intended. 





Building and Running the Sample 
To open the sample file in Solution Explorer 


1. Click Download Sample. 
The File Download message box appears. 

2. Click Open, and on the left column of the zip folder window, click Extract all files. 
The Extraction Wizard opens. 

3. Click Next. You can change the directory that the files will be extracted to, and then click Next again. 
Make sure that the Show extracted files check box is selected, and click Finish. 

4. Double-click the sample's .sIn file. 


The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location 
is not trusted. Click OK to continue. 


To build this sample 
e On the Build menu, click Build Solution, or press CTRL+SHIFT+B. 
-or- 
From the command line, type BUILD.bat. 


4Note 





For more information, see Building from the Command Line (Visual J#). 











To run this sample 


e Type SecurityProvider.exe from the command line. 








Note 











Before running the sample, update the associated vjsharp.config file with the correct assembly version and public key token 


of vjslib.dll that the sample is being run on. 





See Also 
Other Resources 
Visual J# Technology Samples 


